Skip to content

Latest commit

 

History

History
49 lines (29 loc) · 2.53 KB

getting_started.md

File metadata and controls

49 lines (29 loc) · 2.53 KB
Raw

Getting started

In order to contribute to RTM you will first need to setup your environment.

Setting up your environment

Windows, Linux, and OS X for x86 and x64

  1. Install CMake 3.2 or higher (3.14 for Visual Studio 2019, or 3.10 on OS X with Xcode 10), Python 2.7 or 3, and the proper compiler for your platform.
  2. Execute git submodule update --init to get the files of external submodules (e.g. Catch2).
  3. Generate the IDE solution with: python make.py
    The solution is generated under ./build
  4. Build the IDE solution with: python make.py -build
  5. Run the unit tests with: python make.py -unit_test
  6. Build and run benchmarks with the -bench switch

On all three platforms, AVX support can be enabled by using the -avx switch and AVX2 with -avx2. Intrinsic usage can be turned off with -nosimd.

Windows ARM64

For Windows on ARM64, the steps are identical to x86 and x64 but you will need CMake 3.13 or higher and you must provide the architecture on the command line: python make.py -compiler vs2017 -cpu arm64

Android

For Android, the steps are identical to Windows, Linux, and OS X but you also need to install Android NDK 21 (or higher). The build uses gradle and -unit_test as well as -bench will deploy and run on the device when executed (make sure that the adb executable is in your PATH for this to work).

Android Studio v3.5 can be used to launch and debug. After running CMake to build and generate everything, the Android Studio projects can be found under the ./build directory.

Note that running the benchmark on Android can be done but it currently involves a number of manual steps.

iOS

For iOS, the steps are identical to the other platforms but due to code signing, you will need to perform the builds from Xcode manually. Note that this is only an issue if you attempt to use the unit tests locally.

In order to run these manually:

  • Open the Xcode project for the appropriate tool
  • In the project settings, enable automatic code signing and select your development team
  • Build and run on your device

Note that iOS builds have never been tested on an emulator.

Emscripten

Emscripten support currently only has been tested on OS X and Linux. To use it, make sure to install a recent version of Emscripten SDK 1.39.11+.

Commit message format

This library uses the angular.js message format and it is enforced with commit linting through every pull request.