# 上架素材

Connect IQ Store 后台要填的东西都在这个目录里。代码不依赖这里的任何文件。

```
docs/
├── store-listing-zh.md      中文商店文案（名称 / 简介 / 详细描述 / 关键词 / 权限说明）
├── store-listing-en.md      英文商店文案
├── store-icon-1024.png      商店图标（大）
├── store-icon-512.png       商店图标（小）
└── screenshots/
    ├── 218x218.png ~ 454x454.png    八个屏宽各一张
    └── theme-01-ember.png ~ theme-07-kelp.png   七套主题（454px）
```

## 截图是怎么来的

全部是 **Connect IQ 模拟器的真实渲染**，不是网页预览图 —— 字体是 Garmin 内置的
Roboto / Bionic，和真机一致。`preview-themes.svg` 那张用的是网页字体，**不要**拿去
当商店截图。

每个屏宽各挑了一台代表机型：

| 尺寸 | 机型 | 尺寸 | 机型 |
|------|------|------|------|
| 218 | FR255S | 360 | Venu 2S |
| 240 | fenix 7S | 390 | Vivoactive 5 |
| 260 | fenix 7 | 416 | fenix 8 43mm |
| 280 | Enduro 3 | 454 | fenix 8 47mm |

截图里显示的数据位是 **日出 / 最高最低气温 / 心率 / 身体电量** ——
这四项在模拟器里有真实取值，不是默认配置（默认是日出 / 高低温 / 距离 / 步数）。
换掉后两项是因为模拟器灌不进步数和距离，默认配置截出来底部是 `0.0` 和 `0`。

### ⚠️ 进度环是摆拍的

模拟器的「Edit Activity Monitor Info」对话框只能改活动分钟、恢复时间、呼吸和
压力，**改不了步数 / 距离 / 卡路里**（那几个输入框是 Java 自绘的表格，
脚本也够不着）。所以进度环在模拟器里永远是全灰的，截图没法看。

截图构建把四段弧固定成了设计稿的填充状态（右上 21/21、左上 10/21、
右下 9/21、左下 14/21）。**除进度环外，画面上每个数字都是模拟器的真实取值**，
没有伪造。

如果要出完全真实的截图，把 `.prg` 侧载到真机戴一天再拍。

## 重新生成

图标：

```bash
python3 tools/gen_icons.py     # 顺带产出 store-icon 用的同款视觉
```

截图：本目录下的 PNG 是用模拟器抓的，流程见提交记录里的 `shot.sh` / `theme.sh`
（脚本在临时目录，没有入库 —— 它们依赖具体的窗口位置，换台机器就要重调）。
手工重做的话：编译 → `monkeydo` 载入 → 截模拟器窗口 → 按日期带定位裁出表盘圆形区。

## 后台还要填但不在这里的

- **分类**：Watch Faces
- **支持的机型**：55 款，以 `manifest.xml` 的 `<iq:products>` 为准
- **价格**：免费 / 付费自行决定
- **隐私政策**：如果启用 OpenWeatherMap，需要说明会把**坐标**发给
  `api.openweathermap.org`。不填 key 时完全不联网，这一点建议在描述里写清楚
- **联系邮箱 / 支持链接**

## ⚠️ 发布前必须先解决

表盘的视觉是对第三方 `watchface-kit` 设计稿的 1:1 还原（见仓库根目录的
`LICENSE` 与 `README.md` 第 13 节）。**以自己的名义上架前，需要先取得原作者
授权，或把视觉部分替换成原创设计。** 这是法律问题，不是技术问题。