Ios support

README.md

@@ -19,11 +19,13 @@ _Since Bevy is in heavy development, there regularly are unpublished new feature
  4. Start coding :tada:
     * Start the native app: `cargo run`
     * Start the web build: `trunk serve`
-       * requires [trunk]: `cargo install --locked trunk`
-       * requires `wasm32-unknown-unknown` target: `rustup target add wasm32-unknown-unknown`
-       * this will serve your app on `8080` and automatically rebuild + reload it after code changes
+        * requires [trunk]: `cargo install --locked trunk`
+        * requires `wasm32-unknown-unknown` target: `rustup target add wasm32-unknown-unknown`
+        * this will serve your app on `8080` and automatically rebuild + reload it after code changes
     * Start the android app: `cargo apk run -p mobile` (update the library name if you changed it)
-       * check the [bevy example readme for android setup instructions][android-instructions]
+        * check the [bevy example readme for android setup instructions][android-instructions]
+    * Start the iOS app: run `make run` inside the `/mobile` directory
+        * check the [bevy example readme for ios setup instructions][ios-instructions]
 
 You should keep the `credits` directory up to date. The release workflow automatically includes the directory in every build.
 
@@ -74,3 +76,4 @@ This project is licensed under [CC0 1.0 Universal](LICENSE) except some content
 [`wasm-server-runner`]: https://github.com/jakobhellermann/wasm-server-runner
 [trunk]: https://trunkrs.dev/
 [android-instructions]: https://github.com/bevyengine/bevy/blob/latest/examples/README.md#setup
+[ios-instructions]: https://github.com/bevyengine/bevy/blob/latest/examples/README.md#setup-1

mobile/.gitignore

@@ -0,0 +1,3 @@
+mobile.xcodeproj/xcuserdata/
+mobile.xcodeproj/project.xcworkspace/
+build/

mobile/Makefile

@@ -0,0 +1,26 @@
+.PHONY: xcodebuild run install boot-sim generate clean
+
+DEVICE = ${DEVICE_ID}
+ifndef DEVICE_ID
+	DEVICE=$(shell xcrun simctl list devices 'iOS' | grep -v 'unavailable' | grep -v '^--' | grep -v '==' | head -n 1 | cut -d ' ' -f 7 | sed 's/[()]//g')
+endif
+
+run: install
+    # Todo: change the bundle identifier (then remove this comment :P)
+	xcrun simctl launch --console $(DEVICE) me.nikl.bevygame
+
+boot-sim:
+	xcrun simctl boot $(DEVICE) || true
+
+install: xcodebuild-simulator boot-sim
+	xcrun simctl install $(DEVICE) build/Build/Products/Debug-iphonesimulator/mobile.app
+
+xcodebuild-simulator:
+	IOS_TARGETS=x86_64-apple-ios xcodebuild -scheme mobile -configuration Debug -derivedDataPath build -destination "id=$(DEVICE)"
+
+xcodebuild-iphone:
+	IOS_TARGETS=aarch64-apple-ios xcodebuild -scheme mobile -configuration Debug -derivedDataPath build -arch arm64
+
+clean:
+	rm -r build
+	cargo clean

mobile/build_rust_deps.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+
+# based on https://github.com/mozilla/glean/blob/main/build-scripts/xc-universal-binary.sh
+
+set -eux
+
+PATH=$PATH:$HOME/.cargo/bin
+
+RELFLAG=
+if [[ "$CONFIGURATION" != "Debug" ]]; then
+    RELFLAG=--release
+fi
+
+set -euvx
+
+if [[ -n "${DEVELOPER_SDK_DIR:-}" ]]; then
+  # Assume we're in Xcode, which means we're probably cross-compiling.
+  # In this case, we need to add an extra library search path for build scripts and proc-macros,
+  # which run on the host instead of the target.
+  # (macOS Big Sur does not have linkable libraries in /usr/lib/.)
+  export LIBRARY_PATH="${DEVELOPER_SDK_DIR}/MacOSX.sdk/usr/lib:${LIBRARY_PATH:-}"
+fi
+
+# add homebrew bin path, as it's the most commonly used package manager on macOS
+# this is needed for cmake on apple arm processors as it's not available by default
+export PATH="$PATH:/opt/homebrew/bin"
+
+IS_SIMULATOR=0
+if [ "${LLVM_TARGET_TRIPLE_SUFFIX-}" = "-simulator" ]; then
+  IS_SIMULATOR=1
+fi
+
+for arch in $ARCHS; do
+  case "$arch" in
+    x86_64)
+      if [ $IS_SIMULATOR -eq 0 ]; then
+        echo "Building for x86_64, but not a simulator build. What's going on?" >&2
+        exit 2
+      fi
+
+      # Intel iOS simulator
+      export CFLAGS_x86_64_apple_ios="-target x86_64-apple-ios"
+      cargo rustc --crate-type staticlib --lib $RELFLAG --target x86_64-apple-ios
+      ;;
+
+    arm64)
+      if [ $IS_SIMULATOR -eq 0 ]; then
+        # Hardware iOS targets
+        cargo rustc --crate-type staticlib --lib $RELFLAG --target aarch64-apple-ios
+      else
+        # M1 iOS simulator -- currently in Nightly only and requires to build `libstd`
+        cargo rustc --crate-type staticlib --lib $RELFLAG --target aarch64-apple-ios-sim
+      fi
+  esac
+done

mobile/ios-src/Info.plist

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+	<key>UILaunchStoryboardName</key>
+	<string>LaunchScreen</string>
+	<key>UIRequiresFullScreen</key>
+	<false/>
+	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+		<string>UIInterfaceOrientationPortraitUpsideDown</string>
+	</array>
+</dict>
+</plist>

mobile/ios-src/bindings.h

@@ -0,0 +1 @@
+void main_rs(void);

mobile/ios-src/main.m

@@ -0,0 +1,6 @@
+#import "bindings.h"
+
+int main() {
+    main_rs();
+    return 0;
+}