mirrors/qBittorrent
1
0
Fork 0
mirror of https://github.com/qbittorrent/qBittorrent.git synced 2024-10-22 02:36:15 +03:00
Code Issues Projects Releases Packages Wiki Activity

fixes

Francisco Pombal 2020-09-20 00:24:13 +01:00
parent e8688ec40b
commit 8b28a53e6a
1 changed files with 10 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
Compilation-with-CMake---basics.md → Compilation-with-CMake:-common-information.md

@ -1,14 +1,14 @@
## Introduction
As of revision `63ff5e348c248c31b801040de838898d9c3baba9` (this is after version 4.2.5), CMake should be considered the preferred way of building qBittorrent on all supported platforms.
As of revision `63ff5e3` (this is after version 4.2.5), CMake should be considered the preferred way of building qBittorrent on all supported platforms.
Currently, the CMake build scripts may not handle installation to system directories both correctly and in a fully automated fashion for all platforms (this is noted in each platform-specific guide where relevant). Additionally, currently they don't handle packaging at all. Patches are welcome to improve this!
Specific instructions for each platform are listed in the section below: [platform specific guides](#Platform-specific-instructions-and-guides).
Not that currently, the CMake build scripts may not handle installation to system directories both correctly and in a fully automated fashion for all platforms (this is noted in each platform-specific guide where relevant). Additionally, currently they don't handle packaging at all. Patches are welcome to improve this!
## Prerequisites
- The qBittorrent source code
In order to build qBittorrent with CMake, first check that you have the following:
- Basic understanding of how to use CMake. Refer to [CMake Basics](#CMake-Basics) below if needed.
- A C++ compiler and toolchain (e.g. `build-essential` package on Ubuntu, Visual Studio/MSVC toolchain on Windows, Xcode toolchain on macOS, ...)
- CMake >= 3.16. If your distribution does not include a recent enough version in their repositories, install it from the official website or the official PPA.
- The Ninja build tool (optional, but recommended).
@ -17,7 +17,7 @@ More information about what is needed specifically is detailed in the guides for
## qBittorrent build configuration options
You may use the following options to customize the build. Pass them in the **configure step** like so: `-D<option_name>=<value>`.
When following any of the [platform-specific guides](#Platform-specific-instructions-and-guides), you may use the following qBittorrent-specific options to customize the build. Pass them in the **configure step** like so: `-D<option_name>=<value>`.
| Option name | Type | Default value | Description | Conditions, if any |
|-|-|-|-|-|
@ -40,6 +40,8 @@ TODO
- Windows with MinGW 7.3.0 64-bit (dynamic linkage)
- macOS 10.15 with Xcode
---
---
---
## CMake Basics
@ -49,7 +51,7 @@ Building qBittorrent with CMake comes down to a 2-step process:
- the configuration and generation, also known as the **configure step/"configure-time"**, where
- and the build itself, also known as the **build step/"build-time"**.
In the **configure step** where it is possible to set some options to customize the qBittorrent build, CMake checks that all prerequistes and dependencies are in order and generates input files for some underlying buildsystem.
In the **configure step** where it is possible to set some options to customize the qBittorrent build, CMake checks that all prerequisites and dependencies are in order and generates input files for some underlying buildsystem.
These input files will be then used to actually build the project in the **build step** by the underlying buildsystem.
A typical CMake invocation looks like the following 2 commands: