Initial installation of J901
For any linux distribution, the starting point is to install J901 in your home folder. To install J901 with the qtide, download the linux zip from the jsofware website and extract it to your home folder.
For the full version, start jconsole and run the following:
For the slim version, start jconsole and run
load'pacman' je_update_jpacman_'' install'slim'
Before running jqt, you will need to make sure that the necessary Qt libraries are installed on your system. The required libraries are listed below for various linux distributions. Note that the instructions below specify installing the development libraries, which include the necessary runtime libraries. If you never plan to build jqt, you could just install the equivalent runtime libraries, but you won't really be saving much disk space.
The jqt binaries installed using the above commands were built on Debian 9. They will work on many but not all linux distributions and you may need to build new binaries as described below. When all of the necessary libraries (and the correct jqt binaries) are installed, you can run jqt.sh from the J901 installation folder.
The 'install' jpkg '*' command will also place shortcuts to jqt, jconsole, and jhs on your desktop. These shortcut files may be found in the Desktop folder in your home directory. Whether they appear on your desktop depends on your system settings. You may need to enable that feature using the gnome tweak tool or other methods, enable the launcher by right clicking the desktop shortcut, or edit the content of the .desktop file. Google "desktop shortcuts" for your distribution. If you installed the slim version as above, you can generate the shortcuts by loading pacman and executing shortcut_jpacman_.
In order to build jqt from source, you will need to ensure that the necessary development tools (g++, make, etc.) as well as the development versions of the Qt libraries are installed.
Use git to clone the qtide source.
git clone https://github.com/jsoftware/qtide.git
Running makeall.sh in the source directory will build the full jqt binaries. To build the slim version,
prior to running makeall.sh.
Copy the files in bin/linux-x86_64/release to the bin directory of your j901 folder, replacing the files that are there. Running jqt.sh from the j901 folder should now start the ide.
A more detailed discussion of building jqt on Linux is available at Guides/Compiling Jqt/Linux.
Distribution specific information
For all the distributions below, the most recent (LTS if available) release was installed as a development workstation in a VMware VM. In general, development packages for the Qt libraries are installed to facilitate building jqt, if desired. Note that you could also download the latest Qt sdk for linux and build the jqt binaries using those libraries. The current jqt code works fine when compiled with the Qt 5.14.1 sdk.
Debian 10/Ubuntu 18.04/Linux Mint 19.3/MX 19.1
The instructions below should apply to the many Ubuntu-based distributions. For these distros, the jqt binaries (built on Debian 9) available on the jsoftware website will work well.
The following Qt packages need to be installed for the full version of jqt. Only the first line is required to run the slim version; both lines are required for the full version of jqt.
sudo apt install qt5-default libqt5websockets5-dev libqt5svg5-dev sudo apt install qtwebengine5-dev qtmultimedia5-dev libqt5multimedia5-plugins
In either case, you should now have a working version of j901/qtide. Start jqt by running jqt.sh in the j901 directory.
The slim jqt binaries from the jsoftware website will work on Ubuntu 20.04. However, building the jqt binaries is advised for the slim version and required for the full version. Install the Qt libraries as described above for Ubuntu 18.04, then build the required jqt binaries.
CentOS 8.1/RHEL 8.1
Workstation and development packages are installed. Both the PowerTools and EPEL repos need to be available.
sudo yum config-manager --set-enabled PowerTools sudo dnf install epel-release
The slim jqt binaries from the jsoftware website will work on CentOS/RHEL 8.1. However, building the jqt binaries is advised for the slim version and required for the full version. To install the Qt development libraries,
sudo dnf install qt5-devel.noarch sudo dnf install qt5-qtwebengine-devel
The second package is not needed for the slim version of jqt.
CentOS 7.7/RHEL 7.7
The EPEL repo needs to be available.
sudo yum install epel-release
Next make sure that the necessary Qt libraries are installed (only the first line is required for slim jqt, both required for the full jqt version):
sudo yum install qt5-qtbase-devel qt5-qtsvg-devel qt5-qtwebsockets-devel sudo yum install qt5-qtwebkit-devel qt5-qtmultimedia-devel
CentOS 7.7 does not support webengine. You need to export JQTWEBKIT=JQTWEBKIT in order to use webkit rather than webengine. Then running the makeall.sh script will build the full jqt binaries.
Install the required Qt libraries (only the first line is required for slim jqt, both for full jqt):
sudo dnf install qt5-devel sudo dnf install qt5-qtwebengine-devel
The slim jqt binaries from the jsoftware website will work on Fedora. However, building the jqt binaries is advised for the slim version and required for the full version.
Recent Fedora distributions use Wayland by default for displaying Qt applications. This display leads to artifacts for some of the web related demos (webd3, webgl, webview). To use the X11 platform instead, export QT_QPA_PLATFORM=xcb. You could add that command to jqt.sh. With this setting, the demos appear as intended.
Install Qt libraries using
sudo pacman -S qt5 sudo pacman -S extra/qt5-webkit
The slim jqt binaries from the jsoftware website will work on Manjaro. However, building the jqt binaries is advised for the slim version and required for the full version.
For the Pinebook Pro edition of Manjaro, the 64-bit RaspberryPI build of J will work well. The first command above will prompt you to "remove qt5-base"; what it means is that it'll exclude this package from the list of installed packages, which is what you want as qt5-es-base (a variant of qt5-base with OpenGL ES 2.0 support) is already installed.
Install Qt libraries using
zypper install -t pattern devel_qt5
Both the slim and full jqt binaries from the jsoftware website will work on openSUSE. You may wish to build qtide using the newer Qt libraries in openSUSE 15.1.
Install Qt libraries (only the first line is required for slim jqt, both for full jqt):
sudo eopkg install qt5-base-devel qt5-websockets-devel qt5-svg-devel sudo eopkg install qt5-webengine-devel qt5-multimedia-devel
The slim jqt binaries from the jsoftware website will work on Solus. However, building the jqt binaries is advised for the slim version and required for the full version.
Make sure that the development tools are installed:
sudo eopkg install -c system.devel sudo eopkg install git