toolkit 中文文档 下载 App

GSI 镜像的格式与来源:给 DSU Sideloader 准备正确的系统镜像

用 DSU Sideloader 体验访客系统,核心素材是 GSI 镜像。镜像选错格式或架构,流程在第一步就会卡住。这一页把格式与来源的基本概念理清。

GSI 是什么

GSI(Generic System Image,通用系统镜像)是不绑定具体机型的系统镜像:只要设备满足 Project Treble 的分区规范,理论上同一个 GSI 可以在多台设备上启动。它也是 DSU 机制的标准搭档。

常见的镜像格式

社区里 DSU 相关工具通常支持这几类格式:

格式形态说明
img裸镜像直接可用,体积最大
gz / xz压缩镜像下载更快,使用前需解压或由工具处理
zip(DSU 包)打包格式把镜像与元信息打包,多用于 DSU 流程分发

Toolkit 内置板块具体接受哪些格式,以应用内实际界面为准;拿不准时优先选镜像发布页标注的原始格式。

来源怎么选

架构匹配是硬条件

镜像架构与处理器不一致,访客系统根本起不来。下载前确认设备是 arm64 还是别的架构,这是比格式更靠前的检查项。

继续了解