mirror of
https://gitlab.com/kelteseth/ScreenPlay.git
synced 2024-09-03 09:09:48 +02:00
Update Docs/DeveloperSetup.md
This commit is contained in:
parent
e2beadb671
commit
f299d8cefd
@ -1,31 +1,29 @@
|
||||
# Developer Setup
|
||||
1. Install latest [git + git-lfs](https://git-scm.com/)
|
||||
2. Install [python 3](https://www.python.org/)
|
||||
2. Install latest [python 3](https://www.python.org/)
|
||||
3. Clone ScreenPlay
|
||||
``` bash
|
||||
git clone --recursive https://gitlab.com/kelteseth/ScreenPlay.git ScreenPlay
|
||||
git clone --recursive https://gitlab.com/kelteseth/ScreenPlay.git ScreenPlay/ScreenPlay
|
||||
```
|
||||
4. Download the latest __Qt 6.3.x__ for you platform. Earlier versions are not supported!
|
||||
4. Download the latest __Qt 6.4.x__ for you platform. Earlier versions are not supported!
|
||||
1. [Install instructions Windows](#windows)
|
||||
1. [Install instructions Linux](#linux)
|
||||
1. [Install instructions MacOSX](#macosx)
|
||||
5. 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.
|
||||
``` bash
|
||||
cd Tools
|
||||
py setup.py
|
||||
# Windows defaults to python
|
||||
python setup.py
|
||||
# Linux and macOS uses python3
|
||||
python3 setup.py
|
||||
```
|
||||
* This will install these dependencies via __vcpkg__
|
||||
* openSSL
|
||||
* sentry-native
|
||||
* doctest
|
||||
* infoware
|
||||
|
||||
<div>
|
||||
<img width="100%" height="auto" src="../.gitlab/media/QtCreator_kit.png">
|
||||
</div>
|
||||
|
||||
5. Open __QtCreator__ and open the settings `Tools -> Options`
|
||||
6. Clone an existing kit like `Qt 6.3.1 MSVC2019 64bit` and add `ScreenPlay` to the new kit name
|
||||
6. Clone an existing kit like `Qt 6.4.1 MSVC2019 64bit` and add `ScreenPlay` to the new kit name
|
||||
5. Edit CMake variables amd add CMAKE_TOOLCHAIN_FILE and VCPKG_TARGET_TRIPLET
|
||||
* `Kits -> <Your_Kit> -> CMake Configuration`
|
||||
|
||||
@ -39,7 +37,6 @@ Append this:
|
||||
-DVCPKG_TARGET_TRIPLET:STRING=arm64-osx
|
||||
```
|
||||
|
||||
|
||||
6. Save and close the settings.
|
||||
7. Open Project via `File -> Open File or Project` and select your `CMakeLists.txt`. Then select __our created kit__, press `Configure Project`
|
||||
<div>
|
||||
@ -54,7 +51,7 @@ Append this:
|
||||
1. [Download and install Qt binary installer from qt.io](https://www.qt.io/download-qt-installer)
|
||||
- Install the Maintaince tool
|
||||
- Select the following features to install:
|
||||
- Qt 6.3.1
|
||||
- Qt 6.4.1
|
||||
- MSVC 2019 64-bit
|
||||
- **ALL Additional Libraries**
|
||||
- Qt Quick 3d
|
||||
@ -63,16 +60,17 @@ Append this:
|
||||
- Developer and Designer Tools
|
||||
- Cmake
|
||||
- Ninja
|
||||
## Linux via qt.io account
|
||||
1. Install dependencies for your distro:
|
||||
## Linux dependencies
|
||||
1. Install dependencies for Debian/Ubuntu:
|
||||
``` bash
|
||||
# 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
|
||||
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 python3-pip libgl1-mesa-dev lld ninja-build cmake qml-module-qt-websockets qtwebengine5-* -y
|
||||
```
|
||||
|
||||
## Linux via qt.io account
|
||||
1. [Download and install Qt binary installer from qt.io](https://www.qt.io/download-qt-installer)
|
||||
- Install the Maintaince tool
|
||||
- Select the following features to install:
|
||||
- Qt 6.3.1
|
||||
- Qt 6.4.1
|
||||
- GCC
|
||||
- **ALL Additional Libraries**
|
||||
- Qt Quick 3d
|
||||
@ -83,26 +81,19 @@ sudo apt install build-essential git gpg ffmpeg mesa-common-dev libxkbcommon-
|
||||
- OpenSSL 64-bit binaries
|
||||
- Cmake
|
||||
- Ninja
|
||||
## Linux via aqt command line & VSCode
|
||||
|
||||
## Linux via aqt
|
||||
1. 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
|
||||
python3 -m pip install aqtinstall
|
||||
python3 -m aqt install-qt -O ~/aqt linux desktop 6.4.1 gcc_64 -m all
|
||||
```
|
||||
1. Open VSCode and install the `CMake Tools`
|
||||
1. ctrl + p: `CMake: Select Configure Preset`
|
||||
2. Select `ScreenPlay 64bit Debug Linux`
|
||||
3. ctrl + p: `CMake: Configure`
|
||||
4. ctrl + p: `CMake: Build`
|
||||
### 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
|
||||
1. Install XCode 13+ , open and restart your device.
|
||||
@ -111,7 +102,7 @@ export PATH="~/.local/bin:$PATH"
|
||||
1. [Download and install Qt binary installer from qt.io](https://www.qt.io/download-qt-installer)
|
||||
- Install the Maintaince tool
|
||||
- Select the following features to install:
|
||||
- Qt 6.3.1
|
||||
- Qt 6.4.1
|
||||
- Qt WebEngine
|
||||
- **ALL Additional Libraries**
|
||||
- Qt Quick 3d
|
||||
@ -123,7 +114,7 @@ export PATH="~/.local/bin:$PATH"
|
||||
- Cmake
|
||||
- Ninja
|
||||
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)`
|
||||
- `QtCreator -> Options -> Kits -> Select your default kit (Desktop Qt 6.4.1) -> Change c and c++ Compiler to Apple Clang (x86_64)`
|
||||
|
||||
|
||||
# Developer docs
|
||||
|
Loading…
Reference in New Issue
Block a user