# xr-image-tools

**Repository Path**: bigbits/xr-image-tools

## Basic Information

- **Project Name**: xr-image-tools
- **Description**: Independently maintained XR sources and openKylin packaging
- **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

# XR rootfs

多系统 rootfs 的准备和组件组装。系统、型号与使用场景分别扩展，首批为 Debian / SteamOS 和 MIX A081。

```sh
python3 tools/rootfs.py plan --system debian --device a081 --profile debug
python3 tools/rootfs.py plan --system steamos --device a081 --profile vr
python3 tools/rootfs.py prepare --system steamos --source /archives/official-steamos.zip --output /new/prepared
python3 tools/rootfs.py prepare --system debian --source https://deb.debian.org/debian --output /new/prepared
python3 tools/rootfs.py assemble --system steamos --base-archive /prepared/rootfs.tar.zst --artifacts /private/artifact-map.json --output /new/bundle
```

prepare 仅在主机准备新目录：SteamOS 核对官方 archive/image/partition 摘要并保留元数据；Debian 使用 debootstrap foreign-stage（需要 debootstrap 和相应主机权限），第二阶段必须在目标架构完成。SteamOS Python 依赖版本见 systems/steamos/legacy/profile.json。

assemble 生成基础归档的原样副本、设备配置 overlay.tar 和锁定提交/摘要的 manifest.json。artifact-map 是本地 JSON 数组，每项含 source、根相对 destination、sha256，用于输入各组件构建产物；不会自动启用服务、安装厂商库、封装 recovery 或刷写设备。没有 --artifacts 时只有板级配置，不构成完整 VR 运行系统。

新系统：在 systems/<name>/ 添加 adapter.json、adapter.py；prepare.program/arguments 是统一入口，输出 rootfs 归档。新型号：devices/<model>/model.json 声明兼容系统、架构与文件 overlay。新组合：profiles/<name>.json 选择组件，components.lock.json 固定 Git 提交。计划与组装自动使用新增条目，不需要创建更多 OS 仓库。

systems/*/legacy/ 保留原有设备侧初始化/配置和镜像配方；其中 /mnt/osstore 等路径属于既有 A081 安装流程，不能当作通用主机命令直接运行。相邻 openkylin-xr-integration 的 devices/a081/ 保存已用的音频、传感器、热控来源；网络凭据、厂商固件和库不进入 Git。

这次是源码拆分和离线构建迁移，未重新验收硬件；已验证系统与 recovery 回退保持原状。工程架构、迁移状态、Wiki 与 Blog 见 [openkylin-xr-docs](https://gitee.com/bigbits/openkylin-xr-docs)。

## 固定版本原厂二进制

原厂依赖改由独立公开 [xr-vendor-assets](https://gitee.com/bigbits/xr-vendor-assets) 的 Release 提供；本仓库只保存 devices/a081/vendor.lock.json 中的资产 ID、归档与逐文件 SHA-256。无需反复提取原厂镜像：

```sh
python3 tools/vendor.py fetch --output /new/vendor-cache
python3 tools/vendor.py verify --cache /new/vendor-cache
python3 tools/rootfs.py assemble --system steamos --base-archive /prepared/rootfs.tar.zst --vendor-cache /new/vendor-cache --artifacts /private/native-artifacts.json --output /new/bundle
```

下载使用现有 gh 登录；之后 verify/assemble 只读取本地缓存。`--bundle firmware` 可只下载板级固件，供 maintenance profile 使用。所有 native artifacts 仍由对应源码构建，厂商包不包含它们；per-device persist 校准单独本机备份并注入。型号包缺少校准时不代表可完成跟踪验收。未提供 --vendor-cache 的组装仍允许生成配置包，manifest 会明确 vendor_included=false。

通用启动环境不包含安装分区 UUID。启动时通过 `xr.osstore_uuid=<UUID>`，或私有 initramfs 的 `/etc/xr-device.conf` 中的 `osstore_uuid` 提供本机身份；缺少身份时停止启动，不跳过分区检查。包含私人身份或校准的镜像只在本地保管。

## openKylin 打包

本仓库包含独立的 `debian/` 配方。使用目标发行线的干净构建环境运行 `dpkg-buildpackage -us -uc -b`，预先准备 Build-Depends 和离线构建输入。包构建、目标系统安装和设备验收分别记录。

当前迁移不自动启用竞争采集、切换活动运行时或写设备启动分区；已有验证基线继续保留。