The buttonless client for the Matrix chat protocol.
- an OS (Windows, Linux, macOS and others)
- a C++ toolchain that can deal with Qt (see a link for your platform at http://doc.qt.io/qt-5/gettingstarted.html#platform-requirements)
- Qt 5 (either Open Source or Commercial)
Just install things from "Pre-requisites" using your preferred package manager. If your Qt package base is fine-grained you might want to take a look at tensor.pro to figure out which specific libraries Tensor uses.
From the root directory of the project sources, first update submodules:
git submodule update --init # pull in qmatrixclient library
Then open the project in QtCreator and build.
From the root directory of the project sources:
cd build
sudo make install
Alternatively, Download Qt for Android, open tensor.pro in Qt Creator, and build for Android.
Here you have options.
Notes:
- This is quicker but takes a bit of your time to gather and install everything.
- Unless you already have Visual Studio installed, it's quicker and easier to rely on MinGW supplied by the Qt's online installer. It's only 32-bit yet, though.
- At the time of this writing (Feb '16), there're no official Qt packages for MinGW 64-bit; so if you want a 64-bit Tensor built by MinGW you have to pass on to the next section.
- You're not getting a "system" KCoreAddons this way - the in-tree version will be used instead to build Tensor. Actions: download and install things from "Pre-requisites" (except KCoreAddons) in no particular order.
Notes:
- This is slower and takes much more machine time (and, possibly, your own time if you're not friendly with command line and configuration files) but downloads and sets up all dependencies on your behalf (including the toolchain, unless you tell it to use Visual Studio).
- The process is based on this KDE TechBase article and it uses a Gentoo Linux portage system ported to Windows. Have the article handy when going through it.
- This option will download and build Qt (and KCoreAddons) from scratch so in theory you should be free to configure Qt in whatever way you want. This requires some knowledge of how the portage system works; it's definitely not for simple folks. Knowing Linux helps a lot.
- You should give it enough time and space to compile everything (it can easily be several hours on weaker hardware and consumes 10+ Gb).
- Tested with 64-bit MinGW. Visual Studio should work as well but noone tried it yet.
- TODO:
emerge qtbelow builds the default set of Qt components. By using a needed subset of Qt components instead of a qt metapackage, one can significantly reduce the build time. Actions:
- Check out and configure the emerge tool as described in the KDE TechBase article. Don't run emerge yet.
- If you don't have Windows SDK installed (it usually comes bundled with Visual Studio):
- Download and install Windows SDK: https://dev.windows.com/en-us/downloads/windows-10-sdk and set DXSDK_DIR environment variable to the root of the installation. This is needed for Qt to compile the DirectX-dependent parts.
- Alternatively (in theory, nobody tried it yet), you can setup/hack Qt portages so that Qt compilation doesn't rely on DirectX (see http://doc.qt.io/qt-5/windows-requirements.html#graphics-drivers for details about linking Qt to OpenGL).
- Enter
emerge qt qtquickcontrols kcoreaddonsinside the shell made by the kdeenv script (see the KDE TechBase article), double check that the checkout-configure-build-install process has started and leave it running. Leaving it for a night on even an older machine should suffice. - Once the build is over, make sure you have the toolchain reachable from the environment you're going to compile Tensor in. If you plan to use the just-compiled MinGW and CMake to compile Tensor you might want to add /dev-utils/bin and /mingw64/bin into your PATH for convenience. If you have other MinGW or CMake installations around you have to carefully select the order of PATH entries and bear in mind that emerge usually takes the latest versions by default (which are not necessarily the same that you installed).
- Alternatively: just build Tensor inside the same kdeenv wrapper shell (not tried but should work).
Build using QtCreator or try to use qmake.
There is no installer configuration for Windows as of yet. You might want to use the Windows Deployment Tool that comes with Qt to find all dependencies and put them into the build directory. Though it misses on a library or two it helps a lot. To double-check that you're good to go you can use the Dependencies Walker tool aka depends.exe - this is especially needed when you have a mixed 32/64-bit environment or have different versions of the same library scattered around.
Qt requires OpenSSL to make secure connections. The correct version for a given Qt version is given at https://wiki.qt.io/Qt_5.8_Tools_and_Versions, for Qt 5.8 it is openssl 1.0.2h The easiest way to install a binary version seems to be with conan package manager.