Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rork.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Why do you need Xcode?

Xcode is great because it helps you track logs and look more in-depth at why your app may or may not work. It also allows one-click submission to the App Store and is very efficient due to its being an Apple product.
Requirements
  • Mac OS computer
  • Connected to GitHub
  • GitHub desktop app installed
  • Xcode app installed
  • VSCode installed
  • Apple Developer Account

​
Installing Xcode

Download Xcode from the App Store Image

​
Opening your Rork project in Xcode

Connect to GitHub Image Go to GitHub Image Open with GitHub Desktop Image Right-click the name of your app and open it in VS Code: Image Now you’ll need to set up your environment If you’re using Rork Max, just type: 
Xed .
If not:
Install Homebrew (if not installed) 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install Node.js (includes npm) 
brew install node
Verify: 
node -v
npm -v
Install Yarn 
npm install -g yarn
Verify: 
yarn -v
Install Expo CLI 
npm install -g expo
Verify: 
npx expo --version
Install Xcode Command Line Tools 
xcode-select --install
Accept license: 
sudo xcodebuild -license accept
Install CocoaPods 
sudo gem install cocoapods
Verify: 
pod --version
Install Project Dependencies From project root: 
yarn
Run iOS Prebuild and Open Xcode 
yarn && npx expo prebuild -p ios && xed ios
After this, your project should open up in Xcode.

​
Here are some issues you may run into and how to solve them:

If iOS Folder Already Exists 
npx expo prebuild -p ios --clean
If Dependencies or Pods Break 
rm -rf node_modules ios
yarn
npx expo prebuild -p ios
If CocoaPods Fail 
cd ios
pod deintegrate
pod install
cd ..

​
Final Requirement Check

node -v
npm -v
yarn -v
npx expo --version
pod --version

​
After your project is open in Xcode, publish to the App Store (via TestFlight)

Navigate to “Product” and click “Archive.” Image To test in the simulator: Hit the play button, and then go back to your VS Code terminal and run: yarn start

​
Troubleshooting:

Image Delete any .lock file, IOS, Android, or node_modules file. Then rerun the commands before.

Other commands to try:
  • Yarn install.
  • npm expo prebuild
  • Xed ios
  • npm expo start