Eve library

iris/mobile — Missing iOS .xcodeproj

Other

Revision 1

On this page

Status: the ios/ directory has the Swift source (AppDelegate, Info.plist, the Iris/ target dir with all of the iOS source files, the Pods directory, the Podfile), but no .xcodeproj to bind those files into an Xcode-buildable target. Closes #57.

What's present#

text
apps/iris/mobile/ios/
├── Iris/              # main iOS target source
│   ├── AppDelegate.swift
│   ├── Info.plist
│   ├── Iris.entitlements
│   ├── LaunchScreen.storyboard
│   ├── Assets.xcassets/
│   ├── Intents/
│   ├── LiveActivities/
│   ├── NativeModules/
│   └── Services/
├── IrisIntents/        # SiriKit intent extension target
├── IrisWidgets/        # WidgetKit extension target
├── Podfile
├── Pods/               # gitignored; regenerated by `pod install`
└── build/              # gitignored

What's missing#

  • apps/iris/mobile/ios/Iris.xcodeproj/project.pbxproj (and the surrounding .xcodeproj directory + .xcworkspace directory)
  • Without this, xcodebuild cannot find a project to build and pod install cannot link Pods into a target.

Generate#

Two paths, in order of preference:

bash
RN_VERSION="$(node -e "console.log(require('./apps/iris/mobile/package.json').dependencies['react-native'])")"
npx @react-native-community/cli@latest init Iris \
  --version "$RN_VERSION" \
  --directory /tmp/iris-ios-scaffold

# Copy the generated .xcodeproj and .xcworkspace into our tree
cp -r /tmp/iris-ios-scaffold/ios/Iris.xcodeproj apps/iris/mobile/ios/
cp -r /tmp/iris-ios-scaffold/ios/Iris.xcworkspace apps/iris/mobile/ios/

# Open it in Xcode and:
#   a) Add the IrisIntents target (File → New → Target → Intents Extension)
#   b) Add the IrisWidgets target (File → New → Target → Widget Extension)
#   c) For each, drag the existing Iris/, IrisIntents/, IrisWidgets/
#      source files into the matching target's "Compile Sources" build phase
#   d) Update the bundle identifier in Build Settings → Packaging →
#      Product Bundle Identifier to match the existing Info.plist
#         (CFBundleIdentifier in apps/iris/mobile/ios/Iris/Info.plist)

rm -rf /tmp/iris-ios-scaffold
cd apps/iris/mobile/ios && pod install

2. Hand-roll via the xcodeproj Ruby gem#

If you need to script the generation (CI doesn't have Xcode UI to add the extension targets):

bash
gem install xcodeproj  # requires Ruby 3.x — see docs/runbooks/ios-toolchain.md

# scripts/generate-iris-xcodeproj.rb is the templated generator;
# add it the next time this needs to happen via CI.

The xcodeproj gem can generate the full PBX tree programmatically. For three-target apps like iris (main + Intents extension + Widgets extension), this is doable in ~150 lines of Ruby. Until that generator script exists, path 1 (init + manual extension wiring) is the only working option.

After generation#

  1. Open Iris.xcworkspace (NOT Iris.xcodeproj — the workspace includes the Pods).
  2. Verify the team / signing identity matches the org's Apple Developer account.
  3. Build for iOS Simulator first; once that passes, build for a physical device.
  4. Run scripts/check-ios-toolchain.sh to confirm the host toolchain is healthy.

Until the xcodeproj lands#

  • pnpm typecheck (npx tsc --noEmit) is the only working dev loop.
  • The mobile-build-smoke.yml CI workflow targets veritas/mobile (which is a working bare RN app) rather than iris/mobile. Do not add iris/mobile to that workflow until the xcodeproj is in place.
  • pnpm ios will fail with error: Could not find Xcode project in directory ... — that's expected, not a bug.