Quick Start

You should complete all steps in the Getting Started guide before you try to download and build the source code.

Note

We are currently migrating our private repositories from github.com to gitlab.com.

The Score libraries are hosted on GitLab with some dependencies hosted on Github. Therefore you will need an account on both platforms. See section Git Version Control System in Getting Started for more information.

Download the Source Code

Building the Score Examples and Unit Tests

In the following, we will look at how you can build the Score examples and unit tests using the Waf build system.

  1. Navigate to the directory where you have downloaded the Score source code:

    cd ~/dev/score-c/
    
  2. Invoke waf to build the Score unit tests and examples:

    python waf configure
    

    The waf configure command ensures that all tools needed by Score are available and prepares to build Score. This step will also download several libraries into a local folder called bundle_dependencies.

    Note

    The waf configure step might take several minutes depending on the speed of your Internet connection. This would be a good time to grab a coffee or similar while the dependencies are downloaded.

    Note

    You can use the --bundle-path option to specify the download location for the dependencies (if you want to change the default location).

    On Linux and Mac OSX:

    python waf configure --bundle-path=~/dev/bundle_dependencies
    

    On Windows, you can also specify the bundle-path as an absolute path with a drive letter, for example:

    python waf configure --bundle-path=C:\dev\bundle_dependencies
    

    Note

    If you have not configured Git-over-SSH to automatically authenticate on gitlab.com, you might see an error when waf tries to resolve the dependencies.

    In this case, you can instruct the waf tools to use the https protocol for downloading the dependencies by adding the --git-protocol=https:// option to the configure command (you will have to type your GitHub username and password):

    python waf configure --git-protocol=https://
    
  3. Invoke waf to build the unit tests and examples:

    python waf build
    
  4. Run the unit tests:

    python waf --run_tests
    

    You can find the compiled library and executables in the waf build folder, which depends on your operating system:

    1. Linux: ./build/linux
    2. Mac OSX: ./build/darwin
    3. Windows: ./build/win32

    You can directly run the executables here.