自定义仪表

外观

导入、导出与分享 ​

自定义仪表通过普通 ZIP 包分享。它携带可编辑的源码和素材，而不是一段视频或一张无法修改的截图。

导出自己的作品 ​

  1. 在自定义仪表库中长按一个已保存的仪表。
  2. 选择导出，打开系统分享面板。
  3. 保存到“文件”，或通过系统支持的方式发送给接收者。

导出前先保存正在编辑的草稿。分享包不包含你当前驾驶的路线、行程传感器记录或单次行程存储。

导入分享包 ​

打开自定义仪表库右上角菜单，选择导入，再选择 ZIP。导入成功后会生成一个新的“我的”仪表，不会覆盖一个碰巧同名的作品。

示例每页也提供可导入的 ZIP。素材示例的 ZIP 已携带素材；只下载 JSX 文件则需要另行添加素材。

ZIP 里有什么 ​

text
my-instrument.zip
├── manifest.json
├── main.jsx
└── assets/
    └── badge.png

没有素材时，仍保留空的 assets/ 目录。manifest.json 用于说明标题、格式版本和要求的 App 版本。仪表名称来自清单里的标题，单纯重命名 ZIP 不会改变导入后的名称。

json
{
  "formatVersion": 1,
  "title": "我的速度表",
  "appVersion": "1.2.1"
}

这只是清单结构示例，手工打包时应使用支持所用功能的真实 App 版本。常规使用直接从 App 导出即可，不需要自己编辑清单。

版本不兼容怎么办 ​

如果分享包来自更新版本，App 可能在运行代码前要求更新。先更新 CapDrive，再重新导入；不要为了绕过提示而手工降低 appVersion，新组件和新属性并不会因此变成旧版本可用。

ZIP 缺少清单、源码、素材目录，或包含无法接受的路径和文件时，也可能被拒绝。最可靠的方法是让发送方重新从 App 导出原始 ZIP，避免把额外的外层文件夹一起压缩。

分享前检查 ​

  • 接收者能否在自己的 App 版本中找到自定义仪表入口。
  • 素材是否都包含在包中，源码标记是否正确。
  • 小、中、大尺寸和明暗外观是否都检查过。
  • 素材是否允许传播，代码中是否包含不准备公开的自定义文字或固定位置。

一个可导入的作品与一个读数正确、清晰易读的作品并不是同一项检查；两者都值得在分享前确认。