设置您的开发环境

如需开始针对 Android XR 进行开发,您需要使用 Android Studio Meerkat | 2024.3.1 Canary 5,其中包含针对 Android XR 进行了优化的新工具和更新。

此版本的 Android Studio 中包含以下新功能:

  • Android XR 模拟器
  • 在布局检查器中添加了 XR 支持
  • XR 项目模板

进行 XR 开发所需的 Android Studio 硬件前提条件

  • RAM:16 GB 或更高
  • 目前受支持且已通过稳定性测试的系统配置:
    • 搭载 Apple Silicon (M1 芯片或更新型号) 的 macOS
    • 搭载 NVIDIA 显卡(GeForce 10 系列或更高版本)的 Windows 11;支持桌面版和笔记本电脑 GPU。

安装并配置适用于 XR 开发的 Android Studio

请完成以下步骤,下载 Android Studio 并设置开发环境:

  1. 请务必关闭您已安装的所有 Android Studio 版本。

  2. 下载 Android Studio Meerkat | 2024.3.1 Canary 5,将其解压缩到首选位置,然后启动该应用。

  3. 按照向导中的安装说明操作。

  4. Welcome to Android Studio 对话框中,点击 More Actions,然后选择 SDK Manager

    Android Studio 欢迎界面

  5. Android SDK 页面中,点击 SDK Tools 标签页,然后选择要安装的以下工具:

    • Android SDK Build-Tools
    • Android 模拟器
    • Android SDK Platform-Tools
    • 适用于 API 31-36 的布局检查器

    Android Studio SDK 屏幕

  6. SDK Platforms 标签页下,执行以下操作:

    1. 选中 Show Package Details 复选框可查看所有选项。
    2. 选择 Google Play XR ARM 系统映像 (macOS) 或 Google Play XR Intel x86_64 (Windows)。

    Android Studio SDK 平台屏幕

  7. 点击 Apply 进行更新,然后点击 OK

  8. 等待所有安装步骤完成,然后点击完成

创建 Android XR 项目

请按照以下步骤在 Android Studio 中创建 Android XR 项目,或将现有项目扩展到 XR。

  1. Welcome to Android Studio 窗口中,执行以下操作之一:

    1. 如果您要创建新的 XR 应用,请点击新建项目,然后执行下一步。
    2. 如果您要为现有应用添加空间感知功能,请点击 Open 选择您的项目,然后跳转到下一步“为 Android 模拟器创建新的 Android 虚拟设备”。(如需有关将现有应用适用于 Android XR 的空间化方面的帮助,请参阅使用 XR 将 Android 应用转换为 3D 版。)

    Android Studio 欢迎界面

  2. XR 类别中,选择 Basic Headset Activity 模板,然后点击 Next

    Android Studio 中的“New Project”(新建项目)界面

  3. 在下一个屏幕上,您可以为项目选择一个名称。您可以保留默认设置。然后点击 Finish

  4. 探索模板中提供的代码。请参阅我们的开发指南参考文档

为 Android 模拟器创建新的 Android 虚拟设备

Android XR 模拟器是 Android 模拟器的专用版本,专为 XR 应用开发而设计。借助该插件,您可以在熟悉的 Android Studio 环境中测试和调试扩展现实 (XR) 应用。

如需使用 Android XR 模拟器,您必须创建新的虚拟设备。具体步骤如下:

  1. 在 Android Studio 中,依次点击 Tools > AVD Manager,然后按照说明创建新的 Android 虚拟设备 (AVD)。

    Android Studio 设备管理器界面

  2. Add Device 窗口中,选择 Form Factor 下的 XR 选项,然后选择 Name 列表中的 XR Device。点击下一步

    Android Studio“添加设备”界面

  3. 在下一个标签页(Configure Virtual Device)的 System Image 下,选择与您的系统兼容的最新 Android XR 系统映像。

    Android Studio 中的“配置 Android 虚拟设备”界面

  4. 点击 Finish

  5. 如需启动模拟器,请点击设备管理器中的 Run 按钮。

    Android Studio 设备管理器界面

    模拟器会在单独的窗口中打开。

    Android Studio 模拟器屏幕

  6. 如需在模拟器中启动应用,请点击 Android Studio 中的 Run 图标。

    Android Studio 运行应用界面

    如需详细了解如何使用模拟器和其他新 XR 工具,请参阅 适用于 XR 的 Android Studio 工具

启用使用情况统计信息以帮助改进 Android Studio

由于这是 Android Studio 的开发者预览版,因此其中许多功能仍处于开发阶段。请考虑启用使用情况统计信息并发送反馈,以帮助我们改进这些工具。

如需启用使用情况统计信息,请执行以下操作:

  1. 依次点击设置 > 外观和行为 > 系统设置 > 数据分享
  2. 选择向 Google 发送使用情况统计信息

Android Studio 设置屏幕