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.