mirror of
https://github.com/ZoiteChat/zoitechat.git
synced 2026-09-01 12:49:24 +00:00
111 lines
3.7 KiB
ReStructuredText
111 lines
3.7 KiB
ReStructuredText
Building
|
||
========
|
||
|
||
Windows
|
||
-------
|
||
|
||
The Windows build is currently x64-only and follows the same shape as
|
||
ZoiteChat's Windows GitHub Actions workflow: prepare ``C:\gtk-build``, put
|
||
the dependency bundles where ``win32\zoitechat.props`` expects them, then build
|
||
``win32\zoitechat.sln`` with MSBuild.
|
||
|
||
Software
|
||
~~~~~~~~
|
||
|
||
Install:
|
||
|
||
- `Visual Studio 2022 Community <https://visualstudio.microsoft.com/vs/community/>`_ or `Visual Studio 2022 Build Tools <https://visualstudio.microsoft.com/downloads/>`_ with the **Desktop development with C++** workload
|
||
- `Git for Windows <https://git-scm.com/download/win>`_
|
||
- `7-Zip <https://7-zip.org/>`_
|
||
- `Python 3.14 x64 <https://www.python.org/downloads/windows/>`_
|
||
- `Inno Setup 6 <https://jrsoftware.org/isdl.php>`_ if you want to build the installer
|
||
|
||
Source code
|
||
~~~~~~~~~~~
|
||
|
||
Clone the source and enter the checkout::
|
||
|
||
git clone https://github.com/zoitechat/zoitechat.git
|
||
cd zoitechat
|
||
|
||
Dependencies
|
||
~~~~~~~~~~~~
|
||
|
||
Create the dependency root::
|
||
|
||
mkdir C:\gtk-build
|
||
|
||
Download the `GTK3 x64 bundle <https://github.com/ZoiteChat/gvsbuild/releases/download/zoitechat-2.18.1/GTK3_Gvsbuild_zoitechat-2.18.1_x64.zip>`_
|
||
and extract it to ``C:\gtk-build\gtk\x64\release``.
|
||
|
||
Download the remaining Windows dependency artifacts from the
|
||
`ZoiteChat gvsbuild releases <https://github.com/zoitechat/gvsbuild/releases>`_
|
||
and extract them to these paths:
|
||
|
||
- gendef: ``C:\gtk-build\gendef``
|
||
- WinSparkle x64 bundle: ``C:\gtk-build\WinSparkle\x64``
|
||
- Perl 5.42 x64 bundle: ``C:\gtk-build\perl-5.42.0.1\x64``
|
||
|
||
Set up Python where the project file expects it. From PowerShell, adjust the
|
||
Python path if your install is elsewhere::
|
||
|
||
mkdir C:\gtk-build\python-3.14
|
||
cmd /c mklink /J C:\gtk-build\python-3.14\x64 C:\Python314
|
||
C:\gtk-build\python-3.14\x64\python.exe -m pip install --upgrade pip cffi
|
||
|
||
If you use different locations, set these environment variables before building
|
||
instead of editing ``win32\zoitechat.props``:
|
||
|
||
- ``ZOITECHAT_DEPS_PATH``
|
||
- ``ZOITECHAT_GENDEF_PATH``
|
||
- ``ZOITECHAT_PERL_PATH``
|
||
- ``ZOITECHAT_PYTHON3_PATH``
|
||
- ``ZOITECHAT_WINSPARKLE_PATH``
|
||
- ``ZOITECHAT_ISCC_PATH``
|
||
|
||
Building
|
||
~~~~~~~~
|
||
|
||
Open **Developer Command Prompt for VS 2022** in the source checkout and run::
|
||
|
||
msbuild win32\zoitechat.sln /m /verbosity:minimal /p:Configuration=Release /p:Platform=x64
|
||
|
||
To build the installer, open ``win32\zoitechat.sln`` in Visual Studio,
|
||
set ``release/installer`` as the startup project, then run **Build**.
|
||
|
||
The build output is written to ``..\zoitechat-build\x64``. The installer
|
||
build writes a ``ZoiteChat*.exe`` installer in that output tree.
|
||
|
||
Unix
|
||
----
|
||
|
||
First of all, you have to install the build dependencies. Package names
|
||
differ across distros, so be creative and check meson's output
|
||
if you get an error.
|
||
|
||
Most package-managers can get the dependencies for you:
|
||
|
||
- dnf::
|
||
|
||
dnf install -y meson gettext-devel gtk3-devel iso-codes-devel libarchive-devel libayatana-appindicator-gtk3-devel libcanberra-devel lua-devel openssl-devel perl-devel perl-ExtUtils-Embed python3-cffi python3-devel
|
||
|
||
- apt::
|
||
|
||
apt-get install -y meson gettext iso-codes libarchive-dev libayatana-appindicator3-dev libcanberra-dev libglib2.0-dev libgtk-3-dev liblua5.4-dev libpci-dev libperl-dev libssl-dev python3-dev python3-cffi desktop-file-utils
|
||
|
||
ZoiteChat has its source code hosted using `Git <http://git-scm.com/>`_, so you have to install Git as
|
||
well. When it's ready, you can start the actual compilation, which is
|
||
basically:
|
||
|
||
.. code-block:: bash
|
||
|
||
git clone https://github.com/zoitechat/zoitechat.git
|
||
cd zoitechat
|
||
meson setup build
|
||
ninja -C build
|
||
sudo ninja -C build install
|
||
|
||
This will compile with defaults. See ``meson configure build`` for more info
|
||
about flags.
|
||
|