Skip to content

Build OpenBoard on Windows 10 (1.6.4 and before)

Jump to bottom
kaamui edited this page Jan 2, 2024 · 2 revisions

⚠️ Disclaimer ⚠️

These instructions work only for OpenBoard 1.6.4, and no longer work for the current version. We recommend you to follow the instructions for OpenBoard 1.7 instead. To do so, please follow this link

Prepare your environment

Install git bash

Install VS 2019 Community

  1. Download https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community&rel=16
  2. Choose Desktop Development in C++

Install Qt

go to Qt downloads page and follow the instructions to download the opensource version of Qt

  • https://www.qt.io/download-open-source
  • at the bottom of the page, click on the "Download the Qt Online Installer" button
  • on the next page, Qt chose automatically the version corresponding to your current OS, so be sure it is the version you want to download (for this example, "Qt Online Installer for Windows (64-bit)")
  • click on the "Download" button

Follow the instructions (for this example, Qt is installed in C:\ and pick the <Qt_version> you want (for example 5.15.2), regarding that :

  • no need for Web Assembly, Android compilers or even sources so you can deactivate them to reduce the amount of data installed
  • QtWebkit only provides packages for Qt 5.15 in their latest release. If you use another version of Qt, you'll have to compile QtWebkit by yourself.

For the rest of this tutorial, we supposed Qt is installed at "C:\Qt"

Install QtWebKit

Download QtWebKit :

Add qmake to environment variables

  • Add qmake folder to environment variables :

    • search for "Environment Variables" on Windows searchbar, click on it.
    • click on the last button at the bottom of the page, called "environment variables"
    • on the "system variables" window, add the Qt bin folder - where qmake.exe, using msvc 2019, is located - to the Path variable (for example "C:\Qt\5.14.2\msvc2019_64\bin")

  • search for "Developer Command Prompt for VS 2019" on Windwos searchbar, click on it

You can verify that you correctly configured qmake and nmake by respectively taping qmake -v and nmake/? these commands should show something like following :

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community>qmake -v
QMake version x.y
Using Qt version <Qt_version> in <path_to_your_Qt_folder>/<Qt_version>/msvc2019_64/lib

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community>nmake /?
Microsoft (R) Program Maintenance Utility Version 14.26.27034.0
Copyright (C) Microsoft Corporation. Tous droits réservés.

Download OpenBoard sources

  • Open git bash
# place yourself in the directory you want 
# (in this example at user's home directory)
cd

# create the folder
mkdir openboard

# enter in it
cd openboard

# download openboard sources
git clone https://github.com/OpenBoard-org/OpenBoard.git
git clone https://github.com/OpenBoard-org/OpenBoard-Importer.git
git clone https://github.com/OpenBoard-org/OpenBoard-ThirdParty.git

Compile OpenBoard

First, you need to compile the third-party libraries that OpenBoard is going to need.

Still in this Command Prompt, go to Openboard-ThirdParty's directory

cd <path_to_openboard>
cd Openboard-ThirdParty

freetype

cd freetype
qmake freetype.pro
nmake

quazip

cd quazip
qmake quazip.pro
nmake

xpdf

cd xpdf
qmake xpdf.pro
nmake

OpenBoard

Now, you can go back to OpenBard's directory

cd <path_to_openboard>
cd Openboard

You can now compile OpenBoard

qmake OpenBoard.pro
nmake

Package OpenBoard

Install Inno Setup

Configure the packaging script

Go to :

cd release_scripts\windows

Open release.win7.vc9.bat in your favourite text editor, and modify these lines to point to the correct locations :

#In our example
set QT_DIR=C:\Qt\5.15.2\msvc2019_64
 
#...
set INNO_EXE=%PROGRAMS_FILE_PATH%\Inno Setup 6\iscc.exe

Launch the packaging

release.win7.vc9.bat

Now, you should see your OpenBoard installer in <path_to_openboard>/Openboard/install/windows>

Clone this wiki locally