Skip to main content
You can test your app in the Rork simulator, run it on your iPhone, and publish to the App Store through Rork without opening Xcode. Follow this guide only if you want to work with the exported Swift project on your own Mac.

​
When to use Xcode

Use Xcode when you or a developer want to step through the Swift code, debug on a connected device, or build and archive the app manually. Start by syncing your project with GitHub. Requirements
  • A Mac
  • Xcode installed
  • Your project connected to GitHub
  • GitHub Desktop installed (or git in the terminal)
  • An Apple Developer account

​
Installing Xcode

Download Xcode from the App Store Image Then install the command line tools and accept the license:

​
Opening your Rork project in Xcode

Rork iPhone apps are native Swift projects, so Xcode opens them directly. There is nothing to generate first. Connect to GitHub Image Go to GitHub Image Open with GitHub Desktop Image Now open a terminal in the project folder and run:
Your project opens in Xcode. If your project holds more than one app, run the command inside the iOS app folder. Xcode resolves the Swift packages your app uses on the first open. Wait for that to finish before you build.

​
Run the app

  • Simulator: pick a simulator in the toolbar and press the play button.
  • Your own iPhone: plug it in, select it in the toolbar, then press play. Your device needs Developer Mode, under Settings → Privacy & Security → Developer Mode.
Open the debug console at the bottom of the window to read the logs while the app runs.

​
Publish to the App Store (via TestFlight)

Navigate to “Product” and click “Archive.” Image When the archive finishes, the Organizer opens. Choose Distribute App, then App Store Connect, and your build appears in TestFlight.

​
Troubleshooting

The build fails right after opening the project. Xcode may still be resolving Swift packages. Wait for it to finish, then build again. A Swift package fails to resolve. In Xcode, choose File → Packages → Reset Package Caches, then build again. Stale build errors that make no sense. Clean the build folder with Product → Clean Build Folder (Shift + Command + K), then build again. Signing errors. Open the project settings, select the target, then Signing & Capabilities, and pick your Apple Developer team.