# openkylin-xr-roadmap

**Repository Path**: bigbits/openkylin-xr-roadmap

## Basic Information

- **Project Name**: openkylin-xr-roadmap
- **Description**: XR SIG packaging, independent adaptation stacks and image integration roadmap
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-03
- **Last Updated**: 2026-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# openKylin XR 集成规划

面向 XR SIG 的软件分层、Debian 拆包、基础组件独立适配和多系统镜像集成方案。

本仓库承载工程方案、维护边界与落地清单。文中的新增仓库和包名为建议名称；登记、代码迁移、包构建与设备验收分别推进。

## 核心约定

- 通用组件使用 `xr-*`，发行版集成使用 `openkylin-xr-*`，设备后端使用型号后缀。
- 内核、Mesa、Monado 及其他需要定制的基础组件，在独立适配仓库中维护，保留真实上游历史和可重放补丁栈。
- XR 专有修改保持在独立适配线；openKylin 常规内核、图形栈和标准软件包保持各自维护线。
- 通过专用包名、私有安装目录、显式会话选择和 SIG 测试源交付适配组件。
- 串流与一体机原生运行共用接口和调试设施，分别选择运行时及硬件后端。
- 镜像工具保持系统、型号、功能组合三个扩展维度；openKylin 是其中一个系统适配器。
- 共享相机、IMU 与原始输入保持唯一硬件所有权，跟踪和调试订阅已有生产者。

## 文档导航

| 文档 | 内容 |
|---|---|
| [软件包与仓库布局](docs/package-layout.md) | 功能源码包、二进制子包、设备资源、架构和依赖边界 |
| [基础组件独立适配](docs/base-components.md) | 内核、Mesa、Monado 等 fork、补丁栈、私有路径与版本选择 |
| [发行集成与实施顺序](docs/integration.md) | 元包、镜像适配、测试源、构建和分层验收 |

## 分层

```text
应用 / 空间桌面 / 调试前端
             |
       会话管理与状态接口
        /              \
   串流运行方式       一体机原生运行方式
   WiVRn / WayVR      独立运行时适配包
                           |
                   头部 / 手柄跟踪接口
                           |
                   唯一设备采集生产者
                           |
                 型号配置 / 固件 / 私有兼容环境
                           |
                 独立内核及图形适配组件
```

目前已有构建入口能够产出设备用 SteamVR driver；原生 OpenXR 后端、空间桌面组合与完整型号 profile 需要分别完成构建和实机验收。源码存在、离线构建成功和硬件功能可用是不同状态。

## 社区协作

XR SIG 负责 XR 接口、运行方式、型号集成、调试和用户体验。内核与图形领域的协作可用于设计评审和补丁讨论，适配成果先在本方案的独立仓库及测试源中交付。进入其他维护线需要另行提出具体变更。

参考：[XR SIG](https://gitee.com/openkylin/community/tree/master/sig/XR)、[社区打包指南](https://gitee.com/openkylin/community/blob/master/sig/packaging/打包实践操作指南.md)。