Android 开发者的实用路线图——从你的第一个模拟器到空间 UI、3D 内容、感知和智能眼镜

Android 开发不再局限于你手中的矩形屏幕。

借助 Android XR，开发者可以建立跨越空间面板、沉浸式环境、XR 头显、有线眼镜、音频眼镜和显示眼镜的应用程序。现有的 Android 应用可以继续以传统的二维界面运行，而开发者可以逐步引入空间布局、三维对象、现实世界感知和免手势交互。

关键的是：

你无需成为游戏开发者即可开始建立 Android XR 应用。

如果你已经了解 Kotlin、Jetpack Compose、Android Studio、生命周期管理和自适应布局，那么你已经具备了大部分所需的基础知识。

本教程将解释什么是 Android XR。你应该选择哪些工具，应该学习哪些概念还有学习顺序。

Android XR 是 Android 网站的 专为日益增长的 现实设备而设计。

这些设备目前大致分为两大体验类别：

代入感较强

这些体验主要针对 XR 头戴式设备和有线 XR 眼镜。

• 将使用者带入完全虚拟的环境
• 将数字内容与物理世界融合
• 在使用者周围放置多个应用面板
• 渲染交互式 3D 对象
• 识别表面、深度、手部、面部、锚点和设备位置
• 在传统多任务处理和完全空间体验之间切换

体验

这些体验专为音频眼镜和显示眼镜等设备而设计。

体验并非取代使用者的周围环境，而是为日常活动添加轻量级信息和辅助功能。其实，

• 实时导航
• 翻译
• 通知
• 语音助手
• 上下文信息
• 现场工作人员检查清单
• 导航指令
• 摄像头辅助 AI
• 免提通信

痛点：很多开发者误以为“XR”只能做游戏或全沉浸式场景。导致他们错失了提高型轻量化应用的机会。

Android XR 开发路线

You need to decide which development path matches your product goals.

• Jetpack XR SDK
• Kotlin & Jetpack Compose
• AOSP View System
• Unity

在以下情况下使用 Jetpack XR SDK：

• You are already an Android developer.
• You are extending an existing mobile or large‑screen app.
`
• Your app is primarily UI‑driven.
`
• You want to stay in Kotlin/Compose/Jetpack.
`
• You need spatial panels,3D models,environments or Android integration.
`
• You are building companion experiences for smart glasses.
`

在以下情况下使用 Unity / Godot / Unreal Engine：

• The app is mainly a game.
`
• You need complex real‑time 3D rendering.
`
• Your team already has an engine‑based XR project.
`
• You require advanced physics。 animation,shaders or engine workflows.
`

在以下情况下使用 OpenXR：

• You need a lower‑level cross‑platform XR standard.
`
• You want tighter control over rendering and device features.
`
• You are building an engine,framework or deep immersive app.
`

• You are building a browser‑based experience.`
• You want users to access XR via a webpage.
• Your team is more comfortable with web technologies than native Android.

For most existing Android developers,Jetpack XR SDK is best first road.
It lets you spatialize familiar layouts and incrementally add immersive capabilities while reusing your mobile or TV codebase.


第 1 阶段：强化你的 Android 基础


Before touching any XR‑specific APIs,make sure you’re comfortable with core Android concepts listed below:



Kotlin


Coroutines &Flow


Jetpack Compose


State management


Android lifecycle


ViewModel


Material Design


Responsive layouts


Navigation


Permissions


Media &不过，Camera APIs


Android Virtual Devices



Pain point:If you skip this step and jump straight into XR,you’ll quickly hit obscure bugs that stem from missing lifecycle or permission handling.

Compose is especially important because official Android XR codelabs are built on it.
Google recommends you be comfortable with Kotlin,Compose,Android Studio and virtual devices before starting.
If you can already create a Compose UI,manage state and run it on an emulator。you’re ready for next step.


第 2 阶段：了解 Android XR 设备类别


Pain point:Many developers treat “XR” as a single device type and waste time trying to make a headset UI work on glasses .

XR 耳机 

These provide a wide field of view for fully immersive virtual environments.

Typical inputs:

"Hand tracking
Eye tracking
Controller input
Gaze
Voice
Mouse &不过，Keyboard


X​R 有线眼镜 

They can deliver spatial and immersive experiences while tered to a host PC or phone.

They may support:

d= "" class="">Spatial UI
d= "" class="">Passthrough
d= "" class="">World anchoring
d= "" class="">Hand‑eye input
d= "" class="">High‑fidelity visual content
/ ul>

X​R 音频眼镜 

No visual display – interaction driven by sound。voice,sensors,notifications and AI assistance.
Pain point: 许多开发者认为必须从零重写才能进入 XR，却忽略了现有 App 可以直接作为二维面板运行。

‹OL›
1️⃣ 打开已有 Compose 项目
2️⃣ 在 Android XR 模拟器上运行
...省略 ...‹/OL›
…，‹H2 data-id=“heading-”›推荐的八周 Android XR 路线图‹/H2›
‹H³›第1周：Android 与 Compose 准备情况‹/H³›
‹UL›
…‹/UL›
‹P>Pain point: 如果你只学 Kotlin 却不熟悉 Jetpack Compose，后续会卡在 UI 移植上。

…，说起来，‹H2 data-id=“heading-”›你应该按顺序学习的主题‹/H2›
…，‹H2 data-id=“heading-”›Android 开发者在启动 XR 时常犯的错误‹/H2›
‹H３〉错误①：从大型沉浸式应用程序开始‹/H３〉
‹P〉先建立一个小型空间交互再迭代…，‹/P〉
…，‹H2 data-id=“heading-”›现有 Android 开发人员的最快方法‹/H2›
‹OL＞
Ⅰ. 安装最新兼容的 Android Studio preview

…，’‘’
‘’’
‘’’
‘’’
‘’’
‘’’
’‘’
​
​
​
​
​
​

​​

​

​​​

‍‍‍‍‍‍‍‍

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌‌‏‏‏‏‏‏‏‏‏‎‎‎‎‎‎ ‎ ‎ ‎ ‎ ‎ ‏ ‏ ‏ ‏ ‏ ‏ ‎‎ ‎ ‎ ‎ ‎    

arduino git clone https://github.com/android/xr-samples.git

...