Google is committed to advancing racial equity for Black communities. See how.

Quickstart for ARCore Extensions for Android

Get started with building your Android 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

Using ARCore Extensions for AR Foundation to build for Android requires the following hardware and software.

Hardware

Software

Create a new project and install the ARCore Extensions package

  1. Download the latest arcore-unity-extensions-*.tgz from the GitHub releases page.

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

  3. Import ARCore Extensions into your project:

    1. Open the Package Manager (choose Window > Package Manager).

    2. In the top left corner of the Package Manager, click the + (plus) button. Choose Add package from tarball…

      Add package from tarball… in Unity Package Manager

    3. Locate the downloaded arcore-unity-extensions-*.tgz tarball, then click Open.

    4. Wait a moment while Unity installs this and dependent packages into your project.

Configure project settings

  1. Switch the build Platform to Android:
    • Go to File > Build Settings to open the Build Settings window.
    • Select Android and click Switch Platform.
  2. Update the project's Player Settings:
    • Go to File > Build Settings to open the Build Settings window.
    • Click Player Settings.
    • Apply the following changes:
      Player Settings > … Value
      Other Settings If you are using AR Foundation 2.1 or 3.1, uncheck Multithreaded Rendering, to avoid known rendering issues (arfoundation-samples issue 652).
      Other Settings > Rendering Uncheck Auto Graphics API
      If Vulkan is listed under Graphics APIs, remove it as Vulkan is not yet supported by ARCore.
      Other Settings > Package Name Create a unique app ID using a Java package name format.
      For example, use: com.example.helloAR
      Other Settings > Minimum API Level If you are building an AR Required app, specify Android 7.0 'Nougat' (API Level 24) or higher.
      If you are building an AR Optional app, specify Android API Level 14 or higher.
      Other Settings > Scripting Backend Select IL2CPP instead of Mono to allow ARM64 support to be enabled in the next step.
      Other Settings > Target Architectures To meet the Google Play 64-bit requirement, enable ARM64 (64-bit ARM). Leave ARMv7 (32-bit ARM) enabled to support 32-bit devices.
  3. Enable Android XR Plugin support:
    • Go to Edit > Project Settings and select XR Plug-in Management.
    • Select Android and click ARCore under the Plug-in Providers table.
  4. Configure the desired ARCore settings:
    • Go to Edit > Project Settings and select XR Plug-in Management > ARCore.
    • Specify whether your app is AR Required or AR Optional. See Enable ARCore for more information.
    • Specify whether your app considers Depth API support to be required or optional. See the Depth API developer guide for more information.

Next Steps