FamilyBook_harmonyos/docs/上架/README总览.md

家书 · 上架与备案材料总览

生成于 2026-11-01。所有信息取自真实代码与实测，没有套模板硬填。 每个数字、每个权限、每句功能描述都能在仓库里找到出处。

---

一、材料清单（本目录）

文件	用途	给谁看
README总览.md	就是本文件，先看这个	你
商店上架文案.md	AGC 各字段的可直接复制文案	你填 AGC
商店信息_结构化.json	同上，机器可读版（便于核对与将来脚本化）	你/审核对照
隐私政策.md	完整隐私政策正文	托管或部署
用户服务协议.md	完整用户协议正文	托管或部署
正式证书与签名切换.md	正式证书申请 + release 打包全流程	你照着做
APP备案材料.md	阿里云 APP 备案逐字段填写指引	你填备案
图标/app_icon_216.png	AppGallery 应用图标	上传 AGC
图标/app_icon_1024.png	备案用图标 + 1024 规格	上传备案

图标在 WSL 的 ~/code/FamilyBook_harmonyos/docs/上架/图标/，本目录也放了一份。

---

二、三个申请的关系（别搞错顺序）

        ┌─────────────────────────────┐
        │  ① 申请正式发布证书          │  ← 最快，10 分钟，AGC 网页即时出
        │     .cer + .p7b             │
        └──────────┬──────────────────┘
                   │ 拿到后才能做下面两件
        ┌──────────┴──────────┐
        ↓                     ↓
┌───────────────┐    ┌──────────────────┐
│ ② APP 备案    │    │ ③ 打 release 包  │
│ （阿里云）    │    │    上架 AppGallery│
│ 1~20 工作日   │    │                  │
└───────┬───────┘    └────────┬─────────┘
        │ 拿到备案号才允许提审 │
        └──────────┬──────────┘
                   ↓
        ┌──────────────────────┐
        │ ④ 提交 AppGallery 审核│
        │    1~7 工作日          │
        └──────────────────────┘
                   ↓
        ┌──────────────────────┐
        │ ⑤ 公安联网备案        │
        │    上架后 30 日内     │
        └──────────────────────┘

🔴 三个容易踩的先后关系

1. 正式证书是所有事的前提。备案要它的公钥/MD5，上架要它的签名。调试证书两样都不行。
2. 备案比审核慢，先提交备案。备案最慢（管局 1–20 工作日），而华为审核只要 1–7 天。 并行推进：备案提交的同时去打包、准备截图、写文案。
3. 没备案号不能提审。华为提审页强制填 APP 备案号，没有会被拒。

---

三、你现在就能做的（不用等我）

按耗时从短到长排序：

今天就能完成（约 30 分钟）

#	事项	在哪做
1	生成发布证书的密钥库 + CSR	WSL 命令行（见 正式证书与签名切换.md 步骤 1）
2	AGC 上传 CSR → 下载 .cer	AGC 网页，即时
3	AGC 创建发布 Profile → 下载 .p7b	AGC 网页，即时
4	AGC 新建应用（包名 familybook.yangyq.net）	AGC 网页
5	微调图标：把 216/1024 两个图标过一眼	本目录 图标/
6	截 3–5 张首页截图	手机真机

需要你做但我做不了的（卡在你手上）

#	事项	为什么只能你做
7	AGC 开通地图服务 + 拿 Client ID	要登录你的开发者账号（这也是 #33 卡住的地方）
8	扫码/人脸完成 AGC 的某些验证	需要你本人
9	确认阿里云服务器是包年包月	要登你的阿里云控制台
10	阿里云备案系统填表 + 签署承诺书	实名主体必须本人操作
11	工信部短信核验（24h 内）	短信发到你手机
12	接审核电话	打给你

需要我做的（你说一声就干）

#	事项
A	生成发布密钥库与 CSR（我用脚本生成，口令你定）
B	改 build-profile.json5 切 release 签名
C	打 .app 包并自检（签名/版本号/包名）
D	把隐私政策部署到 family.yangyq.net/privacy（做一个公开页面，无需登录）
E	用正式证书提取公钥与 MD5，填好备案要的那三项
F	装包真机验证（顺便把 #33、#34 一起验完）

---

四、四个必须先解决的问题（否则会白跑一趟）

问题 1：现在是调试证书，备案和上架都不认

• 现用证书：familybook.yangyq.net.debug.cer（debug）
• 备案要正式证书的公钥 + MD5
• 华为审核看到调试签名会报 991 / 1014 包无效
• → 先做 正式证书与签名切换.md

问题 2：没有「家书」的软件著作权

• 你名下 6 项软著全部与家书无关（渤海生态系统 ×2、云任务调度、雾计算、海洋大数据 ×2）
• 阿里云备案不强制软著 → 不影响备案
• 华为上架要求软著，但可用《免责函》过渡 → 能提交，但不保证 100% 过
• → 建议：先用免责函提审，同时去中国版权保护中心申请「家书」软著（免费，30–60 工作日）
• 软著以后上小米/OPPO/vivo/应用宝全都强制要，早办早省事

问题 3：隐私政策页面还不存在

• 站点 family.yangyq.net 目前没有 privacy / terms 路由（实测 grep 无结果）
• 上架与备案都要可公开访问的 HTTPS 链接
• → 两条路：
  • 路 A（推荐）：用华为自带的隐私政策托管服务。你上架 SyncCalendar 时用的就是它， 实测链接现在还能打开（HTTP 200）。免费、在华为域名下、审核认可度最高。
  • 路 B：我帮你把 隐私政策.md / 用户服务协议.md 做成公开页面部署到站点。 ⚠️ 必须不需要登录就能访问，否则审核打不开 = 直接驳回。

问题 4：阿里云服务器是不是「包年包月」？

• 备案硬性要求：中国大陆地域 + 包年包月（含自动续费 ≥3 个月）+ 公网 IP
• 你的 IP 47.104.72.161 已确认、地域在中国大陆已确认
• 付费方式我查不到，需要你去控制台看一眼
• 如果是按量付费，得先转包年包月，否则备案系统直接拦住

---

五、几个我按实际代码核对过的关键数据

这些数字如果填错，轻则驳回重来，重则包名冲突无法上架。

项	值	出处
包名	familybook.yangyq.net	AppScope/app.json5 → bundleName
版本	0.8.0（versionCode 800）	同上
应用名	家书	AppScope/resources/base/element/string.json → app_name
图标源	AppScope/resources/base/media/fb_logo.png（192×192，自带圆角）	已重新出 216/1024 方形版
权限数	3 个，全部普通权限，无敏感权限	entry/src/main/module.json5
权限清单	INTERNET / GET_NETWORK_INFO / DETECT_GESTURE	同上
第三方 SDK	无广告、无统计、无推送	全仓库 grep 无相关依赖
后端域名	family.yangyq.net	端上 FbHttp/FbGeoRepo
服务器	阿里云，47.104.72.161，中国大陆	memory/server/aliyun-main.md
开发者	个人，杨永全	与 SyncCalendar 同一主体

关于权限少这件事，是优势

只有 3 个普通权限、没有定位、没有通讯录、没有相机、没有设备标识符， 这在审核里是极大的加分项 —— 「权限滥用」是驳回第一大类原因，家书直接绕开了。 隐私政策第二节和第十节已经做了权限逐条对照表，可以直接给审核看。

---

六、这次要准备但还没做的（我可以帮你做）

事项	说明
首页截图 3–5 张	需要真机。手机连上我可以帮你截
部署隐私政策页面	你选路 A 还是路 B，路 B 我来做
打 release 包	拿到 .cer/.p7b 后我来改配置 + 打包 + 自检
备案三项（公钥/MD5/包名）	拿到正式证书后我提取好，直接给你复制
真机联调	顺便把 #33（地址联想）、#34（时间联动）一起验完

---

七、一句话建议

今天先做这一件事：把正式发布证书申请下来。

其余所有事（备案、打包、截图、上架）都卡在它后面。它只要 10 分钟，且 AGC 网页即时出证。

拿到 .cer 和 .p7b 之后告诉我，我把签名切过去、打包、提取备案要的三项，一次给你。