Primer: iOS support #788

Merged

SakulFlee merged 20 commits from ios-support into main 2026-09-21 21:57:39 +00:00

Conversation 0 Commits 20 Files changed 30 +1442 -48

SakulFlee commented 2026-09-20 23:35:54 +00:00

Owner

Copy link

This PR is adding iOS support similar to Android.
Unfortunately, we cannot properly test iOS support at this moment.
There might / will be issues ... please report them!

This PR is adding iOS support similar to Android. Unfortunately, we cannot properly test iOS support at this moment. There might / will be issues ... please report them!

SakulFlee added the

Platform: iOS

Target: CI

labels 2026-09-20 23:35:54 +00:00

SakulFlee self-assigned this 2026-09-20 23:35:54 +00:00

SakulFlee added 11 commits 2026-09-20 23:35:54 +00:00

feat(ios): add objc2 workspace dependencies for iOS Foundation FFI 8e210a308a

feat(ios): add iOS FileManager backend (NSBundle + Documents dir) ... d07af0cbe4

- New ios.rs: IosAssetSource (bundle resources) and IosStorage (Documents)
- Updated lib.rs: three-way dispatch (desktop/android/ios)
- Updated dir.rs: exclude iOS from DesktopAssetSource/DesktopStorage
- Updated Cargo.toml: objc2 + objc2-foundation for iOS FFI
- Made DirStorage::resolve pub for use by IosAssetSource

feat(ios): add iOS-specific logging (stdout-only, no file rotation) ... 8b69b6f5b9

iOS sandbox restricts filesystem access, so the desktop log file rotation
is not usable. iOS init uses fern with stdout only, matching the pattern
used for Android's logcat output.

feat(ios): add make_ios_main! entry point macro ... 52d87df430

- New make_ios_main! generates extern "C" fn ios_main() for UIKit
- Updated make_main! to include iOS variant
- Updated make_desktop_main! to exclude iOS (iOS uses ios_main, not main)

fix(ios): exclude iOS from gamepad input cfg guards ... bf56d51bd4

gilrs does not support iOS, so all gamepad_input and gamepad_input_poll
gates now exclude both Android and iOS.

feat(ios): add iOS conditional dependencies to orbital crate ... 81da8d10e2

Adds winit as an iOS target dependency (no special features needed,
unlike Android's android-native-activity).

fix(ios): update cfg guards in examples and template for iOS ... 9c3ea00559

All #[cfg(not(target_os = android))] guards on logging::init() calls
now exclude both Android and iOS, since iOS uses its own entry point
make_ios_main! which calls init() before the user's entrypoint.

docs(ios): update README platform compatibility for iOS ... b7d359d769

Change iOS status from ❓ to ⚠️, noting it compiles but is untested
with boilerplate provided for community testing.

feat(ios): add iOS configuration to Orbital.toml ... c2ec2e36ea

Adds [ios] section with bundle_id, deployment_target, and app_name
defaults, matching the existing [android] configuration pattern.

feat(ios): add iOS CLI tooling (project gen, build, simulator, run) ... 6926141695

- ios/project.rs: Xcode project generation (pbxproj, Info.plist, AppDelegate, storyboards)
- ios/build.rs: cargo build + xcodebuild orchestration
- ios/device.rs: Simulator management via xcrun simctl
- ios/run.rs: Install and launch on simulator
- main.rs: Add Platform::Ios variant
- config.rs: Add IosConfig struct and load_ios_config()

All iOS commands require macOS with Xcode installed and will bail
with a clear error message on other platforms.

ci(ios): add iOS build target to GitHub Actions ... bf6d9dbbcc

Adds build-ios job that runs on macos-latest, builds a static library
for aarch64-apple-ios, and uploads it as a release artifact. The
release job now depends on build-ios.

SakulFlee added 1 commit 2026-09-21 01:08:13 +00:00

merge: resolve conflicts with main (add iOS cfg guards to new overlay/iced features) 6f23fd57e8

SakulFlee added 1 commit 2026-09-21 16:31:55 +00:00

Merge branch 'main' into ios-support f3232e7e0c

SakulFlee added 1 commit 2026-09-21 16:56:51 +00:00

Merge branch 'main' into ios-support f9d1a84279

SakulFlee added 1 commit 2026-09-21 18:54:17 +00:00

Merge branch 'main' into ios-support c3889f30de

SakulFlee added 2 commits 2026-09-21 19:21:34 +00:00

fix(ios): move pbxproj template to separate file to fix Rust parser error ... f4f1d71dfa

The inline raw string for the Xcode project.pbxproj contained escaped
quotes in the embedded shell script that caused 'unknown start of token'
errors during compilation. Moved the template to
Tools/orbital-cli/src/template/ios/project.pbxproj and load it via
include_str! instead.

Merge remote-tracking branch 'origin/ios-support' into ios-support f2dcb43cc5

SakulFlee added 1 commit 2026-09-21 20:05:06 +00:00

fix(ios): don't double-wrap event_loop in Ok() for desktop and iOS macros ... 696255406c

EventLoop::builder().build() already returns Result<EventLoop, EventLoopError>.
Wrapping it in Ok() created Ok(Result<...>) which didn't match the entrypoint
signature expecting a bare EventLoop on desktop (or Result on Android/iOS).

Desktop: pass Result directly (entrypoint takes Result)
Android: keep Ok(event_loop) — match already unwraps the Result
iOS: pass Result directly (entrypoint takes Result)

SakulFlee added 1 commit 2026-09-21 20:14:40 +00:00

fix(ios): correct include_str path, fix unused imports and type ambiguity cef1c7887a

SakulFlee added 1 commit 2026-09-21 20:24:01 +00:00

fix(ci): use #*:// to strip any protocol from GITHUB_SERVER_URL in lint auto-push ... 580c934cba

GITHUB_SERVER_URL may be http:// or https:// depending on the
environment. Using ${GITHUB_SERVER_URL#*://} strips any protocol
prefix, preventing double-protocol URLs like https://http://...

SakulFlee merged commit 1ebda27c35 into main 2026-09-21 21:57:39 +00:00

SakulFlee referenced this pull request from a commit 2026-09-21 21:57:40 +00:00

Merge pull request 'Primer: iOS support' (#788) from ios-support into main

SakulFlee added the

Context: Enhancements

label 2026-09-25 02:39:04 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

Context: Bug

Something isn't working as intended

  

Context: Enhancements

Enhancements of existing features

  

Platform: Android

ONLY if this is platform specific!

  

Platform: Linux

ONLY if this is platform specific!

  

Platform: Web

ONLY if this is platform specific!

  

Platform: Windows

ONLY if this is platform specific!

  

Platform: iOS

ONLY if this is platform specific!

  

Platform: macOS

ONLY if this is platform specific!

  

Target: CI

GitHub Actions / CI related tasks

  

Target: CLI

  

Target: Dependency

  

Target: Engine

No labels

Context: Bug

Context: Enhancements

Platform: Android

Platform: Linux

Platform: Web

Platform: Windows

Platform: iOS

Platform: macOS

Target: CI

Target: CLI

Target: Dependency

Target: Engine

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

SakulFlee

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

SakulFlee/Orbital!788

No description provided.