Files
fenix8v3-watchface/docs/README.md
ericwyuan 230180febf 新增 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>
2026-09-10 12:21:22 +08:00

73 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 上架素材
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 节)。**以自己的名义上架前,需要先取得原作者
授权,或把视觉部分替换成原创设计。** 这是法律问题,不是技术问题。