Table of Contents

Run EasyAR Android Samples

This article explains how to run the native Android samples provided by EasyAR. Here, we use HelloAR as an example to demonstrate how to run the sample. Other samples can be used by referring to this article.

Preparation

  • Before starting, ensure the following environment is prepared:

    • Android Studio 2025.1.2 or later
    • JDK 17
    • Android NDK r28
    • An Android phone

  • Download the EasyAR Sense native samples and extract them

  • Obtain a License Key from the EasyAR Developer Center (Chinese site / English site). Note that the package name should match the sample, e.g., HelloAR should be cn.easyar.samples.helloar

Import and compile the sample

  1. In Android Studio, go to File -> New -> Import Project..., select the sample directory to import, and wait for Android Studio to complete the download and configuration.
    importhelloar

  2. Set the license (License Key)
    Locate ARActivity.java and fill in the License Key obtained from the Developer Center as prompted in the code.

fillkey

  1. Compile and run
    Connect your phone to the computer, click the run button, and follow the prompts to run it on your phone.

buildandrun

HelloAR implements the functionality of recognizing and tracking planar images and overlaying virtual objects. The recognition images in the sample can be found in the assets/sightplus directory.

The running effect of the HelloAR sample is as follows.

rungif