Deep-Link Testing on a Physical Device
Open custom URL schemes, deep links, and Universal Links on a connected physical iPhone or iPad from RocketSim's Recent Builds side window.
RocketSim 16.4 lets you run saved deep links and Universal Links on a connected physical iPhone or iPad. Select a recent device build and trigger the same reusable App Actions you already use with the Simulator.
Requirements
Section titled “Requirements”- RocketSim 16.4 or later
- Xcode 27
- A paired iPhone or iPad connected over USB
- An app run on that device from Xcode
- A saved deeplink App Action matching the app’s bundle identifier
Open a deep link
Section titled “Open a deep link”- Configure the URL under RocketSim → Settings → App Actions.
- Run the matching app on your physical iPhone or iPad from Xcode.
- Focus the physical-device preview and open Recent Builds.
- Select the app and open the Deeplinks tab.
- Choose the URL you want to test.
RocketSim asks Xcode’s device-control service to open the URL on the selected physical iOS device. Custom URL schemes route to the installed app; Universal Links follow the association and routing rules configured by your app and website.
Reuse dynamic URLs
Section titled “Reuse dynamic URLs”Deep links with one placeholder continue to work on physical devices. For example:
stocks://analyze/{SYMBOL}When you trigger the action, RocketSim asks for the runtime value and substitutes it into the final URL. Recently used values remain available for repeating the same test.
Troubleshooting
Section titled “Troubleshooting”- Confirm the selected recent build has the same bundle identifier as the saved App Action.
- Run the app from Xcode again if it does not appear in Recent Builds.
- Test the final URL in Safari on the device to separate app-association issues from RocketSim execution.
- Universal Links can open the website when the associated-domains entitlement or
apple-app-site-associationfile is incorrect.
For creating and organizing URLs, see Deep Links & Universal Links.