新增 docs/:商店文案、图标与各机型截图

Connect IQ Store 后台要填的素材都放进 docs/,代码不依赖其中任何文件。

截图
  八个屏宽各一张(218/240/260/280/360/390/416/454),外加七套主题各一张。
  全部是模拟器的真实渲染 —— 字体是 Garmin 内置的 Roboto / Bionic,和真机一致。
  preview-themes.svg 用的是网页字体,不能拿去当商店截图,docs/README.md 里
  特别提了这点。

  ⚠️ 进度环是摆拍的。模拟器的 Edit Activity Monitor Info 只能改活动分钟、
  恢复时间、呼吸和压力,改不了步数/距离/卡路里(那几个输入框是 Java 自绘的
  表格,AppleScript 也够不着),所以环在模拟器里永远全灰。截图构建把四段弧
  固定成了设计稿的填充状态。除环之外画面上每个数字都是模拟器的真实取值。

  数据位用的是日出/高低温/心率/身体电量,不是默认的日出/高低温/距离/步数 ——
  后两项在模拟器里是 0,截出来底部是 "0.0 0"。这些都写进 docs/README.md 了。

文案
  中英文各一份,含名称、简介、详细描述、关键词、以及要向用户解释的四项权限。
  详细描述按「进度环 / 四个数据位 / 七套主题 / 常亮 / OWM 选用 / 其它」组织,
  156 项字段按分类列出。

图标
  store-icon-1024.png 与 512.png,与启动图标同一套视觉(渐变环 + 橙色日期带),
  由 tools/gen_icons.py 的 launcher() 渲染。

docs/README.md 还记了后台要填但不在仓库里的项(分类、价格、隐私政策 —— 启用
OWM 时会把坐标发给 api.openweathermap.org,这点建议在描述里写明),以及发布
前必须先解决的设计稿授权问题。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-10 12:21:22 +08:00
parent 696b728c78
commit 230180febf
21 changed files with 248 additions and 0 deletions

72
docs/README.md Normal file
View File

@@ -0,0 +1,72 @@
# 上架素材
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 节)。**以自己的名义上架前,需要先取得原作者
授权,或把视觉部分替换成原创设计。** 这是法律问题,不是技术问题。