mirror of
https://gitlab.com/kelteseth/ScreenPlay.git
synced 2024-09-03 00:59:47 +02:00
5.4 KiB
5.4 KiB
Developer Setup
- Install latest git + git-lfs
- Install python 3
- Clone ScreenPlay
git clone --recursive https://gitlab.com/kelteseth/ScreenPlay.git ScreenPlay
- Download the latest Qt 6.3.x for you platform. Earlier versions are not supported!
- Start the following script to download all needed dependencies automatically. This will create a ScreenPlay-vcpkg folder in the same directory as your ScreenPlay source folder.
cd Tools
py setup.py
- This will install these dependencies via vcpkg
- openSSL
- sentry-native
- doctest
- infoware
- Open QtCreator and open the settings
Tools -> Options
- Clone an existing kit like
Qt 6.3.1 MSVC2019 64bit
and addScreenPlay
to the new kit name - Edit CMake variables amd add CMAKE_TOOLCHAIN_FILE and VCPKG_TARGET_TRIPLET
Kits -> <Your_Kit> -> CMake Configuration
Append this:
-DCMAKE_TOOLCHAIN_FILE:STRING=%{CurrentProject:Path}/../ScreenPlay-vcpkg/scripts/buildsystems/vcpkg.cmake
# Only _one_ of these lines that match your OS:
-DVCPKG_TARGET_TRIPLET:STRING=x64-windows
-DVCPKG_TARGET_TRIPLET:STRING=x64-linux
-DVCPKG_TARGET_TRIPLET:STRING=x64-osx
-DVCPKG_TARGET_TRIPLET:STRING=arm64-osx
- Save and close the settings.
- Open Project via
File -> Open File or Project
and select yourCMakeLists.txt
. Then select our created kit, pressConfigure Project
Windows
- It is recommended (but not necessary) to use an easy git UI like gitextensions.
- Download and install the most recent MSVC 2019 Community
- Select "Desktop development with C++"
- Download and install Qt binary installer from qt.io
- Install the Maintaince tool
- Select the following features to install:
- Qt 6.3.1
- MSVC 2019 64-bit
- ALL Additional Libraries
- Qt Quick 3d
- Qt 5 Compatibility Module
- Qt Shader Tools
- Developer and Designer Tools
- Cmake
- Ninja
- Qt 6.3.1
Linux via qt.io account
- Install dependencies for your distro:
# Debian/Ubuntu
sudo apt install build-essential git gpg ffmpeg mesa-common-dev libxkbcommon-* libfontconfig curl zip unzip tar git pkg-config apt-transport-https ca-certificates gnupg software-properties-common wget software-properties-common python3-pip libgl1-mesa-dev lld ninja-build cmake qml-module-qt-websockets qtwebengine5-* -y
- Download and install Qt binary installer from qt.io
- Install the Maintaince tool
- Select the following features to install:
- Qt 6.3.1
- GCC
- ALL Additional Libraries
- Qt Quick 3d
- Qt 5 Compatibility Module
- Qt Shader Tools
- Developer and Designer Tools
- OpenSSL 1.1.1.c Toolkit
- OpenSSL 64-bit binaries
- Cmake
- Ninja
- OpenSSL 1.1.1.c Toolkit
- Qt 6.3.1
Linux via aqt command line & VSCode
- Alternativly download via aqt
pip3 install -U pip
pip3 install aqtinstall
aqt install-qt -O ~/aqt linux desktop 6.3.1 gcc_64 -m all
- Open VSCode and install the
CMake Tools
- ctrl + p:
CMake: Select Configure Preset
- Select
ScreenPlay 64bit Debug Linux
- ctrl + p:
CMake: Configure
- ctrl + p:
CMake: Build
- ctrl + p:
Fix python scripts not in path:
vim ~/.bashrc
Add at the end of the file and restart the console/terminal:
export PATH="~/.local/bin:$PATH"
MacOSX
- Install XCode 13+ , open and restart your device.
- Install brew that is needed by some third party vcpkg packages. Do not forget to add brew to your path as outlined at the on of the installation!
brew install pkg-config git llvm cmake ninja
- Download and install Qt binary installer from qt.io
- Install the Maintaince tool
- Select the following features to install:
- Qt 6.3.1
- Qt WebEngine
- ALL Additional Libraries
- Qt Quick 3d
- Qt 5 Compatibility Module
- Qt Shader Tools
- Developer and Designer Tools
- OpenSSL 1.1.1.c Toolkit
- OpenSSL 64-bit binaries
- Cmake
- Ninja
- OpenSSL 1.1.1.c Toolkit
- Qt 6.3.1
- Change your default kit:
QtCreator -> Options -> Kits -> Select your default kit (Desktop Qt 6.3.1) -> Change c and c++ Compiler to Apple Clang (x86_64)
Developer docs
We use qdoc to generate documentation. Qt6 is the minimum version qdoc, because of vastly improved c++ parsing support.
- qdoc.exe configWindows.qdocconf If you have installed Qt in a different directory, change the path to your Qt location.
Some useful links: