开发入门指南

快速设置您的 XREAL AURA 并开始开发。

准备工作

在开始之前，请确保您已准备好：

• XREAL AURA (眼镜 + 计算盒子)
• 开发电脑 (Windows, macOS 或 Linux)
• Android Studio (最新稳定版)
• USB-C 线缆 (高质量传输线)
• 用于 Play 商店和服务的 Google 账户

---

第 1 步：配置 Android Studio

安装 Android XR SDK

1. 打开 Android Studio
2. 进入 SDK Manager (Tools > SDK Manager)
3. 选择 SDK Platforms 标签页
4. 勾选 Android 15 (API 35) 或更高版本
5. 选择 SDK Tools 标签页
6. 安装：
   • Android SDK Build-Tools
   • Android Emulator
   • Android XR extensions (如果可用)

安装 XR 模拟器配置

用于在没有硬件的情况下进行测试：

1. 打开 Android Studio 中的 Device Manager
2. 创建新的虚拟设备 (New Virtual Device)
3. 选择 XR 设备配置文件
4. 选择 Android XR 系统镜像
5. 配置 OST 模式以模拟 XREAL 设备特性

---

第 2 步：在设备上启用开发者模式

在您的 XREAL AURA 上：

1. 进入 设置 (打开启动器 > Settings)
2. 导航至 关于设备 (About device)
3. 连续点击 版本号 (Build number) 7 次
4. 您将看到“开发者模式已启用 (Developer mode enabled)”的提示
5. 返回上一级设置菜单
6. 打开新出现的 开发者选项 (Developer options)
7. 启用 USB 调试 (USB debugging)

---

第 3 步：连接设备至电脑

1. 保持眼镜连接在计算盒子右侧的 眼镜端口 (Glasses Port)。
2. 将 USB-C 线缆从电脑连接至计算盒子左侧的 充电端口 (Charging Port)。

important

眼镜端口与充电端口均支持完整的 ADB 调试功能。使用充电端口进行调试时，您可以同时进行有线调试和使用眼镜显示。

---

第 4 步：构建并部署您的第一个应用

创建新项目

1. 在 Android Studio 中选择 New Project
2. 选择 XR Activity 模板 (如果可用) 或 Empty Activity
3. 设置最低 SDK 为 API 35
4. 选择 Kotlin 作为编程语言

配置 XR 依赖

在您的 build.gradle.kts 文件中：

android {
    defaultConfig {
        minSdk = 35
        targetSdk = 35
    }
}

dependencies {
    // 添加 XR 相关依赖
    implementation("androidx.xr:xr-compose:1.0.0")
    // ... 其他依赖
}

部署到设备

1. 在设备下拉列表中选择您已连接的设备
2. 点击 Run (绿色播放按钮)
3. 等待构建和安装完成
4. 戴上眼镜查看您的应用运行效果

---

下一步

• Android XR 文档 — 官方平台文档

---

故障排除

问题	解决方案
设备未被识别	检查线缆，尝试更换 USB 端口
显示 "Unauthorized"	在设备上点击允许 USB 调试授权
构建失败	更新 Android Studio 和 SDK
启动时崩溃	检查 logcat 中的错误堆栈
看不到眼镜显示	结束 ADB 会话后重新插拔眼镜

需要更多帮助？请访问 XREAL 开发者 Discord。