AstroBox 资源规范——表盘、快应用等资源的格式与要求

资源类型总览

表盘格式

.dwz（旧版）

• 小米早期表盘格式
• 结构：图片 + XML 配置
• 支持的设备：小米手环 9、REDMI Watch 5 等全部支持 AstroBox 的设备

.mwz（新版）

• AstroBox 推出的新版表盘格式
• 结构：图片 + JSON 配置 + 额外组件描述
• 支持更丰富的表盘组件（天气、股票、自定义小组件等）
• 向后兼容——.dwz 可以自动转换为 .mwz

CreatorConsole 上传要求

• 必须提供至少 1 张预览图
• 填写适配的设备型号
• 可选：填写表盘的显示布局描述
• 可选：关联爱发电商品（付费售卖）

快应用格式

.rpk

• AstroBox 标准快应用包格式
• 底层是 WebAssembly 模块（Rust / Python / JS 编译而来）
• 结构：.wasm + manifest.json（快应用元信息）
• 运行环境：WASI + wasmtime（和插件相同运行时）

快应用开发

和 AstroBox 插件开发类似：

• Rust（推荐，性能好）
• Python（Level 4 支持，快速原型）
• JavaScript（Level 4 支持，适合需要 UI 的快应用）

差异：快应用直接运行在穿戴设备上，而 AstroBox 插件运行在 AstroBox 进程中。

CreatorConsole 上传要求

• 必须有可正常运行的快应用二进制
• manifest.json 里必须声明：快应用名称、作者、版本、适配设备
• 快应用体积建议控制在 1MB 以内（穿戴设备内存有限）

固件格式

.bin

• 原始固件二进制包
• 大小取决于设备型号和固件功能
• AstroBox 会校验固件签名（如果是官方固件）或哈希值（如果是第三方固件）

.zip

• 固件压缩包，内部包含 .bin + 元信息
• AstroBox 会自动解压并校验

增量固件包

V2.1 新增支持。增量包只包含和当前固件的差异部分：

• 体积更小
• 推送更快
• AstroBox 自动检测是否为增量包、自动判断适配性

模块（Canopus）

V2.1 新增的资源类型——Canopus 模块：

• 用于扩展 AstroBox 本身的功能（不是设备资源）
• 类似 AstroBox 插件但范围更广
• CreatorConsole 支持上传和分发

捆绑资源（Manifest）

V2.1 新增：

• 把多个资源（比如一组主题表盘 + 匹配的快应用）打包在一起
• 用户一次下载，多个资源一起安装
• 适合「XX 主题全家桶」类创作

版本与适配

上传到 CreatorConsole 时，必须正确声明：

适配信息会在 AstroBox 资源中心自动展示，帮助用户判断要不要装。