Simulator and physical iPhone setup

Run the iOS version on a Mac with a compatible Xcode and Flutter installation. Configure the iOS bundle identifier and Firebase registration before testing.

Prepare the project

  1. Run flutter pub get from the project root.
  2. Open ios/Runner.xcworkspace in Xcode.
  3. Select the Runner target and verify its bundle identifier.
  4. For physical-device testing, select your development team and resolve signing requirements.
  5. Configure Firebase and push capabilities as described in Configuring Firebase for iOS.

Start a simulator or connect an iPhone, then run:

flutter devices
flutter run -d DEVICE_ID

Choose the device ID from the first command. Follow any device trust or developer-mode prompts shown by macOS, Xcode, or the iPhone.

Verify the app

Check startup, customer login, document viewing, and keyboard behavior. Use a physical iPhone for final push-notification and signing checks. Confirm that the phone can reach your CRM’s HTTPS address.

Do not lower platform deployment requirements simply to suppress a dependency error. Native Firebase and Flutter plugin requirements must agree with the selected deployment target.

The repository’s iOS project settings alone do not prove that every supported iOS device has been tested. Before distribution, build and test the actual release archive using the Flutter iOS deployment workflow.

Write Your Comment