Files
sethLabels/docs/BUILD-INSTRUCTIONS-WINDOWS.md
Jaye Evins f15c21a01d Update to Qt6
- New baseline minimum platform is Ubuntu 22.04
    - Qt6 requires at least 6.2
        - some deprecations may be flagged on later versions (e.g. 6.8)
    - CMake requires at least 3.22
- Include build-tests.yml github action to validate builds on mulitple platforms
- QtTest is no longer optional since it easily comes along for the ride with Qt
- Replaced QStringRef in model::SubstitutionField with simple ParserState class
- Removed deprecations up to Qt 6.2
2025-05-06 18:26:53 -04:00

102 lines
2.2 KiB
Markdown

gLabels Windows Build Instructions
==================================
gLabels for Windows can be built using one of the following toolchains:
- [Visual Studio](#visual-studio)
- [MSYS/MINGW](#msysmingw)
Visual Studio
-------------
### Prerequisites
- Visual Studio (these instructions are for _Visual Studio 15 2017 Win64_)
- CMake 3.22+
- Qt6 6.2+ for your version of Visual Studio
- NSIS 3.03+ (optional -- for creating an installer)
Make sure that CMake and the Qt tools are in your executable search path. For example, you may need to add something like the following to your PATH environment variable:
```
c:\Program Files\CMake\bin
c:\Qt\5.9.3\msvc2017_64\bin
```
The exact paths will depend on the version of Qt and CMake you have installed.
### Compile
From a Windows Power Shell, use CMake to create and build a Visual Studio Solution:
<pre>
&gt; cd <i>glabels_source_directory</i>
&gt; mkdir build
&gt; cd build
&gt; cmake -G "Visual Studio 15 2017 Win64" -DCMAKE_PREFIX_PATH="c:\qt\5.9.3\msvc2017_64" ..
&gt; cmake --build . --config Release
</pre>
### Install
To install, run a Windows Power Shell `as administrator`, and type the following commands:
<pre>
&gt; cd <i>glabels_source_directory</i>/build
&gt; cmake --build . --config Release --target INSTALL
</pre>
### Create installer
To create a Windows installer, run the following commands:
<pre>
&gt; cd <i>glabels_source_directory</i>/build
&gt; cpack -C Release -G NSIS
</pre>
MSYS/MINGW
----------
### Prerequisites
- MSYS/MINGW, including the following packages
+ mingw32-gcc-g++
+ mingw32-libz
- CMake 3.22+
- Qt6 6.2+ for MINGW
Make sure that Qt tools and CMake are in your executable search path. For example, add something like this to your .profile file:
```
export PATH=/c/Qt/5.9.3/mingw53_32/bin:${PATH}
export PATH="/c/Program Files/CMake/bin":${PATH}
```
The exact paths will depend on the version of Qt and CMake you have installed.
### Compile and Install
From an MSYS shell, type the following commands:
<pre>
$ cd <i>glabels_source_directory</i>
$ mkdir build
$ cd build
$ cmake -G "MSYS Makefiles" ..
$ make
</pre>
To install glabels, run an MSYS shell `as administrator`, and type the following commands:
<pre>
$ cd <i>glabels_source_directory</i>/build
$ make install
</pre>