How to Run and Test Your App on a Real iPhone from Xcode
Updated: October 2026
To test your iOS app on a real iPhone, connect the phone to your Mac, select it as the run destination in Xcode, turn on Developer Mode on the iPhone, and trust your developer account. You do not need a paid developer account just to run your own app on your own device, but some features and longer-lasting installs need one.
What you need
- A Mac with Xcode installed
- An iPhone and a cable (or a wireless connection already set up in Xcode)
- An Apple ID signed in to Xcode
- An iPhone with an iOS version your project supports
Step 1: Sign in and set your team
In Xcode, add your Apple ID in the account settings. Then open your project, go to Signing and Capabilities, and choose your team. Let Xcode manage signing automatically if you are not sure.
Step 2: Connect your iPhone
Plug the iPhone into your Mac and unlock it. If the phone asks “Trust this computer?”, tap Trust. Your iPhone should appear in the device list at the top of Xcode.
Step 3: Turn on Developer Mode
On newer iOS versions, you must enable Developer Mode on the iPhone. It is in Settings, under Privacy and Security. The phone will restart and ask you to confirm. Without this, the app will not open.
Step 4: Run the app
Select your iPhone as the destination and press Run. Xcode builds the app and installs it on the phone.
Step 5: Trust the developer profile
If the app does not open and shows an “Untrusted Developer” message, go to Settings, then General, then VPN and Device Management. Choose your developer profile and tap Trust.
Free account vs paid account
- Free Apple ID: you can run your own app on your own device, but the install expires after a short time (about a week) and some capabilities are limited.
- Apple Developer Program: needed for TestFlight, App Store release and many capabilities such as push notifications.
Check Apple’s current rules, as these limits can change.
Checklist: what to test once it runs
- A fresh install (delete the app first, then reinstall)
- First launch and onboarding
- Every screen, button and form
- Camera, photos, location and notifications, allowed and denied
- Wi-Fi, mobile data and no connection
- Locking the phone and returning to the app
- A long session of normal use
Common problems
The iPhone does not appear in Xcode. Unlock it, accept the trust prompt, try another cable, and restart Xcode.
“Developer Mode required.” Turn it on in Settings and restart the phone.
Signing errors. Check that the bundle ID is unique and your team is selected.
The limit of testing only your own app on your own phone
You will always follow the path you know. A person who has never seen the app will tap in a different order and find different problems. For that, RealAppTest tests your build by hand on a real iPhone and sends you a detailed report.
Frequently asked questions
Can I test wirelessly?
Yes, Xcode can connect to a device over the network after the first cable setup.
Do I need the newest iPhone?
No, but an older or smaller device is a good test for performance and layout.