iOS Release Build (Apple App Store)
Configure Xcode signing certificates, capabilities, APNs push key, and archive the Customer application for TestFlight and App Store Connect.
To compile the iOS application, you require a Mac running macOS, the latest version of Xcode, CocoaPods, and an active Apple Developer Program membership.
1. Install CocoaPods and open Runner workspace
cd customer
flutter pub get
cd ios
pod install
Always open customer/ios/Runner.xcworkspace (never .xcodeproj).
2. Configure Team Signing & Bundle Identifier
In Xcode, click Runner in the left pane → select target Runner → Signing & Capabilities. Tick Automatically manage signing, select your Apple Developer Team, and confirm your Bundle Identifier matches the iOS app in your Firebase project.
3. Verify Required Capabilities
| Capability | Status | Purpose in BookMyStay |
|---|---|---|
| Push Notifications | Required | Delivering check-in, room confirmation, and reservation alerts |
| Background Modes → Remote notifications | Required | Processing background booking data messages |
| Background Modes → Background fetch | Required | Maintaining up-to-date reservation status |
4. Upload the Apple Push Key (APNs) to Firebase
In your Apple Developer Portal, navigate to Certificates, Identifiers & Profiles → Keys → (+). Select Apple Push Notifications service (APNs), click Continue, and download your .p8 auth key file.
Open Firebase consoleProject SettingsCloud Messaging. Under Apple app configuration, select your Customer iOS app and upload the .p8 file alongside your Key ID and Team ID.
5. Build and upload to App Store Connect
cd customer
flutter build ipa --release
Upload the generated customer/build/ios/ipa/*.ipa file using the Apple Transporter application or via Xcode → Product → Archive → Distribute App. Distribute to internal testers through TestFlight before submitting for App Store Review.