Quickstart for iOS

Get started with targeting your ARCore Unity apps to iOS.

ARCore SDK for Unity iOS support

The ARCore SDK for Unity lets you create AR experiences that Android and iOS users can share. The latest version of the SDK includes iOS build support for the ARCore Cloud Anchor API and a Cloud Anchors sample app.

Unity SDK platform support
The samples included in the ARCore SDK for Unity have the following build support limitations:

Sample Android support iOS support How to try the sample
HelloAR Yes No Follow the steps in the Unity Quickstart for Android to target Android.
ComputerVision Yes No Follow the steps in the Unity Quickstart for Android to target Android.
AugmentedImages Yes No Follow the steps in the Unity Quickstart for Android to target Android.
CloudAnchor Yes Yes

Get started with targeting iOS in Unity

This guide shows you:

  • Hardware and software requirements for targeting iOS
  • How to set up your development environment
  • How to build and launch your own ARCore Unity iOS app

Requirements

You'll need:

Hardware

  • ARKit compatiable device that is also supported by ARCore

  • A USB cable to connect your device to your development machine

Software

Get the ARCore SDK for Unity

  1. Download ARCore SDK for Unity 1.4.0 or later.
    The SDK is downloaded as file called arcore-unity-sdk-v1.4.0.unitypackage.

Create a new project and import the SDK

  1. Open Unity and create a new 3D project.

  2. Select Assets > Import Package > Custom Package.

  3. Select the arcore-unity-sdk-v1.4.0.unitypackage file that you downloaded.

  4. In the Importing Package dialog, make sure that all package options are selected and click Import.

  5. Accept any API upgrades if prompted.

Include the ARKit SDK for Unity

  1. Download the latest Unity-ARKit-Plugin 1.5 or later.
  2. Add the UnityARKitPlugin folder into the Assets folder of your project.

Configure build and platform settings

  1. Select File > Build Settings.
  2. Select iOS and click Switch Platform.
  3. In the Build Settings window, click Player Settings.
  4. In the Inspector window, open the Other Settings menu.
  5. Configure the following settings:
    Setting Value
    Player Settings > Other Settings > Bundle Identifier Add your app's name in a reverse DNS format.
    For example, use com.mycompany.myapp
    Player Settings > Other Settings > Camera usage description Enter a description to explain your use of AR.
    Player Settings > Other Settings > Target minimum iOS version 11.0 or higher
    Player Settings > Other Settings > Architecture ARM64

Build and launch the app

Your development environment is now configured for targeting iOS with the ARCore SDK for Unity.

To build and try out the iOS sample included in the ARCore SDK for Unity, see the Quickstart for Cloud Anchors in Unity for iOS.

You can use the following steps for building and launching your own ARCore apps targeting iOS.

Build for iOS

  1. In Unity, click Build and select an output folder for your iOS Xcode project. An Xcode project is generated.

  2. Locate and open the generated Unity-iPhone.xcworkspace workspace file in Xcode.
    To avoid build errors, do not build or launch from the included Unity-iPhone.xcodeproj project file.

  3. In Xcode, select the Unity iOS project in the left pane, connect your device, and launch your app.

Next steps

Send feedback about...