Get started with building your iOS apps using AR Foundation.
About AR Foundation
AR Foundation is Unity's high-level, cross platform API to support Augmented Reality. AR Foundation lets you write your app once, and build for either Android or iOS.
Requirements
Hardware
ARKit compatible device that is also supported by ARCore.
A USB cable to connect your device to your development machine.
Software
Unity 2019.4.3f1 or later with iOS Build Support
The following Unity packages will be installed automatically by the Unity Package Manager dependency management system when you install the ARCore Extensions package in the next step:
AR Foundation 4.1.0-preview.10 or later
ARKit XR Plugin 4.1.0-preview.10 or later
You may encounter compatibility issues if you do not use these versions
Create a new project and install the ARCore Extensions package
Download the latest
arcore-unity-extensions-*.tgz
from the GitHub releases page.Open Unity and create a new 3D project.
Import ARCore Extensions into your project:
Open the Package Manager (choose Window > Package Manager).
In the top left corner of the Package Manager, click the + (plus) button. Choose Add package from tarball…
Locate the downloaded
arcore-unity-extensions-*.tgz
tarball, then click Open.Wait a moment while Unity installs this and dependent packages into your project.
Choose Window > Package Manager, and install ARKit XR Plugin package version 4.1.0-preview.10 or later (required for building iOS apps).
When upgrading your project from an earlier version of Unity to Unity 2019.1 or later, verify the following setting:
Setting Value Player Settings > Other Settings > Script Runtime Version .Net 4.x Equivalent or higher
Configure project settings
- Select File > Build Settings.
- Select iOS and click Switch Platform.
- In the Build Settings window, click Player Settings.
- In the Inspector window, open the Other Settings menu.
- Configure the following settings:
Setting Value Player Settings > Other Settings > Bundle Identifier Add your app's name in a reverse DNS format.
For example, usecom.mycompany.myapp
Player Settings > Other Settings > Camera usage description Enter a description to explain your use of AR (for example, ARKit). Player Settings > Other Settings > Target minimum iOS version 11.0 or higher Player Settings > Other Settings > Architecture ARM64
- Go to Edit > Project Settings and click XR Plug-in Management.
- Select ios and click ARKit under the Plug-in Providers table.
Build and launch the app
Your development environment is now configured for targeting iOS for ARCore Extensions for AR Foundation.
You can use the following steps for building and launching your own ARCore apps targeting iOS.
Build for iOS
In Unity, click Build and select an output folder for your iOS Xcode project. An Xcode project is generated.
Locate and open the generated
Unity-iPhone.xcworkspace
workspace file in Xcode.In Xcode, select the Unity iOS project in the left pane, connect your device, and launch your app.
Next steps
- Review Runtime Considerations.
- Review Design Guidelines.
- Review Cloud Anchors developer guide for ARCore Extensions.