Skip to content

iOS Signing Configuration

To publish your iOS app on the App Store, you need:

  • Apple Developer account ($99/year)
  • Signing certificate
  • Provisioning profile
  • Xcode for building and archiving
  • macOS (required for iOS development)
  • Xcode installed from App Store
  • Apple Developer Program membership ($99/year)
  • Physical iOS device (for testing) or iOS Simulator
Terminal window
open ios/Runner.xcworkspace
  1. In Xcode, select the Runner project in the navigator
  2. Select the Runner target
  3. Go to the Signing & Capabilities tab
  4. Check “Automatically manage signing”
  5. Select your Team from the dropdown

Ensure your Bundle Identifier matches your app:

  1. In Signing & Capabilities, check Bundle Identifier
  2. It should be in format: com.baselyr.yourapp
  3. Change if needed (must be unique across all apps)
  1. Select a physical device or “Any iOS Device” from the scheme dropdown
  2. Go to Product → Archive
  3. Once archived, the Organizer window opens
  4. Click Distribute App
  5. Select App Store Connect
  6. Follow the prompts to upload

Before building, ensure CocoaPods dependencies are installed:

Terminal window
cd ios && pod install && cd ..

If you don’t have CocoaPods installed:

Terminal window
sudo gem install cocoapods

From the project root:

Terminal window
flutter build ios --release

Then open Xcode to archive:

Terminal window
open ios/Runner.xcworkspace

Solution:

  1. Ensure you’re enrolled in Apple Developer Program
  2. In Xcode → Preferences → Accounts, add your Apple ID
  3. Download manual profiles if needed

Solution: Each app needs a unique bundle ID. Change it to something like com.baselyr.yourapp.unique

”Provisioning profile doesn’t match”

Section titled “”Provisioning profile doesn’t match””

Solution:

  1. Uncheck “Automatically manage signing”
  2. Check it again to regenerate profiles
  3. Or manually download profiles from Apple Developer Portal