Version 1.2 of the ARCore SDK, as announced at Google I/O 2018, is now available. See the blog post for more information.

Quickstart for iOS

Get started with targeting your ARCore Unity apps to iOS.

ARCore 1.2 includes iOS build support and cloud anchor capabilities, letting you create AR apps that iOS and Android users can experience together.

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

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

Requirements

You'll need:

Hardware

  • An ARKit-compatible iPhone running iOS version 11 or later:

    • iPhone X
    • iPhone 8 and 8 Plus
    • iPhone 7 and 7 Plus
    • iPhone 6S and 6S Plus
    • iPhone SE
      Note: ARCore 1.2 does not support targeting iPads.
  • A USB cable to connect your phone to your development machine

Software

Get the ARCore SDK for Unity

  1. Download the latest arcore-unity-sdk-v*.unitypackage from the releases page.

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-v*.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 from Unity's repository.
  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 *.xcworkspace workspace file in Xcode.
    To avoid build errors, do not build or launch from the included *.xcodeproj project file.

  3. In Xcode, select the Unity-iPhone project in the left pane, connect your phone, and launch your app.

Next steps

Send feedback about...