Xcode will not run the app because the destination is build only
A build only device cannot be used to run this targetShort answer
Xcode shows this when the run destination in the toolbar is a placeholder it can build for but cannot launch on, such as Any iOS Device. Pick a simulator or a paired physical device. If none is listed, the scheme may not match the platform, or the platform support is not installed yet.
Fix it fast
1Find out which cause you have
List the destinations Xcode can run this scheme on. If your device or a simulator is missing here, it is missing from the toolbar too.
xcodebuild -scheme YourScheme -showdestinations2Match what you see, then jump to its fix
- 1
The toolbar shows Any iOS Device (or similar) as the run destination.A generic destination is selected instead of a simulator or deviceFix - 2
Your iPhone or simulator is missing from the menu, but other devices show.The scheme does not match the platform you want to runFix - 3
A Get button sits next to the Any [Platform] Device destination.Platform support is not installedFix
- 1
What does the error look like?
A build only device cannot be used to run this targetAny iOS Device
Cause 1 of 3
A generic destination is selected instead of a simulator or device
1Check
Apple's guide says to choose a simulated or physical device from the run destination menu before you click Run. A generic destination is for building, not launching.
xcrun simctl list devices available2Fix
Open the run destination menu in the toolbar and choose an iPhone simulator, or a physical device that you paired in Device Hub.
# Toolbar: scheme menu > run destination menu > pick a simulator or your device
# command line equivalent for a simulator:
xcodebuild -scheme YourScheme -destination 'platform=iOS Simulator,name=iPhone 17' build3Verify
Product > Run launches the app on the chosen device.
xcrun simctl list devices bootedConfirmed by developer.apple.com
Cause 2 of 3
The scheme does not match the platform you want to run
1Check
Xcode fills the run destination menu from the selected scheme. A scheme that contains only a watchOS app lists only watchOS devices, for example.
xcodebuild -list2Fix
Choose the scheme whose target is your iOS app, then open the run destination menu again.
# Toolbar: scheme pop-up (left of the run destination) > pick the iOS app scheme
xcodebuild -scheme YourIOSAppScheme -showdestinations3Verify
The iPhone or simulator you expect now appears in the destination list.
xcodebuild -scheme YourIOSAppScheme -showdestinations | grep -i iphoneConfirmed by developer.apple.com
Cause 3 of 3
Platform support is not installed
1Check
Without platform support for the target, Xcode cannot build and run on a device. The Components settings pane lists what is installed.
xcodebuild -showsdks2Fix
Click Get next to the destination, or install the platform in Xcode > Settings > Components. From the terminal you can download a platform's simulator runtime.
xcodebuild -downloadPlatform iOS3Verify
After the download finishes, the run destination menu lists simulators for the platform.
xcrun simctl list runtimesConfirmed by developer.apple.com
How do I stop it coming back?
- Pick a concrete simulator or device before you press Run; keep generic destinations for archiving.
- Name your schemes after the platform so the right one is easy to spot.
- Install the platform support you need right after each Xcode update.
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?
Related fixes
Mobile apps
Cannot change the App Privacy answers in App Store Connect
Publish Your App Privacy Responses?
Only the Account Holder, Admin and App Manager roles can answer the App Privacy questions.
2 causes, each with a fixMobile apps
App record creation fails because you lack permission
You cannot add a new app in App Store Connect as a Developer or limited user
Only the Account Holder, an Admin or an App Manager can create an app record, and Apple blocks it until the Account Holder has signed the latest agreement.
3 causes, each with a fixMobile apps
You cannot find the button to pull your app back from review
No 'remove this version from review' message appears on the version page
There is no button called Reject Binary.
3 causes, each with a fixMobile apps
Your Apple Account cannot sign in to App Store Connect
Sign-in to App Store Connect is refused for an account that should have access
App Store Connect does not open to every Apple Account.
3 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
App Store Connect rejects a screenshot because it has transparency
Images can't include alpha channels or transparencies.
App Store Connect does not accept screenshots that carry an alpha channel or transparent pixels.
2 causes, each with a fix