Table of Contents

Running EasyAR Android samples

This article describes how to run the native Android samples provided by EasyAR. Taking HelloAR as an example, it explains how to run the sample. Other samples can be referenced similarly.

Preparations

  • Before starting, ensure the following environment is prepared:

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

  • Download EasyAR Sense native samples and extract them

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

Import and compile the sample

  1. In Android Studio menu, select File -> New -> Import Project..., choose the sample directory to import, and wait for Android Studio to complete downloads and configurations. importhelloar

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

fillkey

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

buildandrun

HelloAR implements image recognition and tracking on planar surfaces, overlaying virtual objects. The sample recognition images can be found under assets/sightplus.

The running effect of the HelloAR sample is as follows.

rungif