1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
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](https://ninja-build.org)
- Getting Ninja
You can [download the Ninja binary](https://github.com/ninja-build/ninja/releases) or [find
it in your system's package manager](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages)
## 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](https://github.com/mono/mono).
|