Skip to content

Run on MacOS

Malolan Vasu edited this page May 7, 2020 · 12 revisions

Tools

Install Qt 5.14.1, SQLite3

Install the following packages: cpprestsdk 2.10, boost 1.60, and openssl 1.0 (1.02.t)

Use homebrew to install the above libraries.

Once done, go to QT Creator.

Right Click on the backend subproject and press Add library.

Choose External Library, then tick only the MacOS Platform. Click on the choose file for library path, and navigate to the path where homebrew installed the above packages.

For example, cpprestsdk could have its library path at /usr/local/Cellar/cpprestsdk/2.10.15/lib/libcpprest.2.10.dylib

Do the same for each of these dylibs libboost_system.dylib, libboost_thread-mt.dylib, and libboost_chrono-mt.dylib in the boost package. And also libssl.dylib, lcrypto.dylib in the openssl package.

Repeat the same for the tests/backend subproject.

Running the Server

Run the backend subproject's main.cpp file. If the website doesn't load, your build directory may not be a sibling of the source code directory. Copy your build directory over to the parent directory of your git repo (or source code directory).

If you attempt to run the project again while a server is already running, you will run into an error. To run the unit tests, you will first have to shutdown the server instance.

Viewing the Museum Wiki

1. QT GUI

Run the qtfrontend subproject while the server is running. You should see the home page.

2. Electron

Run the electron executable

3. Web Browser

Navigate to localhost:5300 on any web browser (Any Chromium based browser, Safari, and Firefox are supported).