laoyang
c0d5fdff01
## 背景
用户要同时办三件事：① 上架华为 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：需要登录用户账号，部分环节要扫码/人脸
313 lines
14 KiB
Markdown
313 lines
14 KiB
Markdown
# 家书 · APP 备案填报材料（阿里云）
|
||
|
||
> **备案类型**：新增 APP（在你的既有主体下「新增服务」）
|
||
> **接入商**：阿里云（服务器 IP `47.104.72.161`，主机名 `yangyq`，位于阿里云中国大陆节点）
|
||
> **填报时间**：2026-11-01 整理
|
||
|
||
---
|
||
|
||
## 🔴 开工前必须确认的三件事
|
||
|
||
### 1. 服务器必须是阿里云的，且满足"可备案"要求
|
||
|
||
| 要求 | 你的情况 | 判定 |
|
||
|---|---|---|
|
||
| 中国内地地域 | ✅ 阿里云大陆节点 | 通过 |
|
||
| 包年包月（含自动续费 ≥3 个月） | ⚠️ **需你自己确认** | 待确认 |
|
||
| 已分配公网 IP | ✅ `47.104.72.161` | 通过 |
|
||
|
||
> **怎么查**：阿里云控制台 → 云服务器 ECS → 实例详情 → 看「付费方式」。
|
||
> 如果是**按量付费**，备案系统会提示不符合要求，需要转成包年包月（或已开通自动续费 3 个月以上）。
|
||
> 若你的站点实际跑在**轻量应用服务器**上，也在控制台对应产品里看。
|
||
|
||
### 2. 域名必须已备案，且与 APP 绑定
|
||
|
||
- APP 后台域名：**`family.yangyq.net`**
|
||
- 你已有 `yangyq.net` 的 ICP 备案（主站一直在跑），子域名 `family.yangyq.net` 通常可以**新增接入**或已在同一主体下
|
||
- ⚠️ 阿里云明确提示：**如果域名同时用于网站访问，该域名也必须完成网站备案**，否则网站有被关闭风险
|
||
→ 若 `family.yangyq.net` 之前没单独做网站备案，建议**一起补上**（同订单可提）
|
||
|
||
### 3. 必须已经有正式签名证书
|
||
|
||
备案要填 **公钥 + 签名 MD5**，**调试证书的不能用于备案**。
|
||
→ 先完成 `正式证书与签名切换.md` 里的步骤 1–3。
|
||
|
||
---
|
||
|
||
## 一、主体信息（复用实名信息，无需重填）
|
||
|
||
| 字段 | 填写 |
|
||
|---|---|
|
||
| 主体类型 | **个人** |
|
||
| 姓名 | 杨永全 |
|
||
| 证件类型 | 居民身份证 |
|
||
| 证件号码 | （系统已存，核对即可） |
|
||
| 手机号 | （系统已存，**必须能收短信** —— 后面有工信部核验） |
|
||
| 邮箱 | `i@yangyq.net` |
|
||
|
||
> 💡 个人主体管控比企业严：**类目只能选"无经营类目"**（工具、记事本之类），
|
||
> **不能**选电商、金融、医疗、教育、资讯、直播这些需要前置审批的。
|
||
> 家书正好是工具类，无缝符合。
|
||
|
||
---
|
||
|
||
## 二、APP 基础信息（逐字段照抄）
|
||
|
||
| 字段 | 填写内容 | 备注 |
|
||
|---|---|---|
|
||
| **APP 名称** | `家书` | ⚠️ 必须与**应用商店上架名称、桌面显示名称、软著名称**完全一致 |
|
||
| **APP 图标** | 用 `图标/app_icon_1024.png` | 1024×1024 正方形，无水印。备案系统要求清晰方图 |
|
||
| **APP 首页截图** | 首页（今日概览）截图 | ⚠️ **只放首页**，不能出现广告/充值/付费任何入口 |
|
||
| **内容分类** | `生活服务` → `工具` | 个人主体可选的合规类目 |
|
||
| **APP 语言** | `简体中文` | |
|
||
| **是否对外提供 SDK 服务** | **否** | 家书不对外提供 SDK |
|
||
| **使用的三方 SDK** | 见下方「三方 SDK 说明」 | 选填，但建议如实填 |
|
||
| **APP 全部后台服务域名** | `family.yangyq.net` | 只填域名主体部分，不填 `https://`、不带 `www` |
|
||
| **服务器所在地** | `山东省`（或服务器实际机房省份） | ⚠️ 填**备案服务器的机房省份**，不是你家所在地。阿里云控制台实例详情里有「地域」，如「华北2（北京）」就填北京 |
|
||
|
||
### 三方 SDK 说明（如系统要求填）
|
||
|
||
家书**不含任何第三方统计/广告/推送 SDK**。用到的都是鸿蒙系统内置能力，按备案系统口径可填：
|
||
|
||
```
|
||
无第三方 SDK。
|
||
仅调用设备系统内置能力：华为 Map Kit（地点输入联想，由 HMS Core 提供）。
|
||
不含广告、统计、推送类第三方 SDK，不采集设备标识符。
|
||
```
|
||
|
||
> 如果备案系统强制要求填至少一项，就填：
|
||
> `华为 Map Kit（华为终端有限公司）— 地点搜索联想`。
|
||
|
||
---
|
||
|
||
## 三、APP 唯一标识（备案核心，最容易填错）
|
||
|
||
| 字段 | 填写内容 | 从哪来 |
|
||
|---|---|---|
|
||
| **应用包名 / Bundle ID** | `familybook.yangyq.net` | `AppScope/app.json5 → bundleName` |
|
||
| **公钥** | 见下方「待填：正式证书信息」 | `openssl x509 -in *.release.cer -pubkey -noout` |
|
||
| **签名 MD5** | 见下方「待填：正式证书信息」 | `openssl x509 -in *.release.cer -fingerprint -MD5 -noout` |
|
||
| 平台 | HarmonyOS | |
|
||
|
||
### 🔴 签名 MD5 填写格式（高频错误）
|
||
|
||
```
|
||
openssl 输出： MD5 Fingerprint=7D:0C:4B:46:B7:C1:C0:D2:3C:6E:43:16:E5:C9:96:A3
|
||
备案要填： 7d0c4b46b7c1c0d23c6e4316e5c996a3
|
||
```
|
||
|
||
**规则：去掉所有冒号，只留 32 位十六进制字符。** 大小写通常都接受，建议统一小写。
|
||
|
||
### 待填：正式证书信息
|
||
|
||
> ⚠️ 下面这三项在你的**调试证书**上是这样（**不能用于备案**，仅作格式演示）：
|
||
|
||
```
|
||
包名 familybook.yangyq.net
|
||
公钥 MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEWidkGnDSOw3/HE2y2GHl+fpWBIa5S+IlnNrsGUvwC1I2QWvtqCHWmwFlFK95zKXiM8s9yV3VVXh7ivN8ZJO3SC5N1TCrvB2lpLMBwcz4DA0kgHCMm/wDec6kOHx1xvCR
|
||
MD5(去冒号) 7d0c4b46b7c1c0d23c6e4316e5c996a3 ← 调试证书的，勿用
|
||
```
|
||
|
||
**正式证书拿到后**，跑这三条命令，把输出的值填进备案系统：
|
||
|
||
```bash
|
||
cd ~/code/cert/familybook
|
||
|
||
# ① 公钥（整段，含 BEGIN/END 两行也一起复制，或只复制中间那段都行，按备案页提示）
|
||
openssl x509 -in familybook.yangyq.net.release.cer -pubkey -noout
|
||
|
||
# ② MD5（记得去掉冒号）
|
||
openssl x509 -in familybook.yangyq.net.release.cer -fingerprint -MD5 -noout
|
||
|
||
# ③ 核对包名
|
||
grep bundleName ~/code/FamilyBook_harmonyos/AppScope/app.json5
|
||
```
|
||
|
||
---
|
||
|
||
## 四、上线渠道
|
||
|
||
| 字段 | 填写 |
|
||
|---|---|
|
||
| 上线渠道 | ☑ **华为应用市场（AppGallery）** |
|
||
| | ☐ 其他安卓市场（后续可加） |
|
||
| | ☐ App Store（无 iOS 版，不勾） |
|
||
|
||
> 注意：备案时若勾了某个商店，后续实际没上，一般不影响；
|
||
> 但**勾了就必须真的能上**（审核可能抽查）。目前只勾华为即可。
|
||
|
||
---
|
||
|
||
## 五、服务内容说明（这个字段决定审核印象）
|
||
|
||
备案系统会让你填「互联网信息服务备注 / 服务内容详细说明」。**照下面填**：
|
||
|
||
```
|
||
家书是一款供家庭内部使用的个人生活档案管理工具，不面向公众提供信息服务，
|
||
不含社交、新闻资讯、电商交易、直播、金融理财等功能。
|
||
|
||
主要功能：家庭成员记录日程与待办事项、记录家庭纪念日、记录观影与旅行经历、
|
||
记录家庭日常收支（仅记账，不涉及任何支付、投资、理财业务）、
|
||
整理个人读书笔记与家庭资料文档。数据仅存储于用户自行部署的服务器，
|
||
不同家庭之间的数据完全隔离，无公开内容发布与用户间社交功能。
|
||
|
||
本应用不含广告，不含付费与内购，不设用户充值入口。
|
||
```
|
||
|
||
> ⚠️ 这段话是**照着实际情况**写的，不是套模板。审核电话回访时会问"你这个应用是干什么的"，
|
||
> 照这个说就不会对不上。
|
||
|
||
---
|
||
|
||
## 六、需要上传的附件
|
||
|
||
| 附件 | 要求 | 你是否有 |
|
||
|---|---|---|
|
||
| **APP 图标** | 512×512 或 1024×1024 正方形，无水印无违规图案 | ✅ 用 `图标/app_icon_1024.png` |
|
||
| **APP 首页截图** | 只展示首页基础功能；**禁止**出现广告弹窗、充值入口、商品交易、付费会员、资讯新闻 | ✅ 需你截一张首页 |
|
||
| **身份证正反面** | 清晰、在有效期内 | ✅ 系统已有（实名时上传过） |
|
||
| **《移动应用备案合规承诺书》** | 备案系统**在线签署**，不用自己准备 | ✅ 系统生成 |
|
||
| **前置审批文件** | 仅金融/医疗/教育/新闻/出版/直播等需要 | ❌ **不需要**（工具类） |
|
||
| **软件著作权证书** | 阿里云 APP 备案**不强制** | ⚠️ 无，见下方说明 |
|
||
|
||
> 💡 **截图的讲究**（个人主体查得更严）：
|
||
> 截图里**不要**出现任何金额数字（比如财务模块的账目）、不要出现真实姓名手机号。
|
||
> 首页如果有"账本余额"之类的数字，建议截图前先把数据清空或打码。
|
||
|
||
---
|
||
|
||
## 七、时间线与流程
|
||
|
||
```
|
||
① 阿里云备案后台 → 已有备案主体 → 新增服务 → 选「移动应用(APP)」
|
||
↓
|
||
② 填上面第一~五节的所有字段 + 上传附件
|
||
↓
|
||
③ 签署《移动应用备案合规承诺书》（在线）
|
||
↓
|
||
④ 提交 → 阿里云初审（1–2 个工作日，会打电话核验）
|
||
↓ ⚠️ 电话一定要接，问的就是"这个 App 干什么用的"
|
||
⑤ 初审通过 → 工信部发短信 → 【24 小时内】完成短信核验
|
||
↓ ⚠️ 超时订单作废，要重新提交
|
||
⑥ 管局审核（1–20 个工作日，多数省约 7 天）
|
||
↓
|
||
⑦ 下发 APP 备案号（形如：鲁ICP备XXXXXXXX号-2A）
|
||
↓
|
||
⑧ 【30 日内】完成公安联网备案（全国互联网安全管理服务平台）
|
||
```
|
||
|
||
### 关键提醒
|
||
|
||
- **工信部短信 24 小时内必须完成核验**，否则订单作废重来。提交后那几天手机别静音。
|
||
- **管局审核期间不要改服务器、不要改域名解析**，否则可能被判"信息不实"驳回。
|
||
- **公安联网备案是独立的第二步**，拿到 ICP 备案号后 30 日内必须在
|
||
https://beian.mps.gov.cn 单独做，不做会被抽查下架。
|
||
|
||
---
|
||
|
||
## 八、软著问题：目前没有「家书」软著
|
||
|
||
### 现状核实
|
||
|
||
你名下有 6 项软著（`memory/profile/05-软著.md`）：
|
||
|
||
| 软件名称 | 登记号 | 与家书有关？ |
|
||
|---|---|---|
|
||
| 渤海生态系统关键要素存储管理系统 | 2025SR2443329 | ❌ 无关 |
|
||
| 渤海生态系统关键要素时空检索系统 | 2025SR1286975 | ❌ 无关 |
|
||
| 云任务调度仿真系统 | 2024SR0768026 | ❌ 无关 |
|
||
| 雾计算调度部署仿真系统 | 2022SR1052757 | ❌ 无关 |
|
||
| 海洋大数据云服务平台任务调度系统 | 2021SR0710102 | ❌ 无关 |
|
||
| 海洋大数据云服务平台 | 2021SR0401836 | ❌ 无关 |
|
||
|
||
**结论：没有「家书」的软著。**
|
||
|
||
### 影响与对策
|
||
|
||
| 场景 | 是否必须软著 | 对策 |
|
||
|---|---|---|
|
||
| **阿里云 APP 备案** | ❌ 不强制 | 直接提交，无需软著 |
|
||
| **华为 AppGallery 上架** | ⚠️ 官方要求，但**未取得时可下载华为《免责函》加盖公章上传** | 见下 |
|
||
|
||
### 华为上架的软著处理（两条路）
|
||
|
||
**路线 A：走免责函（快，1 天）**
|
||
|
||
1. 在 AGC 提审页面找到「软件著作权」材料项
|
||
2. 下载华为提供的**《免责函》模板**
|
||
3. 填写并**签名**（个人开发者手写签名 + 按手印/身份证号）
|
||
4. 扫描上传
|
||
|
||
> ⚠️ 免责函不是永久通行证。华为可能要求"后续补交软著"。个人开发者用免责函过审是常见做法，
|
||
> 但不是 100% 保证，看审核员。
|
||
|
||
**路线 B：申请「家书」软著（稳，约 1–3 个月）**
|
||
|
||
| 项 | 说明 |
|
||
|---|---|
|
||
| 渠道 | 中国版权保护中心 https://www.ccopyright.com.cn |
|
||
| 名称 | 建议与商店名一致：**家书家庭生活档案管理软件**（软件全称含"家书"，简称"家书"） |
|
||
| 材料 | 源代码前后各 30 页（共 60 页）+ 用户手册 + 申请表 + 身份证 |
|
||
| 费用 | 官方登记免费（自行申请）；加急/代办另计 |
|
||
| 周期 | 普通 **30–60 个工作日**；加急可缩到几天（要钱） |
|
||
| 著作权人 | **杨永全**（个人，与开发者账号主体一致） |
|
||
|
||
> 💡 **建议**：先用路线 A 提交上架，同时并行申请路线 B。
|
||
> 软著是长期资产，以后上别的安卓市场（小米/OPPO/vivo/应用宝）**全部强制要**，早办早省事。
|
||
|
||
### 🔴 三处名称必须一致
|
||
|
||
```
|
||
华为后台应用名称 = 桌面显示名 = （将来）软著上的软件名称简称
|
||
家书 = 家书 = 家书
|
||
```
|
||
|
||
不一致是高频驳回点，改名成本极高（应用名上架后基本改不了）。
|
||
|
||
---
|
||
|
||
## 九、提交前自检清单
|
||
|
||
- ☐ 服务器确认是**包年包月**（或已开自动续费 ≥3 个月），不是按量付费
|
||
- ☐ `family.yangyq.net` 的 **ICP 网站备案**已完成（若未做，同订单一起提）
|
||
- ☐ 已拿到**正式发布证书**，已提取公钥与 MD5（MD5 **已去冒号**）
|
||
- ☐ 包名确认为 `familybook.yangyq.net`
|
||
- ☐ APP 名称填「家书」，与商店一致
|
||
- ☐ 图标是 1024×1024 正方形，无水印
|
||
- ☐ 首页截图**不含**金额/真实姓名/手机号/广告/充值入口
|
||
- ☐ 内容分类选 **生活服务 → 工具**
|
||
- ☐ 「是否对外提供 SDK」填 **否**
|
||
- ☐ 后台服务域名只填 `family.yangyq.net`（不带 https/www）
|
||
- ☐ 服务器所在地填**机房省份**（不是家庭住址省份）
|
||
- ☐ 上线渠道勾**华为应用市场**
|
||
- ☐ 提交后手机保持畅通，**工信部短信 24 小时内完成核验**
|
||
- ☐ 拿到备案号后 **30 日内**做公安联网备案
|
||
|
||
---
|
||
|
||
## 十、备案号到手后填到哪
|
||
|
||
| 地方 | 怎么填 |
|
||
|---|---|
|
||
| **华为 AppGallery 提审** | 「APP 备案号」字段，填 `鲁ICP备XXXXXXXX号-2AX` |
|
||
| **应用内** | `设置 → 关于` 展示备案号（合规要求，建议做） |
|
||
| **网站页脚** | `family.yangyq.net` 页面底部展示 |
|
||
|
||
> 备案号格式：`<省份简称>ICP备<8位数字>号-<序号><A或空>`
|
||
> 例：`鲁ICP备2026012345号-3A`（A 表示 APP）
|
||
|
||
---
|
||
|
||
## 十一、常见驳回原因（提前避开）
|
||
|
||
| 驳回原因 | 怎么避免 |
|
||
|---|---|
|
||
| APP 名称与商店/桌面名称不一致 | 三处统一「家书」 |
|
||
| 截图含广告/充值/资讯/金额 | 只放首页，先清空敏感数据 |
|
||
| 服务器不符合备案要求（按量付费） | 提交前先改包年包月 |
|
||
| 域名未备案 / 与主体不一致 | 先确认 `family.yangyq.net` 已备案在同一主体 |
|
||
| MD5 带冒号或位数不对 | 去冒号、确认 32 位 |
|
||
| 包名与上架包不一致 | 从 `app.json5` 直接复制，别手打 |
|
||
| 类目选了需要前置审批的（金融/医疗等） | 个人主体只能选工具/记事本这类 |
|
||
| 工信部短信超 24 小时未核验 | 提交后手机别静音，每天看短信 |
|
||
| 审核电话没接 | 提交后 3 天内保持电话畅通 | |