Files
FamilyBook_harmonyos/docs/上架/商店上架文案.md
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

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