src/doc/rustc/src/platform-support/aarch64-apple-ios-sim.md

   1 # aarch64-apple-ios-sim
   2
   3 **Tier: 2**
   4
   5 Apple iOS Simulator on ARM64.
   6
   7 ## Designated Developers
   8
   9 * [@badboy](https://github.com/badboy)
  10 * [@deg4uss3r](https://github.com/deg4uss3r)
  11
  12 ## Requirements
  13
  14 This target is cross-compiled.
  15 To build this target Xcode 12 or higher on macOS is required.
  16
  17 ## Building
  18
  19 The target can be built by enabling it for a `rustc` build:
  20
  21 ```toml
  22 [build]
  23 build-stage = 1
  24 target = ["aarch64-apple-ios-sim"]
  25 ```
  26
  27 ## Cross-compilation
  28
  29 This target can be cross-compiled from `x86_64` or `aarch64` macOS hosts.
  30
  31 Other hosts are not supported for cross-compilation, but might work when also providing the required Xcode SDK.
  32
  33 ## Testing
  34
  35 Currently there is no support to run the rustc test suite for this target.
  36
  37
  38 ## Building Rust programs
  39
  40 *Note: Building for this target requires the corresponding iOS SDK, as provided by Xcode 12+.*
  41
  42 From Rust Nightly 1.56.0 (2021-08-03) on the artifacts are shipped pre-compiled:
  43
  44 ```text
  45 rustup target add aarch64-apple-ios-sim --toolchain nightly
  46 ```
  47
  48 Rust programs can be built for that target:
  49
  50 ```text
  51 rustc --target aarch64-apple-ios-sim your-code.rs
  52 ```
  53
  54 There is no easy way to run simple programs in the iOS simulator.
  55 Static library builds can be embedded into iOS applications.