Android Management

Building for Android XR devices (Meta Quest, XREAL, etc.) requires careful handling of Android-specific files and plugin configurations. XRBuildKit automates this process, reducing manual errors and ensuring each build has the correct configuration for its target device.

What Does Android Management Cover?

XRBuildKit manages all Android-specific files that would otherwise require manual editing:

  • AndroidManifest.xml

  • Gradle templates (mainTemplate.gradle, gradleTemplate.properties)

  • Native plugins (.aar, .so files)

  • Plugin enabling/disabling based on the active Device Preset

These files are saved, loaded, and restored automatically as part of each Android Device Preset.

How Does It Work?

  • SavePreset When saving a Device Preset for Android, XRBuildKit copies the current Android plugin files (Assets/Plugins/Android) into the preset folder under XRBuildKit/Plugins/Android/<PresetName>/.

  • LoadPreset When loading, XRBuildKit restores the saved files back into Assets/Plugins/Android. Any device-specific plugin states are reapplied automatically:

    • Meta Quest loaders/plugins enabled, XREAL disabled.

    • XREAL plugins enabled, Oculus disabled.

  • PluginConfigurator Handles differences between device targets by enabling/disabling .meta files. Example: switching between Meta Quest and XREAL Air.

Example Workflow

  1. Configure your project for Meta Quest 3 (Android) with correct manifest and plugins.

  2. Save a preset:

    XRSettingsUtility.SavePreset("Quest3", "Android");

  3. Reconfigure for XREAL Air with XREAL-specific plugins and manifest.

  4. Save another preset:

    XRSettingsUtility.SavePreset("XREALAir", "Android");

  5. Later, load the desired preset to restore all Android-specific settings instantly:

    XRSettingsUtility.LoadPreset("Quest3", "Android");

API Example: Managing Android Plugins

using XRBuildKit.Editor.Utility;
using UnityEditor;

// Configure plugins for Meta Quest device
PluginConfigurator.ConfigureAndroidPlatform("Meta Quest 3", BuildTarget.Android);

// Save and load Android plugin state via presets
XRSettingsUtility.SavePreset("Quest3", "Android");
XRSettingsUtility.LoadPreset("Quest3", "Android");

Troubleshooting

  • Plugins not updating?

    • Ensure you saved the preset after modifying Android plugins.

    • Try the Clean Build option in XRBuilderWindow.

    • Confirm that Assets/Plugins/Android contains the expected files after loading.

  • Plugin conflicts or build errors?

    • Only enable the plugins required for the active preset.

    • Use PluginConfigurator to disable conflicting files.

Related Guides

🚀 With XRBuildKit, Android plugin management becomes seamless and reliable across all XR devices.

PreviousXR Loader AutomationNext+ XumLobby Integration

Last updated