Setting up your development environment
Build Unreal Engine 4.20 with the GoogleARCore plugin from source code by following these steps:
Gain access to Epic's GitHub repository.
Clone the google-ar-unreal repo with the following command:
git clone -b 4.20-arcore \ https://github.com/google-ar-unreal/UnrealEngine.git
Alternatively, developers with an existing Unreal Engine 4.20 repo can merge the
4.20-arcorebranch to their own branch with the following commands:
# Checkout your target branch, which must be based on Unreal 4.20 git checkout <target-branch> # Add google-ar-unreal as a remote git remote add google-ar-unreal https://github.com/google-ar-unreal/UnrealEngine.git # Fetch and merge the arcore branch git fetch google-ar-unreal 4.20-arcore git merge google-ar-unreal/4.20-arcore
- Make sure to choose your operating system in the first step.
- Prevent setup from overwriting the included Google ARCore binary files with the older files provided by Epic. Select
nwhen you see
Would you like to overwrite your changes (y/n)?.
Set up the Unreal editor for Android development by following the Android Quick Start. Make sure you install Android SDK Platform version 7.0 (API level 24) or higher.
You will need to get the Unreal HelloAR sample project. You can either:
Download the sample project repository and extract it.
Clone the repository with the following command:
git clone https://github.com/google-ar/arcore-unreal-sdk.git
You will need a supported Android device.
Prepare your device
To prepare your supported device, enable developer options and USB debugging.
Open the sample project
In Unreal Editor open the HelloAR sample project.
Set up Android development settings
In the menu bar, click Edit > Project Settings.
In Project Settings, under the Android SDK platform, make sure all the paths are set correctly to your Android SDK and Android NDK installations. Set the SDK API Level to 'matchndk'. Then set the NDK API Level to android-24 or higher.
Build and run the sample app
Package the HelloAR project. In the menu bar, select File > Package Project > Android > Android (ASTC).
A dialog box will appear. In that box, create a new folder called Builds and click Select.
Unreal begins packaging the project and displays the progress in the status window (lower right-hand corner). For details on the packaging process, see the Output Log window.
Once the project has been packaged, make sure your device is connected to your machine. Open the Builds folder and double-click the file
Install_HelloARUnreal_Development-armv7-es2.bat(if you are using Windows) or
Install_HelloARUnreal_Development-armv7-es2.command(if you are using Mac) file to install the project on your Android Smartphone.
After the install is completed, look for an app called HelloAR UE4 on your device and launch it.
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.
- 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.
- Target your apps to iOS or Android and use Cloud Anchors to create AR experiences that Android and iOS users can share. See the Quickstart for Cloud Anchors in Unreal to get started.
- Learn more about Unreal Hand Held AR platform development
- Review Runtime Considerations.
- Review Design Guidelines.