A PID environement provides a little set commands to manage its lifecycle. All these commands must be called from the build folder of the framework.

Before being able to use this command, they must be configured from CMake configuration script defined in the CMakeLists.txt of the framework:

cd <workspace dir>/environments/<environment name>/build
cmake .. #building commands

Once this last command has been executed, developers can use native build tool to execute environment specific commands that are defined by PID system. We suppose here we use the make tool but any other tool can be used the same way.

The commands are simply called using built tool specific targets, that are listed below.

Commands summary

  • make build: building the environment with given platform and user-defined constraints. Used to test if environment works.
  • make referencing: Referencing the environment in the workspace.

Building the environment

  • Call: make build
  • Effect: evaluates environment against host configuration and if successful generates adequate CMake files use to configrue workspace build process. This command is mainly used to test enviroments while they are developped.
  • Arguments:

    • {optionnal} proc_type: specify a constraint on target processor type when evaluating environment (e.g. x86, arm).
    • {optionnal} proc_arch: specify a constraint on target processor architecture (e.g. 32, 64).
    • {optionnal} os: specify a constraint on target operating system (e.g. linux, macosx).
    • {optionnal} abi: specify a constraint on target C++ ABI (e.g. 98, 11).
    • {optionnal} distribution: specify a constraint on target distribution (e.g. ubuntu, debian).
    • {optionnal} distrib_version: specify a constraint on target distribution version.
    • {optionnal} sysroot: specify a sysroot for crosscompilation.
    • {optionnal} staging: specify a staging folder for crosscompilation.
    • other arguments are environment specific and defined by their respective constraints. A very common specific argument is version to specify version of a toolchain.

Referencing the environment in the workspace

  • Call: make referencing
  • Effect: generates the reference file for the environment and places it in the adequate folder of the workspace. When done, the environment is known in the local workspace and will be known by all users when workspace official repository will be updated accordingly.
  • Arguments: none