Files

T

laoyang c0d5fdff01 docs(上架): 应用商店上架 / 正式证书 / APP 备案全套材料

## 背景

用户要同时办三件事：① 上架华为 AppGallery ② 申请正式发布证书 ③ 在阿里云做 APP 备案。
本目录是这三件事的全部材料，信息**全部取自真实代码与实测**，不是套模板。

## 材料清单

| 文件 | 用途 |
|---|---|
| `README总览.md` | 先看这个：材料索引 + 三件事的先后关系 + 你现在就能做的 |
| `商店上架文案.md` | AGC 各字段可直接复制的文案（一句话简介/应用介绍/更新说明/分级问卷/隐私标签） |
| `商店信息_结构化.json` | 同上，机器可读 |
| `隐私政策.md` | 完整隐私政策正文 |
| `用户服务协议.md` | 完整用户协议正文 |
| `正式证书与签名切换.md` | 发布证书申请 + release 打包全流程 |
| `APP备案材料.md` | 阿里云 APP 备案逐字段填写指引 |
| `图标/app_icon_216.png` | AppGallery 图标（216×216，9.7KB） |
| `图标/app_icon_1024.png` | 备案图标 + 1024 规格（112KB） |
| `verify_materials.py` | 校验材料与代码一致（42 项） |

## 实测核对过的事实（材料里的数字都从这里来）

- 包名 `familybook.yangyq.net`、版本 `0.8.0` / versionCode `800`（`AppScope/app.json5`）
- 应用名「家书」（`AppScope/resources/base/element/string.json`）
- 权限 **只有 3 个且全是普通权限**：INTERNET / GET_NETWORK_INFO / DETECT_GESTURE
  （`entry/src/main/module.json5`）—— 定位、通讯录、相机、麦克风、设备标识符**一个都没申请**
- 第三方 SDK：**无广告、无统计、无推送**
- 后端域名 `family.yangyq.net`，服务器阿里云 `47.104.72.161`（中国大陆）

权限少是审核优势：「权限滥用」是驳回第一大类原因，家书直接绕开。
隐私政策第二节与第十节做了**权限逐条对照表**，可直接给审核看。

## 图标为什么要重做

包内 `fb_logo.png` 是 **192×192 且自带圆角**（四角透明，半径约 33px）。
AppGallery 两种规格都不达标（要 216 或 1024，且「square-shaped icon」）。
→ 取内部主色 #F2E9D8 铺满方形画布补掉缺角，图案原样叠加、不裁切不缩放，
  生成 216 与 1024 两版。图案与包内完全一致（审核要求后台图标 = 包内图标同一图案）。

第一版直接用 LANCZOS 放大，**保留了圆角**，被 `verify_materials.py` 抓到并修正 ——
这就是写那个校验脚本的意义。

## 四个必须先解决的问题（已写进总览，不隐瞒）

1. **现在是调试证书** → 备案要正式证书的公钥/MD5，上架要正式签名（调试包报 991/1014）
2. **没有「家书」软著** → 备案不强制；华为要求但可用《免责函》过渡（6 项现有软著均无关）
3. **隐私政策页面还不存在** → 站点无 privacy 路由；建议用华为自带托管服务（SyncCalendar 用的那个，实测 200）
4. **阿里云服务器是否包年包月** → 备案硬性要求，需用户去控制台确认

## 顺序（三者有依赖，不能乱）

```
① 申请正式证书（10 分钟，AGC 即时出证）
      ↓ 拿到后才能
② APP 备案（1~20 工作日，最慢，先提交）
③ 打 release .app 包
      ↓ 拿到备案号才允许提审
④ 提交 AppGallery 审核（1~7 工作日）
      ↓
⑤ 公安联网备案（上架后 30 日内）
```

## 校验

`python3 verify_materials.py` → **42 项全过**：
包名/版本/名称与代码一致、权限集合完全一致、隐私政策"未申请"的声明与代码相符、
字数限内、三份文档互相不打架、图标尺寸与四角不透明、已知缺口如实记录。

## 没做的事（刻意的）

- 不生成截图：必须真机原生界面，不能是设计稿（审核明确禁止）
- 不填备案表：实名主体必须本人操作，且工信部短信核验要发到本人手机
- 不碰 AGC：需要登录用户账号，部分环节要扫码/人脸

2026-11-01 09:56:04 +08:00

7.7 KiB

Raw Blame History

家书 · 应用介绍文案（可直接复制到 AGC）

三个版本按投放位置选用。字数已核算，均在上限内。

一、一句话简介（AGC「一句话简介」字段）

上限 17 个汉字。

✅ 采用版（13 字）

一家人的日程任务与生活档案

备选

文案	字数	说明
把一家人的日子记在一起	11	更温情，偏情感诉求
家庭日程与生活记录工具	11	更直白，偏功能诉求

⚠️ 不要写「日历」「备忘录」「待办」这类通用词堆砌 —— 审核明确禁止在名称/简介里堆关键词。

二、应用介绍（AGC「应用介绍」字段）

上限 8000 字。 以下约 1050 字，留足余量，且覆盖了「实际功能」以免被判"介绍与功能不符"。

家书，是给一家人用的生活档案工具。

它不社交、不推送广告、不做推荐算法。它只做一件事：把一家人的日程、任务、重要日子、看过的电影、去过的地方、家里的账和资料，安安静静地记在一处，谁都能查得到，谁都不会漏掉。

【十个模块，覆盖一家人的日常】

日程 —— 月、周、日三种视图。支持重复日程（每天/每周/每月/每年/工作日）、跨天日程分段显示、参与人、提醒、附件照片。周视图与日视图上有一条红线标着"现在"，一眼知道今天过了多少。

任务 —— 看板与待办。可以给任务加子任务、评论、附件，也可以按人分配、按截止日排序。家庭事项不再只装在一个人脑子里。

名册 —— 家庭成员与亲友的联系方式、称谓、关系、单位职务、标签分组。谁是孩子的班主任、谁是哪一房的亲戚，都写清楚。

纪念日 —— 生日、结婚纪念日、忌日，按农历或公历记，提前提醒。

观影 —— 一家人看过的电影。记下片名、海报、评分和当时的一句感想。多年之后翻回去，比影评网站更有意思。

旅程 —— 去过的地方。行程节点、交通、花费、照片、同行人。一趟旅行就是一条时间线。

财务 —— 家庭账本。记账、分类、按月看，不做理财，不卖产品。

读书 —— 书架与读书笔记。章节、摘抄、想法。

资源 —— 证件与资料归档。身份证、户口本、保单、合同，拍下来存好，用的时候找得到。

笔记 —— 分块笔记，随手记，可共享给家里人。

【关于数据，三句话】

第一，数据在你自己的服务器上。家书是客户端，服务端由使用者自行部署，开发者不设中心数据库，也没有你的数据副本。

第二，能加密的都加密。密码单向哈希存储，手机号与证件号加密存储，附件落盘加密，登录令牌放在系统硬件密钥库里。

第三，不含任何广告与统计 SDK。不申请设备标识码，不采集位置与通讯录，不向任何第三方出售或共享你的信息。

【关于提醒的一句实话】

家书的提醒依赖系统通知能力，可能因省电策略或权限关闭而延迟。请不要把它当成航班、考试、就医这类要事的唯一提醒手段。

家书不是要替你做决定，也不是要你多用手机。它只是想让一家人少一点"我以为你记得"。

三、新版本特性（AGC「版本更新说明」字段）

首次上架也建议填，审核会看。

首个公开版本 0.8.0。

本次为家书第一次上架，包含完整十个模块：日程、任务、名册、纪念日、观影、旅程、财务、读书、资源、笔记。

主要能力：
· 日程支持月/周/日三视图、重复日程、跨天分段、参与人与提醒
· 任务支持看板、子任务、评论与附件
· 新增桌面服务卡片（2×2 今日速览 / 2×4 正在进行 / 4×4 今日时间轴）
· 支持后台定时同步，断网时展示本地缓存并明确提示"离线"
· 附件与敏感字段本地加密（密钥存于系统硬件密钥库）
· 全站 HTTPS，不含广告与第三方统计 SDK

四、搜索关键词（AGC「关键词」字段，如提供）

不要堆砌，选 5–8 个真实相关的。

家庭 日程 日历 待办 纪念日 观影记录 家庭账本 生活档案

⚠️ 别加"免费""最好用""万能"这类诱导词，也别加与功能无关的热门词（如"视频剪辑""壁纸"），会被判违规。

五、应用分类

层级	建议
一级	实用工具
二级	效率 / 备忘录 / 个人助理（以 AGC 下拉里的实际项为准）

❌ 不要选

社交 —— 家书没有陌生人社交，选社交会被要求提供社交类资质，且审核标准更高
金融理财 —— 财务模块只是记账，选理财类需要金融资质
效率办公 —— 容易与办公软件混淆

六、内容分级

建议：3+

问卷逐条答案：

问题	答案
是否包含暴力内容	否
是否包含性/裸露内容	否
是否包含恐怖/惊悚内容	否
是否包含赌博	否
是否包含酒精/烟草/毒品	否
是否包含粗俗语言	否
是否允许用户间自由社交或内容分享给陌生人	否（仅同一家庭内成员可见）
是否包含用户生成内容公开发布	否
是否含应用内购买	否
是否含广告	否
是否可收集位置	否
是否允许陌生人联系用户	否

七、云端隐私标签 / 数据安全表单

AGC 会要求填写「数据安全」表单，逐项如下：

项目	填写
是否收集个人信息	是
收集哪些	手机号（账号）、姓名/昵称/头像、用户主动录入的家庭内容（含照片附件）
用途	账号登录与身份识别、提供记录与同步功能
是否用于第三方广告	否
是否与第三方共享	否
是否可请求删除数据	是（设置→账号→注销账号；各条目可单独删除）
传输是否加密	是（全站 HTTPS）
是否可导出数据	是（设置→数据导出）
数据存储地区	中华人民共和国境内

八、隐私政策 URL

必填，且必须是可公开访问的 HTTPS 链接。

推荐优先用华为自带的隐私政策托管服务（你上架「同步日历」时用的就是它，实测链接目前仍可访问）：

位置：AGC → 我的应用 → 选应用 → 「隐私政策」/「协议服务」区域
优点：免费、在华为域名下（审核认可度最高）、不用自己搭页面
参考：SyncCalendar 的托管链接为 https://agreement-drcn.hispace.dbankcloud.cn/index.html?lang=zh&agreementId=...

备选：部署到自己的站点（https://family.yangyq.net/privacy），但必须确保不需登录即可访问。材料见同目录 隐私政策.md。

九、提交前必须自己核对的 8 件事

☐ 后台应用名称 = 包内 app_name = 家书（完全一致，含空格）
☐ 后台图标 216×216 = 包内 fb_logo 同一图案（当前图标只有 192×192，需另出）
☐ bundleName = familybook.yangyq.net（一个字符都不能错）
☐ versionCode = 800（若之前提交过，必须递增）
☐ 用的是 release 发布证书打的 .app，不是调试证书（调试包审核必挂，报 991/1014）
☐ 截图 3–5 张，真机原生鸿蒙界面，不带调试信息、不带其他平台标识
☐ 隐私政策链接在未登录状态下也能打开
☐ 隐私政策里写的权限，与 module.json5 实际申请的权限逐条对得上 （本文档配套的《隐私政策》第十节已做逐条对照表，可直接给审核看）

7.7 KiB Raw Blame History Unescape Escape