sdks/README.md

   1 This project provides build scripts and sample apps for Mono targeting its supported platforms. Supported are Android, iOS and WebAssembly.
   2
   3 # Build instructions
   4
   5 ## Dependencies
   6
   7 - automake 1.16.1
   8
   9   if you have already built before using a previous version of automake you may need to clean the repo.
  10
  11   ```bash
  12   git clean -xffd
  13   ```
  14
  15   The previous should be sufficient but if that does not work then try hard resetting
  16
  17   ```bash
  18   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
  19   ```
  20
  21 - [ninja build system](https://ninja-build.org)
  22
  23   - Getting Ninja
  24
  25     You can [download the Ninja binary](https://github.com/ninja-build/ninja/releases) or [find
  26     it in your system's package manager](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages)
  27
  28 ## Setup
  29
  30 Copy `Make.config.sample` to `Make.config` and edit the new file to disable building the target you're not interested in.
  31 Unless you have a very particular need, the BCL build should be left enabled as it's needed by all test runners.
  32
  33 ## Building for XA/XI/XM and WebAssembly
  34
  35 To build Mono for Android, iOS or WebAssembly, the build scripts can be found in `sdks/builds/`.
  36
  37 The `make` targets are as follow:
  38
  39 ```bash
  40 # Android
  41 mono$ make -C sdks/builds provision-android && make -C sdks/android accept-android-license
  42 mono$ make -C sdks/builds provision-mxe
  43 mono$ make -C sdks/builds archive-android NINJA= IGNORE_PROVISION_ANDROID=1 IGNORE_PROVISION_MXE=1
  44
  45 # iOS
  46 mono$ make -C sdks/builds archive-ios NINJA=
  47
  48 # WebAssembly
  49 mono$ make -C sdks/builds provision-wasm
  50 mono$ make -C sdks/builds archive-wasm  NINJA=
  51
  52 # Mac
  53 mono$ make -C sdks/builds archive-mac [upcoming]
  54 ```
  55
  56 # WebAssembly
  57
  58 Go to the `wasm` directory for building and testing WebAssembly.  For more information view the [WebAssembly readme](./wasm/README.md)
  59
  60
  61 # Dependencies
  62
  63 | Project     | Dependencies        |
  64 | ----------- | ------------------- |
  65 | Android     | Android SDK and NDK |
  66 | iOS         | Xcode               |
  67 | WebAssembly |                     |
  68
  69 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).