Magic Lantern Developer Wiki
Build Cross-platform Applications
Status: Beta
Brought to you by:
wizzerworks
Menu
▾
▴
Qt_Target_for_Linux_Platform
Build Instructions for Linux Qt Target
This documentation discusses how to set up a Qt Runtime Target for the Ubuntu 16.04 LTS 64-bit platform.
Install Qt
To install Qt on the Ubuntu 16.04 LTS 64-bit platform, do the following:
Install Qt Creator and SDKs
Use the following Qt installer to download and install Qt Creator and 5.x versions of the SDK.
chmod +x qt-unified-linux-x64-3.0.2-online.run ./qt-unified-linux-x64-3.0.2-online.run
Make sure to install the "Desktop Qt 5.8.0 GCC 64bit" kit. The Magic Lantern Qt libraries have only been tested against this version of the Qt SDK.
Add missing examples
The QtCreator installation does not install example code and documentation. So, do the following:
sudo apt-get install qtbase5-examples qtbase5-doc-html qt5-doc qt5-doc-html
Build Generic Linux Modules
Use the instructions found at SDK Build Environment for Linux Platform to generate the runtime libraries and mastering tools for the Linux platform.
You do not need to build the Rehearsal Player components (Actors/Roles/Mediarefs/Sets/Stages) found on that page since those instructions target the Coin 3D Inventor platform. The Qt Runtime Target uses OpenGL without the Coin 3D Scene Graph.
Build Qt Target Parts
The Qt runtime libraries may be built by using either the QtCreator IDE or in batch mode.
Qt Creator Build Instructions
Load the following projects into Qt Creator:
| Library | Location | Description |
|---|---|---|
| qtstage | $MLE_HOME/Parts/stages/qt/mleqtstage.pro | Qt Stage |
| qtmref | $MLE_HOME/Parts/mediaref/qt/mleqtmref.pro | Qt Media References |
| qtset | $MLE_HOME/Parts/sets/qt/mleqtset.pro | Qt Sets |
| qtrole | $MLE_HOME/Parts/roles/qt/mleqtrole.pro | Qt Roles |
Note that the "<project>.pro.user" files are not tracked by the source code repository. Therefore, these files must be configured the first time that Qt Creator is used. For each of the above projects, enable the "Desktop Qt 5.8.0 GCC 64bit" kit. This can be done in the "Projects" tab under the "Build & Run" dialog on the left-hand side of the tab.
Also, update the Debug and Release "Build directory" for each respective project to
| Build Directory | Description |
|---|---|
| $(MLE_HOME)/Parts/stages/qt/build/build-mleqtstage-Desktop_Qt_5_8_0_GCC_64bit-Debug | qtstage Debug build |
| $(MLE_HOME)/Parts/stages/qt/build/build-mleqtstage-Desktop_Qt_5_8_0_GCC_64bit-Release | qtstage Release build |
| $(MLE_HOME)/Parts/mediaref/qt/build/build-mleqtmref-Desktop_Qt_5_8_0_GCC_64bit-Debug | qtmref Debug build |
| $(MLE_HOME)/Parts/mediaref/qt/build/build-mleqtmref-Desktop_Qt_5_8_0_GCC_64bit-Release | qtmref Release build |
| $(MLE_HOME)/Parts/sets/qt/build/build-mleqtset-Desktop_Qt_5_8_0_GCC_64bit-Debug | qtset Debug build |
| $(MLE_HOME)/Parts/sets/qt/build/build-mleqtset-Desktop_Qt_5_8_0_GCC_64bit-Release | qtset Release build |
| $(MLE_HOME)/Parts/roles/qt/build/build-mleqtrole-Desktop_Qt_5_8_0_GCC_64bit-Debug | qtrole Debug build |
| $(MLE_HOME)/Parts/roles/qt/build/build-mleqtrole-Desktop_Qt_5_8_0_GCC_64bit-Release | qtrole Release build |
Batch Build Instructions for Qt
The batch Makefile depends that the libraries have been configured with the above kit and Debug/Release paths.
Use the following instructions to build all the Qt libraries in batch mode (without Qt Creator):
- cd $MLE_HOME/build/linux
- make qt_install
The libraries will be installed in $MLE_ROOT. By default, this should /opt/MagicLantern/lib.
Build qtstage library in Batch Mode
To build the libqtstage library in batch mode, do the following:
- cd $MLE_HOME/build/linux
- make qtstage_install
The build artifacts will be located in $(MLE_HOME)/Parts/stages/qt/build/build-mleqtstage-Desktop_Qt_5_8_0_GCC_64bit-Debug.
The library will be installed to $MLE_ROOT/lib/libqtstage.so.
Build qtmref library in Batch Mode
To build the Qt Media Reference library, libgtmref, do the following:
- cd $MLE_HOME/build/linux
- make qtmref_install
The build artifacts will be located in $(MLE_HOME)/Parts/mediaref/qt/build/build-mleqtmref-Desktop_Qt_5_8_0_GCC_64bit-Debug.
The library will be installed to $MLE_ROOT/lib/libqtmref.so.
Build qtset library in Batch Mode
To build the Qt Set library, libqtset, do the following:
- cd $MLE_HOME/build/linux
- make qtset_install
The build artifacts will be located in $(MLE_HOME)/Parts/sets/qt/build/build-mleqtset-Desktop_Qt_5_8_0_GCC_64bit-Debug.
The library will be installed to $MLE_ROOT/lib/libqtset.so.
Build qtrole library in Batch Mode
To buid the libqtrole library in batch mode, do the following:
- cd $MLE_HOME/build/linux
- make qtrole_install
The build artifacts will be located in $(MLE_HOME)/Parts/roles/qt/build/build-mleqtrole-Desktop_Qt_5_8_0_GCC_64bit-Debug.
The library will be installed to $MLE_ROOT/lib/libqtrole.so.