UserGuide

Xcode Setup

From Xojo Documentation

Because Apple only provides some necessary iOS development components as part of Xcode, you will have to install Xcode in order for Xojo to be able to run and build iOS apps. You will not have to use Xcode to do any development.

These are the parts of Xcode that are used by Xojo:

  • Xcode Preferences are used to install iOS certificates on macOS.
  • Xcode Devices and Simulators window is used to transfer your Xojo-build iOS apps to devices for testing.
  • Xcode iOS Simulator is used to run Xojo iOS apps in the debugger. Note that Xojo will start the iOS Simulator for you automatically.

Download and Install Xcode

You can download and install Xcode from the Mac App Store.

After installing Xcode you'll need to run it so that it installs necessary iOS development components that are used for building and code-signing.

In some cases you may also need to go to the Xcode Preferences, select the Locations tab and choose "Xcode 9" for the Command Line Tools setting.

About Xcode 10

Xcode 10 is not supported in Xojo 2018r2 or earlier. For 2018r2 you will need to have Xcode 9. If you have upgraded to Xcode 10, you will have to re-install Xcode 9 so that you have both Xcode 9 and Xcode 10 installed at the same time. You can download Xcode 9 by logging into your Apple Developer Account. once you are logged in, click "Downloads" and scroll down to "See More Downloads" and click. In the resulting list you can find Xcode 9.4.1 to download and re-install.

After installing Xcode 9.4.1 and running it once to let it re-install necessary components you may also need to go to the Xcode Preferences, select the Locations tab and choose "Xcode 9.4.1" for the Command Line Tools setting.

About Xcode 9

Xcode 9 is supported starting with 2017r3 for testing and running in the iOS Simulator. 2018r1 or later is needed to build with Xcode 9 for device or App Store.

fa-info-circle-32.png
As of 2018, Apple requires App Store submissions to be built using the iOS 11 SDK included with Xcode 9. You will need Xojo 2018r1 or later with Xcode 9 installed in order to build your apps using the iOS 11 SDK and submit them to the App Store.

For earlier versions of Xojo, if you have installed Xcode 9 and replaced Xcode 8, you will need to download and re-install Xcode 8 so that you have both Xcode 9 and Xcode 8 installed at the same time. You can download Xcode 8 by logging into your Apple Developer Account. Once you are logged in, click "Downloads" and then scroll down to "See More Downloads" and click it. In the resulting list you can find Xcode 8.3.3 to download and re-install.

After installing Xcode 8.3.3 and running it once to let it reinstall necessary components you may also need to go to the Xcode Preferences, select the Locations tab and choose "Xcode 8.3.3" for the Command Line Tools setting.

Run and Building iOS apps

When you run apps from Xojo, your app is started in the iOS Simulator. To learn more about the iOS Simulator and how you use it with Xojo, refer to the iOS Simulator topic.

To build your apps so that you can copy them to devices for testing you will have to create iOS Development certificates and install related profiles. Refer to the Device Deployment topic for more information.

To submit your apps to the App Store to sell or distribute you will have to create iOS Deployment certificates and related profiles. Refer to Submitting to the App Store for more information.