ARCore Developer Preview 2 is now available. See the blog post for more information.

Getting Started with Java

Set up your development environment

Prepare your device

You must use a supported, physical device. ARCore does not support virtual devices such as the Android Emulator. To prepare your device:

Open the sample project

In Android Studio, open the HelloAR sample project in <ARCore SDK Folder>/samples/hello_ar_java.

The sample project has build dependencies on certain versions of software, such as Gradle and the Android SDK. If the required dependencies are not installed, Android Studio will ask you for permission to download and install them on your machine.

Run the sample

Make sure your Android device is connected to the development machine and click Run in Android Studio. Then, choose your device as the deployment target and click OK.

Android Studio builds your project into a debuggable APK, installs the APK, and then runs the app on your device. For more information, see Build and Run Your App.

As you move your device, the app automatically detects flat surfaces and draws a diamond grid. Tap the grid to place an Android robot on the surface.

Next steps

Read the code and comments in the sample app, as well as the Java API Reference.

After that, you can integrate the ARCore AAR Library into your existing project by adding it as a dependency. Your app's minSDKVersion must be 19 or higher.

Send feedback about...