commit | e3417b8f37f41bbb262fa08e80bcd86caf87eb29 | [log] [tgz] |
---|---|---|
author | Sébastien Blin <sebastien.blin@savoirfairelinux.com> | Sat Oct 10 13:32:06 2020 -0400 |
committer | Sébastien Blin <sebastien.blin@savoirfairelinux.com> | Sat Oct 10 13:32:06 2020 -0400 |
tree | c59c862c1b401fa0e9e05d24cf24b86dada70415 | |
parent | cc3336277a3f9fe065ef93a4915b2adc0e987624 [diff] |
misc: improve README.md Change-Id: I7d042e726a5a9d335cb0f840b15c84bb2b9510be Gitlab: #29
Jami provides all its users a universal communication tool, autonomous, free, secure and built on a distributed architecture thus requiring no authority or central server to function.
jami-qt
is the cross platform client for Jami. For now, it's mainly used for the Windows platform and is not tested on other platforms.
For more information about the jami project, see the following:
./make-ring.py --init
Note: This project is quite new, and still need some work for the build integration.
This client is only the graphical part, you will need to also build the daemon and LRC (the library containing the logic for desktop clients). Because of this, the recommended way is to clone our meta-repository containing all submodules needed.
In order to use the QML Client it is necessary to install the Qt version 5.15 or higher. You can install it from sources or download the binary installer.
Finally, pandoc is needed to generate the changelog page.
git clone https://review.jami.net/ring-project
Jami installer uses python3. If it's not installed, please install it:
cd ring-project/ ./make-ring.py --init
Then you will need to install dependencies:
./make-ring.py --dependencies # needs sudo
Then, you can build daemon, lrc and client-qt with:
./make-ring.py --install --qt
And you will have the daemon in daemon/bin/dring
and the client in client-qt/build-local/jami-qt
. You also can run it with
./make-ring.py --run --qt
cd client-qt pandoc -f markdown -t html5 -o changelog.html changelog.md mkdir build cd build ${YOUR_QT5_gcc64_PATH}/bin/qmake /jami-qt.pro make -j9
If you want more details, or separately build other projects you can check this page.
Only 64-bit MSVC build can be compiled.
Note: command
./make-ring.py --init
is not required on the Windows build
Setup Before Building:
Download Qt (Open Source)
Prebuild | Module | |
---|---|---|
Components: | msvc2017_64 | Qt WebEngine |
Download Visual Studio (version >= 2015)
Install Qt Vs Tools under extensions, and configure msvc2017_64 path under Qt Options
Qt Version | SDK | Toolset | |
---|---|---|---|
Minimum requirement: | 5.9.4 | 10.0.16299.0 | V141 |
Install Python3 for Windows
Start Building
git clone https://review.jami.net/ring-project cd ring-project/ git submodule update --init daemon lrc client-windows git submodule update --recursive --remote daemon lrc client-windows
python make-ring.py --dependencies
Note:
- This command will install chocolatey which may require you to restart the Command Prompt to be able to use it.
- This command will install msys2 (64 bit) by using chocolatey command which may cause issues below:
a. Choco may require you to restart the Command Prompt after finishing installing msys2.
b. Only if you have already installed msys2 (64 bit) under the default installation folder, we will use the existing one.- This command will install strawberry perl by using chocolatey command which may fail if you have already installed it.
- This command will install cmake by using chocolatey command which will not add cmake into PATH (environment variable).
The issue 1, 2(a), 3 can be solved by restarting the Command Prompt under Administrator right and re-run the command.
The issue 3 can be solved by uninstalling your current strawberry perl and re-run the command.
The issue 4 can be solved by adding the location of the cmake.exe into PATH.
python make-ring.py --install
Note:
To control the toolset and the sdk version that are used by msbuild, you can use--toolset
and--sdk
options
To control which Qt version should be used (qmake, windeployqt), uou can use--qtver
option
By default:toolset=v141
,sdk=10.0.16299.0
,qtver=5.9.4
For example:
python make-ring.py --install --toolset v142 --sdk 10.0.18362.0 --qtver 5.12.0
Daemon
cmake -DCMAKE_CONFIGURATION_TYPES="ReleaseLib_win32" -DCMAKE_VS_PLATFORM_NAME="x64" -G "Visual Studio 16 2019" -A x64 -T '$(DefaultPlatformToolset)' .. python winmake.py -b daemon
.lib
file in the path of ring-project\daemon\MSVC\x64\ReleaseLib_win32\binNote: each dependencies contrib for daemon can also be updated individually
For example:
python winmake.py -b opendht
Lrc
cd lrc python make-lrc.py -gb
Jami-qt
cd client-windows pandoc -f markdown -t html5 -o changelog.html changelog.md python make-client.py -d python make-client.py -b powershell -ExecutionPolicy Unrestricted -File copy-runtime-files.ps1
Note
--toolset
and --sdk
options are available.-h
option.--qtver
option is available on make-lrc.py
and make-client.py
.Compile the client with BUILD=Debug
and compile LibRingClient with -DCMAKE_BUILD_TYPE=Debug
Copyright (C) 2020 Savoir-faire Linux Inc.
Jami is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
See COPYING or https://www.gnu.org/licenses/gpl-3.0.en.html for the full GPLv3 license.