1
0
mirror of https://gitlab.com/kelteseth/ScreenPlay.git synced 2024-11-05 18:42:29 +01:00
ScreenPlay/Docs/DeveloperSetup.md
Elias Steurer 72a5485e7f Move vcpkg out of ScreenPlay source tree
This has some advatages. For one QtCreator starts way faster because
it queries _ALL_ files in the source dir. This can take to minute long
startup when using many packages. This makes some check python
scripts easier to write.
2020-10-29 18:52:37 +01:00

3.5 KiB

Developer Setup

  1. Install latest git + git-lfs
  2. Clone ScreenPlay
git clone --recursive https://gitlab.com/kelteseth/ScreenPlay.git ScreenPlay
  1. Download the latest Qt 5.15. Earlier versions are not supported!
  2. Start install-dependencies.bat to download dependencies. ATTENTION: This will create a ScreenPlay-vcpkg folder in the same directory as your ScreenPlay source folder.
//Windows
.\Tools\install-dependencies.bat

//Linux
sudo apt install git gcc cmake build-essential libgl1-mesa-dev
chmod +x install-dependencies.sh
.\Tools\install-dependencies.sh
  • This will install these dependencies via vcpkg
    • openSSL 1.1.1d
    • sentry-native
  • Download these dependencies via git submodules
    • qt-google-analytics
  • Download ffmpeg binaries
  1. Follow the steps below for your OS.

  2. Open the CMakeLists.txt via QtCreator. This can take some time until QtCreator parses all files!

  3. Add CMake variables

    • Add CMAKE_TOOLCHAIN_FILE and VCPKG_TARGET_TRIPLET
      • Extras -> Tools -> Kits -> -> CMake Configuration -> Append this:
      • CMAKE_TOOLCHAIN_FILE:STRING=%{CurrentProject:Path}/../ScreenPlay-vcpkg/vcpkg/scripts/buildsystems/vcpkg.cmake
      • VCPKG_TARGET_TRIPLET:STRING=x64-windows
      • or Linux: x64-linux MacOSX: x64-osx
  1. Check if Ninja is selected
    • Extras -> Tools -> Kits -> -> CMakeGenerator -> Change to:
      • Generator: Ninja
      • Extra Generator: CodeBlocks
  2. Save and close the settings.
  3. Press build (the big green play button). This will compile the project and copy all necessary files into your Qt installation.

Windows

  1. Download and install the most recent MSVC 2019 Community
    • Select "Desktop development with C++"
  2. Download and install Qt 5 binary installer from qt.io
    • Install the Maintaince tool
    • Select the following features to install:
      • Qt 5.15.1
        • MSVC 2019 64-bit
        • Qt WebEngine
      • Developer and Designer Tools
        • Cmake
        • Ninja

Linux

  1. Install dependencies for your distro:
# Debian/Ubuntu
sudo apt install build-essential libgl1-mesa-dev lld ninja-build cmake

# Fedora/RHEL/CentOS (yum)
sudo yum groupinstall "C Development Tools and Libraries"
sudo yum install mesa-libGL-devel

# openSUSE (zypper)
sudo zypper install -t pattern devel_basis
  1. Download and install Qt 5 binary installer from qt.io
    • Install the Maintaince tool
    • Select the following features to install:
      • Qt 5.15.1
        • GCC
        • Qt WebEngine

OSX

  1. Download and install Qt 5 binary installer from qt.io
    • Install the Maintaince tool
    • Select the following features to install:
      • Qt 5.15.1
        • Qt WebEngine
      • Developer and Designer Tools
        • OpenSSL 1.1.1.c Toolkit
          • OpenSSL 64-bit binaries
        • Cmake
        • Ninja
  2. Install homebrew
    • Open a terminal and install clang -> brew install llvm cmake ninja
  3. Change your default kit: QtCreator -> Options -> Kits -> Select your default kit (Desktop Qt 5.13.0) -> Change c and c++ Compiler to Apple Clang (x86_64)