xcode-build-rs 0.1.0

Build script for XCode when compiling rust for iOS
Documentation
xcode-build-rs-0.1.0 has been yanked.

XCode Build

A 100% Rust wrapper around the iOS XCode build script found in the bevy examples.

Benefits of using a Rust script over a sh (or nu):

  • Can be updated since the binary is distributed using crates.io
  • Allows for global collaboration, e.g. I find a case where I need to sudo xcode-select --install and that suggestion can be added to the error message for everyone to benefit from
  • Can handle more complex logic and using libraries easier, e.g. checks that the cc compiler is on $PATH
  • Logs everything using human-understandable languages (rather than set -exu)

Installation

Usage

Use xcode-build-rs xcode in the actual xcode script. Use xcode-build-rs --colour test to begin a test iOS simulator build, which shouldn't be necessary normally.

Help message xcode-build-rs --help

Build script for XCode when compiling rust for iOS

Usage: xcode-build-rs [OPTIONS] <COMMAND>

Commands:
  xcode  
  test   
  help   Print this message or the help of the given subcommand(s)

Options:
      --colour   By default, doesn't display colour because this can be annoying in the XCode terminal
  -h, --help     Print help
  -V, --version  Print version

Acknowledgements

Based on the bevy mobile example script build_rust_deps.sh here. That script is also based on the mozilla script here

Developing

cargo is to install this locally on your system. cargo rt to run the CLI in test mode locally on your system.