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

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 85 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 83 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

BIN
docs/store-icon-1024.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 83 KiB

BIN
docs/store-icon-512.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

90
docs/store-listing-en.md Normal file
View File

@@ -0,0 +1,90 @@
# Connect IQ Store listing (English)
## App name
```
Fenix 8 V3
```
## Short description
```
A dense data watch face: four progress arcs, four configurable slots, 156 data
fields to choose from, seven colour themes.
```
## Full description
```
Fenix 8 V3 packs a lot of information onto the dial without making it feel
crowded.
■ Four progress arcs
The rim is split into four independent arcs. Each one tracks a metric of your
choosing - steps, calories, distance, floors, move bar, active minutes or body
battery - so a glance tells you where the day stands. Every tick is
individually coloured, so the arc shifts hue as it fills.
■ Four data slots, 156 fields
Top-left, top-right, bottom-left and bottom-right. Each can show any of:
· Date & time seconds, UTC, two alternate time zones, week number
(ISO or calendar), custom time and date formats
· Activity steps, calories, distance, floors, ascent, active minutes,
plus week-to-date, 7-day and 28-day totals
· Body heart rate, resting HR, stress, pulse ox, respiration,
body battery, weight, BMI, recovery time, VO2 max
· System battery, battery in days, alarms, notifications, do not
disturb, bluetooth, solar intensity
· Environment altitude, pressure, sunrise/sunset, next sun event, moon age
and illumination, civil/nautical/astronomical twilight,
golden hour, blue hour
· Weather temperature, feels-like, high/low, humidity, precipitation,
wind speed and direction, UV index, visibility, dew point
· From watch next calendar event, training status, race and pace
predictors (5k/10k/half/marathon), weekly run and bike
distance, and complications published by your other apps
· Custom three custom text lines, event countdown
The captions under the bottom two slots follow whatever you pick - no separate
setting to keep in sync.
■ Seven themes
Ember, Aurora, Brass, Voltage, Reef, Acid and Kelp. Each carries its own arc
gradient, date band colours and time-digit gradient.
■ Always-on display
On AMOLED watches the face switches to a low-power layout while asleep: the
date band fill and the progress ring are dropped, the time and date are dimmed,
and the whole layout drifts a few pixels each minute to avoid burn-in.
■ OpenWeatherMap (optional)
Add your own OpenWeatherMap API key for 30 further weather fields, including
air quality (AQI, PM2.5, PM10, CO) and the next two days' forecast. Without a
key the watch face never touches the network.
■ Also
· English and Simplified Chinese - weekday, month and field captions all follow
the watch language
· Temperature unit can be forced to Celsius or Fahrenheit; distance and
12/24-hour follow the watch
· The bluetooth glyph dims when the phone is out of range
```
## Keywords / tags
```
data field, progress ring, complications, always-on, AMOLED, weather,
heart rate, body battery, sunrise sunset, chinese
```
## Permissions to explain to users
```
· UserProfile - resting heart rate, weight, VO2 max
· SensorHistory - pulse ox, body battery
· Communications + Background - only used to fetch weather, and only when an
OpenWeatherMap API key has been entered
· ComplicationSubscriber - calendar, training status, and data published by
other apps
```

75
docs/store-listing-zh.md Normal file
View File

@@ -0,0 +1,75 @@
# Connect IQ Store 上架文案(简体中文)
## 应用名称
```
Fenix 8 V3
```
## 一句话简介(短描述)
```
多指标数据表盘:四段进度环 + 四个可自由配置的数据位156 项数据任选,七套配色。
```
## 详细描述
```
Fenix 8 V3 是一款信息密度高、但不拥挤的数据表盘。
■ 四段进度环
表盘外圈是四段独立的进度弧,各自绑定一项指标(步数、卡路里、距离、楼层、
动动条、活动分钟、身体电量),一眼就能看出今天的完成度。每根刻度的颜色都
是渐变的,进度越高颜色越靠近弧段末端的色相。
■ 四个数据位156 项数据任选
左上、右上、左下、右下四格,每格都能从 156 项数据里任选:
· 时间日期 秒、UTC、第二时区 ×2、周数ISO / 日历)、自定义时间与日期格式
· 活动 步数、卡路里、距离、楼层、爬升、活动分钟,以及本周 / 近 7 天 /
近 28 天累计
· 身体 心率、静息心率、压力、血氧、呼吸、身体电量、体重、BMI、
恢复时间、最大摄氧量
· 系统 电量、剩余天数、闹钟、通知、勿扰、蓝牙、太阳能强度
· 环境 海拔、气压、日出日落、下一太阳事件、月龄月相,
以及民用 / 航海 / 天文晨昏蒙影、黄金时刻、蓝调时刻
· 天气 气温、体感、最高最低、湿度、降水概率、风速风向、紫外线、
能见度、露点
· 手表数据 下一个日程、训练状态、完赛与配速预测5k/10k/半马/全马)、
本周跑步与骑行距离、以及其它 App 发布的复杂功能
· 自定义 三段自定义文字、事件倒计时
底部两格的小标签会跟着所选数据自动变化,不用另外设置。
■ 七套配色
余烬、极光、黄铜、电压、珊瑚礁、酸绿、海藻。每套都有自己的进度环渐变、
日期带配色和时间数字渐变。
■ 常亮显示
AMOLED 机型支持常亮。常亮时自动切换到低功耗版面:去掉日期带底色和进度环,
时间与日期压暗,整个画面每分钟在几个像素内轻微游走以避免烧屏。
■ OpenWeatherMap选用
填入自己的 OpenWeatherMap API key 后,可额外获得 30 项天气数据,包括空气质量
AQI、PM2.5、PM10、CO与未来两日预报。不填则完全不联网。
■ 其它
· 简体中文 / 英文双语,表盘上的星期、月份、数据标签都会跟随手表语言
· 温度单位可强制摄氏或华氏,距离与时间制式跟随手表设置
· 手机断连时蓝牙图标自动压暗
```
## 关键词 / 标签
```
数据表盘, 进度环, 数据字段, 常亮, AMOLED, 天气, 心率, 身体电量, 日出日落, 中文
```
## 需要向用户说明的权限
```
· 用户档案 —— 用于静息心率、体重、最大摄氧量
· 传感器历史 —— 用于血氧、身体电量
· 通信与后台 —— 仅在填写了 OpenWeatherMap API key 时用于拉取天气
· 复杂功能订阅 —— 用于日程、训练状态、以及其它 App 发布的数据
```