mirror-chatterino2/BUILDING_ON_WINDOWS.md

2.9 KiB

Building on Windows (Recommended)

Using Qt Creator

Visual Studio 2017

  1. Install Visual Studio 2017 and select "Desktop development with C++" and "Universal Windows Platform development.

Boost

  1. Visual Studio 2017 64-bit: https://dl.bintray.com/boostorg/release/1.66.0/binaries/boost_1_66_0-msvc-14.1-64.exe
  2. When prompted, install boost to C:\local\boost
  3. When the installation is finished, go to C:\local\boost and rename the "lib64-msvc-14.1" folder to "lib"

OpenSSL

For our websocket library, we need OpenSSL 1.1

  1. Download OpenSSL development library: https://slproweb.com/download/Win64OpenSSL-1_1_0i.exe
  2. When prompted, install openssl to C:\local\openssl
  3. When prompted, copy the OpenSSL DLLs to "The OpenSSL binaries (/bin) directory"

For Qt SSL, we need OpenSSL 1.0

  1. Download OpenSSL light: https://slproweb.com/download/Win64OpenSSL_Light-1_0_2p.exe
  2. When prompted, install it anywhere
  3. When prompted, copy the OpenSSL DLLS to "The OpenSSL binaries (/bin) directory"
  4. Copy the OpenSSL 1.0 files from its /bin folder to C:/local/bin (You will need to create the folder)
  5. Then copy the OpenSSL 1.1 files from its /bin folder to C:/local/bin (Overwrite any duplicate files)
  6. Add C:/local/bin to your path folder (Follow guide here, if you don't know how to do it: https://www.computerhope.com/issues/ch000549.htm#windows8 )

Qt

  1. Download Qt: https://www.qt.io/download
  2. Select "Open source" at the bottom of this page
  3. Then select "Download"

When prompted which components to install:

  1. Under the latest Qt version:
  • Select MSVC 2017 64-bit (or MSVC 2015 64-bit, if you still use Visual Studio 2015)
  • Optionally, enable Qt WebEngine
  1. Under Tools:
  • Select Qt Creator, and Qt Creator CDB Debugger Support

Compile with Breakpad support (Optional)

  1. Open up lib/qBreakpad/handler/handler.pro
  2. Build it in whichever mode you want to build Chatterino (Debug/Profile/Release)
  3. Copy the newly built qBreakpad.lib to a folder you create: lib/qBreakpad/build/handler

Windows (Using MSYS2, not recommended)

Note: This guide is currently out of date and will not work as is. Note: This build will have some features missing from the build.

Building using MSYS2 can be quite easier process. Check out MSYS2 at msys2.org.

Be sure to add -j <number of threads> as a make argument so it will use all your cpu cores to build. example setup

You can also add -o2 to optimize the final binary size but increase compilation time, and add -pipe to use more ram in compilation but increase compilation speed

  1. open appropriate MSYS2 terminal and do pacman -S mingw-w64-<arch>-boost mingw-w64-<arch>-qt5 mingw-w64-<arch>-rapidjson, where <arch> is x86_64 or i686
  2. go into the project directory
  3. create build folder mkdir build && cd build
  4. qmake .. && mingw32-make