ci_post_clone.sh

#!/bin/sh
#
# Xcode Cloud post-clone hook for a Flutter app.
#
# THE PROBLEM: Xcode Cloud clones your repo and runs `xcodebuild` on
# Runner.xcworkspace — but it knows nothing about Flutter. The Flutter SDK,
# Generated.xcconfig, the Flutter/App frameworks, the plugin registrant, and the
# CocoaPods the Runner target depends on are all absent, so the build fails.
#
# THE FIX: this script installs Flutter and generates those artifacts before
# Xcode Cloud's build step runs. Xcode Cloud automatically executes any
# `ci_scripts/ci_post_clone.sh` located next to the Xcode project.
#
# Place this at:  <flutter-project>/ios/ci_scripts/ci_post_clone.sh   (chmod +x)
#
# Configure via Xcode Cloud Environment Variables:
#   FLUTTER_VERSION              required — pin it (see GOTCHA #2)
#   FLUTTER_PROJECT_PATH         path to the Flutter project within the repo
#                                (default ".", e.g. "mobile" for a monorepo)
#   GOOGLE_SERVICE_INFO_PLIST_B64  optional — base64 of GoogleService-Info.plist
#                                  to enable FCM push (see GOTCHA #6)
#   plus any --dart-define values your app needs.

set -e

# --- 1. Install a PINNED Flutter -----------------------------------------------
# Pin to the exact version that generated your committed Package.resolved.
# Xcode Cloud disables automatic SwiftPM resolution, so the regenerated plugin
# package graph must match the lockfile byte-for-byte. A floating "stable" pulls
# newer plugin versions and breaks resolution ("dependencies were added: ...").
# Bump this in lockstep with Package.resolved. See docs/GOTCHAS.md #2.
FLUTTER_VERSION="${FLUTTER_VERSION:?set FLUTTER_VERSION in Xcode Cloud env (e.g. 3.44.1)}"
echo "=== Installing Flutter ($FLUTTER_VERSION) ==="
git clone https://github.com/flutter/flutter.git --depth 1 -b "$FLUTTER_VERSION" "$HOME/flutter"
export PATH="$HOME/flutter/bin:$PATH"
flutter --version

# --- 2. Generate the Flutter iOS artifacts -------------------------------------
echo "=== Preparing the Flutter iOS build ==="
cd "$CI_PRIMARY_REPOSITORY_PATH/${FLUTTER_PROJECT_PATH:-.}"

flutter precache --ios
flutter pub get

# `flutter build ios --no-codesign` generates ios/Flutter/Generated.xcconfig,
# the App.framework / Flutter.framework, the plugin registrant, and runs
# `pod install` — everything Xcode Cloud's subsequent xcodebuild needs.
# Pass your own --dart-define values here (example below).
flutter build ios --release --no-codesign \
  ${API_BASE_URL:+--dart-define=API_BASE_URL="$API_BASE_URL"}

# --- 3. (Optional) Wire FCM push from a secret ---------------------------------
# GoogleService-Info.plist is environment-specific and usually gitignored. Supply
# it to CI as the base64 Xcode Cloud secret GOOGLE_SERVICE_INFO_PLIST_B64; this
# materializes it, sets the production APNs entitlement (distribution build), and
# adds it to the Runner target. Without the secret, the app builds with push
# disabled. Runs AFTER `flutter build` so Flutter's regen can't clobber it.
# See docs/GOTCHAS.md #6.
if [ -n "$GOOGLE_SERVICE_INFO_PLIST_B64" ]; then
  echo "=== Wiring FCM push (GoogleService-Info.plist provided) ==="
  echo "$GOOGLE_SERVICE_INFO_PLIST_B64" | base64 --decode > ios/Runner/GoogleService-Info.plist
  /usr/libexec/PlistBuddy -c "Set :aps-environment production" ios/Runner/Runner.entitlements
  export GEM_HOME="$HOME/.gem"
  export PATH="$GEM_HOME/bin:$PATH"
  gem install xcodeproj --no-document
  ruby ios/ci_scripts/wire_firebase.rb
else
  echo "=== GOOGLE_SERVICE_INFO_PLIST_B64 not set — building with push disabled ==="
fi

echo "=== Flutter setup complete ==="
exit 0