Set up your development environment
Install Android Studio version 3.1 or higher with Android SDK Platform version 7.0 (API level 24) or higher.
You will need a basic understanding of Android development. If you are new to Android, see Building your first Android app for beginners.
Open the sample project
Get the sample project by cloning the repository with the following command:
git clone https://github.com/google-ar/arcore-android-sdk.git
In Android Studio, open the HelloAR sample project, located in the
samples subdirectory within the
Prepare your device or emulator
You can run AR apps on a supported device or in the Android Emulator:
- In the emulator, you must sign into the Google Play Store or update Google Play Services for AR manually.
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.
You may be prompted to install or update Google Play Services for AR if it is missing or out of date. Select CONTINUE to install it from Google Play Store.
The HelloAR app lets you place and manipulate Android figurines on detected AR plane surfaces. It is implemented with Android GL SurfaceView, which is used to render the camera preview and basic AR objects such as Planes and Anchors. HelloAR's render can be found here.
- Try building and running other sample projects in the ARCore SDK.
- Learn how to Enable ARCore in your app.
- Use Augmented Images to build apps that can respond to 2D images, such as posters or logos, in the user's environment.
- Use Cloud Anchors to create shared AR experiences across iOS and Android users.
- Review the Runtime Considerations.
- Review the Design Guidelines.