flutter run says: Could not run Runner.app, try Xcode Product > Run
Could not run build/ios/iphoneos/Runner.app on <device id>.Short answer
Flutter prints this when installing or launching the built app on the iPhone fails, and it hides the real reason. Open ios/Runner.xcworkspace and press Product > Run in Xcode to see the actual error. The usual causes are Developer Mode off, a phone that does not trust the Mac, missing signing, or an untrusted certificate.
Fix it fast
1Find out which cause you have
Do what the message says. Open the workspace in Xcode, pick your iPhone and press Product > Run. Xcode shows the real error, which tells you which cause applies.
open ios/Runner.xcworkspace2Match what you see, then jump to its fix
- 1
The Developer Mode switch is off, or the entry is missing in Settings > Privacy & SecurityDeveloper Mode is off on the iPhoneFix - 2
The Trust this computer prompt on the phone was never answeredThe phone has not trusted this MacFix - 3
Xcode shows a signing error when you press Product > RunThe app is not signed with a development certificateFix - 4
The certificate is not yet enabled under VPN & Device Management on the phoneThe developer certificate is not trusted on the phoneFix
- 1
What does the error look like?
Could not run build/ios/iphoneos/Runner.app on <device id>.Try launching Xcode and selecting "Product > Run" to fix the problem:open ios/Runner.xcworkspace
Cause 1 of 4
Developer Mode is off on the iPhone
1Check
On the phone, open Settings > Privacy & Security and look for Developer Mode. If the entry is not there, connect the phone, unlock it and trust the computer first.
flutter devices2Fix
Turn Developer Mode on, restart the phone, then confirm Turn On when it asks. If the option is hidden, run flutter run or open Xcode once so it prepares the device.
flutter run -d <device_id>3Verify
The phone appears in the device list and the app launches.
flutter devicesConfirmed by docs.flutter.dev
Cause 2 of 4
The phone has not trusted this Mac
1Check
On first connection the phone shows Trust this computer. Unlock the phone and look for the prompt.
flutter devices2Fix
Unplug, unlock the phone, reconnect and tap Trust.
flutter doctor -v3Verify
flutter devices lists the iPhone as a connected device.
flutter devicesConfirmed by docs.flutter.dev
Cause 3 of 4
The app is not signed with a development certificate
1Check
Flutter's setup guide says a signed developer certificate is needed even for testing. A free personal Apple developer account is enough for that.
open ios/Runner.xcworkspace2Fix
Sign in with your Apple ID in Xcode and set up signing for the Runner target as the iOS setup guide describes, then run again.
flutter run -d <device_id>3Verify
The build installs on the phone.
flutter run -d <device_id>Confirmed by docs.flutter.dev
Cause 4 of 4
The developer certificate is not trusted on the phone
1Check
Open Settings > VPN & Device Management on the phone and look under Developer App.
# on the iPhone: Settings > VPN & Device Management2Fix
Tap your certificate there, then tap Trust and confirm. If the menu is missing, run the app on the device once and look again.
flutter run -d <device_id>3Verify
The app opens on the phone.
flutter run -d <device_id>Confirmed by docs.flutter.dev
How do I stop it coming back?
- Keep the Mac and phone connected and unlocked for the first run after an iOS update.
- On a new device, connect it, unlock it and trust the Mac, then run once from Xcode or flutter run so the device is prepared.
- Read Xcode's error, not Flutter's summary line, when an install fails.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Projects of mine built on the same technologies:
- TaxiDexMy own multi-tenant taxi dispatch SaaS: API, dispatcher portal, driver and passenger apps, and the servers underneath.
- Dispatch ProA real-time logistics platform: Flutter apps, Spring Boot services and a Kafka event pipeline on AWS.
- Qist BazaarA buy-now-pay-later marketplace built from a blank repo, now past 100K downloads on Google Play.
Related fixes
Mobile apps
Flutter debug app installs on an iPhone or iPad but the Dart VM never starts
EXC_BAD_ACCESS (SIGKILL - CODESIGNING)
On iOS 14 and later a debug build needs the Local Network permission for the Dart VM service, and it can only be started by Flutter tooling or Xcode, not by tapping its icon.
4 causes, each with a fixMobile apps
Apple rejected the app under Guideline 4.3, Design: Spam
Guideline 4.3(b) - Design - Spam
Guideline 4.3 is Apple's duplicate rule.
5 causes, each with a fixMobile apps
pod install cannot pick a version of a pod that satisfies every requirement
Specs satisfying the `FirebaseAuth (~> 11.0)` dependency were found, but they required a higher minimum deployment target.
CocoaPods tried every version of the named pod and none fit all requirements.
4 causes, each with a fixMobile apps
flutter doctor says CocoaPods is installed but not working
You appear to have CocoaPods installed but it is not working.
Flutter runs pod --version and treats a failed or unreadable result as a broken install.
3 causes, each with a fixMobile apps
flutter run on iOS or macOS stops with Error running pod install
Warning: CocoaPods not installed. Skipping pod install.
Flutter only reports that pod install failed; the reason is in the lines just above it.
5 causes, each with a fixMobile apps
FirebaseMessaging.getAPNSToken() returns null on iOS
FirebaseMessaging.instance.getAPNSToken() returns null
getAPNSToken() gives null when iOS has not handed the app an APNs token yet or never will.
4 causes, each with a fix