cpp_building_joynr.md

Building joynr C++

The following scripts found within the joynr repository can be used to build joynr inside a docker container without having to install anything on the build machine.

Prerequisites

See Building joynr Java and common components.

Building with Docker

joynr C++ can be built by executing the following commands:

docker run --rm --sig-proxy -e DEV_UID="$(id -u)" \
    -v <FULL_PATH_TO_JOYNR_SOURCES>:/data/src \
    -v <FULL_PATH_TO_MAVEN_DIRECTORY>:/home/joynr/.m2 \
    -v <FULL_PATH_TO_BUILD_DIRECTORY>:/data/build \
    joynr-base \
    /data/src/docker/joynr-base/scripts/ci/cpp-generate.sh

docker run --rm --sig-proxy -e DEV_UID="$(id -u)" \
    -v <FULL_PATH_TO_JOYNR_SOURCES>:/data/src \
    -v <FULL_PATH_TO_MAVEN_DIRECTORY>:/home/joynr/.m2 \
    -v <FULL_PATH_TO_BUILD_DIRECTORY>:/data/build \
    joynr-base \
    /data/src/docker/joynr-base/scripts/ci/cpp-clean-build.sh --jobs 4

docker run --rm --sig-proxy -e DEV_UID="$(id -u)" \
    -e JOYNR_INSTALL_DIR=/data/build/joynr \
    -v <FULL_PATH_TO_JOYNR_SOURCES>:/data/src \
    -v <FULL_PATH_TO_MAVEN_DIRECTORY>:/home/joynr/.m2 \
    -v <FULL_PATH_TO_BUILD_DIRECTORY>:/data/build \
    joynr-base \
    /data/src/docker/joynr-base/scripts/ci/cpp-radio-app.sh --jobs 4

This will start the docker container joynr-base and execute the scripts docker/joynr-base/scripts/ci/cpp-generate.sh and docker/joynr-base/scripts/ci/cpp-clean-build.sh. Optionally you can also run docker/joynr-base/scripts/ci/cpp-radio-app.sh to build the C++ radio app example.

joynr uses Maven for generating C++ code. You can use your own local Maven repository within the docker container by replacing <FULL_PATH_TO_HOST_MAVEN_DIRECTORY> with the absolute path to your Maven repo. This will then be made available to the build job, mounted at /home/joynr/.m2 in the docker container. As for building joynr Java, the path to the joynr sources <FULL_PATH_TO_JOYNR_SOURCES> has to be provided to be accessible from the docker container at /data/src. Additionally, a directory for the build results <FULL_PATH_TO_BUILD_DIRECTORY> has to be provided.

--jobs 4 restricts the number of jobs of the executed make calls to 4 (default is 8, which may lead to errors on too weak machines)

-e JOYNR_INSTALL_DIR=/data/build/joynr in the second command makes the build results of the first execution available for the second script since they are necessary to build the radio app.

Building natively in Mac OS X

Please consult the wiki: Building joynr C++ in Mac OS X.