# XREAL Air 2 Ultra

These screenshots show the Unity 6 and device settings required to successfully deploy and launch apps on the XREAL Air 2 Ultra.

## Settings & Permissions in Unity

#### 1. Build Profiles > Android > XREAL Profile > Scene List & Scripting Defines

Ensure that you have a Build Profile targeting XREAL with the correct scene list and scripting defines.

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FLYuv95oRH1CkUVfLaFzj%2Fxreal-buildprofile-scenelist.png?alt=media&#x26;token=daf1ae0b-d096-45a7-9376-687387f105f0" alt=""><figcaption></figcaption></figure>

#### 2. Build Profiles > Android > XREAL Profile > Other Settings

Make sure the OpenGLES3 Graphics API, ASTC texture compression format, package name, version, IL2CPP scripting backend, new input system, ARM64 target architecture, external write permission, and application entry point are set correctly.

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FwCvMvgdV4XG51yKnjeq6%2Fxreal-buildprofile-othersettings1.png?alt=media&#x26;token=f34f796d-a756-4fc7-bae5-1ea0b6527ab4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2F0nzz09eTpElzIiHepKxp%2Fxreal-buildprofile-othersettings2.png?alt=media&#x26;token=456a961a-311d-4439-b4cd-c4f2724bed4d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FsVOnZNaJNJdUCHmHv4Zy%2Fxreal-buildprofile-othersettings3.png?alt=media&#x26;token=af292189-fff3-4ee4-8e17-eb23748bf397" alt=""><figcaption></figcaption></figure>

#### 3. Build Profiles > Android > ML2 Profile > Publishing Settings&#x20;

Make sure the custom main manifest, custom main Gradle template, and custom launcher Gradle template are all correctly assigned.

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FA0dOxyeTxSfcLwAVzAmj%2Fbuildprofile-buildsettings.png?alt=media&#x26;token=bea41090-d919-4fa2-bbfe-038200ca180e" alt=""><figcaption></figcaption></figure>

#### 4. Project Settings > XR Plug-in Management

Enable the XREAL Plugin, and disable the OpenXR Plugin and any feature groups.

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FVMN6SETNdZvB8j25LkqX%2Fxreal-xrpluginmanagement.png?alt=media&#x26;token=e712afbb-d6ae-46af-a032-c97aef7da67b" alt=""><figcaption></figcaption></figure>

#### 5. Project Settings > XR Plug-in Management > OpenXR > Enabled Interaction Profiles & Feature Groups

Remove any unused interaction profiles, feature groups, and subsystems.

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FYgFCfsba9df1unEVOa2T%2Fxreal-openxrfeaturegroups.png?alt=media&#x26;token=0fe7d35e-b455-43ce-a0f4-e8d510de3a30" alt=""><figcaption></figcaption></figure>

#### 6. Project Settings > XR Plug-in Management > Project Validation

Review that all checks pass successfully.

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FHPuBvVKWan58Yc8xqY0H%2Fxreal-projectvalidation.png?alt=media&#x26;token=e7d8c6e1-1b6d-4ef3-814c-aa3e7e5da610" alt=""><figcaption></figcaption></figure>

#### 7. Project Settings > XR Plug-in Management > XREAL

Select the appropriate Tracking Type, Input Source, and Android permissions that you anticipate your app needing. Additional permissions may be required on the device, in the app permission settings.

<figure><img src="https://1186324960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWEOieFcrCdoaTX1LuCOI%2Fuploads%2FHl0gvvSwbqK76fEMQUWq%2Fxreal-xreal.png?alt=media&#x26;token=485a8222-b3c4-4fd6-b05d-b4ac4d3b89bc" alt=""><figcaption></figcaption></figure>

## Installing an App to XREAL Air 2 Ultra

1. To install an .apk to your XREAL Air 2 Ultra, you will need [adb platform-tools](https://developer.android.com/tools/adb) on your computer.
2. Enable [Developer options](https://developer.android.com/studio/debug/dev-options) on your Beam Pro or Samsung Galaxy S24 and connect it to your computer via USB-C.
3. Enable "Allow USB debugging" if prompted.
   1. Check "Always allow from this computer" to not receive this popup in the future.
4. Open the command line on your computer and use `adb install "path\to\your\app.apk"` to install the app to your device.
5. Connect your glasses to your Beam Pro or Samsung Galaxy 24 and launch the app through the My Glasses app's AR Mode.

## Settings & Permissions on Device

For each app you download, you have to enable *"Display over other apps"* on your Beam Pro or Samsung Galaxy 24 in `Settings > Apps > your-app`.

On your XREAL Air 2 Ultra, make sure to select *"6 DOF"* mode and enable *"hand tracking"* in the device settings.