Installation for Linux

Prerequisites for Linux users

If not already installed:

1. Install Mercurial (apt-get install mercurial)
2. Optionally you can install TortoiseHg
3. Install gcc (apt-get install gcc)
4. Install clang (apt-get install clang)

4. Install Python 2.7 (apt-get install python2.7)
5. Install CMake (apt-get install cmake)
6. Install jom (apt-get install jom)

Qt is an external library used in FW4SPL. For the successful compilation of Qt with FW4SPL, please see the following requirements:

• http://wiki.qt.io/Building_Qt_5_from_Git

FW4SPL installation

FW4SPL works with data separation for source, build and install data. To prepare the development environment:

• Create a development folder (Dev)
• Create a build folder (Dev\Build)
• Create a source folder (Dev\Src)
• Create a install folder (Dev\Install)

To prepare the third party environment:

• Create a third party folder (BinPkgs)
• Create a build folder (BinPkgs\Build)
• Create a source folder (BinPkgs\Src)
• Create a install folder (BinPkgs\Install)

Dependencies

For the third party libraries the three following repositories have to be cloned in the (BinPkgs) source folder:

• fw4spl-deps
• fw4spl-ar-deps
• fw4spl-ext-deps

Update the cloned repositories to the used version. Call the cmake-gui or change the cmake arguments with the console from the BinPkgs build folder location. Choose jom or nmake as build tool for cmake. The following arguments have to be changed:

• ADDITIONAL_PROJECTS: set the source location of fw4spl-ar-deps and fw4spl-ext-deps
• CMAKE_INSTALL_PREFIX: set the install location.

Configure and generate the code. Compile the FW4SPL dependencies with jom or nmake in the console.

Source

For the FW4SPL source code the three following repositories have to be cloned in the (Dev) source folder:

• fw4spl
• fw4spl-ar
• fw4spl-ext

Update the cloned repositories to the used version. Make sure that cmake is set as environment variable. Call the cmake-gui or change the cmake arguments with the console from the Dev build folder location. Choose jom or nmake as build tool for cmake. The following arguments have to be changed:

• ADDITIONAL_PROJECTS: set the source location of fw4spl-ar and fw4spl-ext
• CMAKE_INSTALL_PREFIX: set the install location.
• EXTERNAL_LIBRARIES: set the install path of the third part libraries.

Make sure the arguments concerning the compiler (advanced arguments) point to the preferred compiler. Configure and generate the code. Compile the FW4SPL source code with jom or nmake in the console . To develop applications with FW4SPL the source code can be imported and compiled with the preferred development environment.

Launch an application

To work with an specific application or several applications the cmake argument PROJECTS_TO_BUILD can be set. After an successful compilation the application can be launched with the launcher program from FW4SPL. Therefore the profile.xml of the application in the build folder has to be passed as argument to the launcher call in the console. (bin/launcher Bundles/MyApplicationAndVersion/profile.xml)

Recommended software

The following programs may be helpful for your developments:

• Install Eclipse CDT. Eclipse is a multi-OS Integrated Development Environment (IDE) for computer programming.

Release

To generate the projects in release, the following instruction has to be added:

• Change CMake argument CMAKE_BUILD_TYPE to release
• Reference the EXTERNAL_LIBRARIES to the install folder of third part libraries compiled in release mode (for compiling the FW4SPL projects)