mono/sdks

This project provides build scripts and sample apps for Mono targeting its supported platforms. Supported are Android, iOS and WebAssembly.

Build instructions

Dependencies

• automake 1.16.1

if you have already built before using a previous version of automake you may need to clean the repo.

      git clean -xffd

The previous should be sufficient but if that does not work then try hard resetting

   git reset --hard && git clean -xffd && git submodule foreach --recursive git reset --hard && git submodule foreach --recursive git clean -xffd && git submodule update --init --recursive

• ninja build system

  • Getting Ninja

  You can download the Ninja binary or find it in your system's package manager

Setup

Copy Make.config.sample to Make.config and edit the new file to disable building the target you're not interested in. Unless you have a very particular need, the BCL build should be left enabled as it's needed by all test runners.

Targets

To build Mono for Android, iOS or WebAssembly, the build scripts can be found in sdks/builds/. There are 5 predefined targets that can be invoked:

• toolchain: setup the toolchain so we can cross-compile the runtime for the appropriate platform
• configure: configure the build of Mono
• build: build Mono
• package: provide a package of the built Mono, the result can be found in sdks/builds/out/
• clean: clean the Mono build directory

The make targets are as follow:

# Android
make -C builds {toolchain,configure,build,package,clean}-android-{armeabi,armeabi-v7a,arm64-v8a,x86,x86_64}

# iOS
make -C builds {toolchain,configure,build,package,clean}-ios-{target{32,64},sim{32,64},cross{32,64}}

# WebAssembly
make -C builds {toolchain,configure,build,package,clean}-wasm-runtime

Testing instructions

WebAssembly

First, ensure the bcl and wasm-runtime have been built and packaged in the builds directory:

make build-wasm-runtime package-wasm-runtime make build-bcl package-bcl `

Go to the wasm directory for building and testing WebAssembly. Right now the following targets are available:

• do-runtime: Encompasses all the previous steps
• build: Build the test runner and test suites
• run-all-mini: Run mini test suite
• run-all-corlib: Run corlib test suite
• run-all-system: Run System test suite
• run-all-system-core: Run System.Core test suite
• run-all-binding: Run bindings test suite

For bcl or runtime changes, you must manually run the corresponding build/package steps in builds. For test suite changes, it's enough to just rerun the local target.

Dependencies

Project	Dependencies
Android	Android SDK and NDK
iOS	Xcode
WebAssembly

See sdks/versions.mk for specific version numbers, and sdks/paths.mk for where they should be installed. These dependencies will not be installed as part of the build process, and will be expected to be present; an error will be triggered if it's not the case. If you need an additional version, please do contact us or submit a pull-request against mono/mono.