👋 你好,欢迎来到我的博客!我是【菜鸟学鸿蒙】
   我是一名在路上的移动端开发者,正从传统“小码农”转向鸿蒙原生开发的进阶之旅。为了把学习过的知识沉淀下来,也为了和更多同路人互相启发,我决定把探索 HarmonyOS 的过程都记录在这里。
  
  🛠️ 主要方向:ArkTS 语言基础、HarmonyOS 原生应用(Stage 模型、UIAbility/ServiceAbility)、分布式能力与软总线、元服务/卡片、应用签名与上架、性能与内存优化、项目实战,以及 Android → 鸿蒙的迁移踩坑与复盘。
  🧭 内容节奏:从基础到实战——小示例拆解框架认知、专项优化手记、实战项目拆包、面试题思考与复盘,让每篇都有可落地的代码与方法论。
  💡 我相信:写作是把知识内化的过程,分享是让生态更繁荣的方式。
  
   如果你也想拥抱鸿蒙、热爱成长,欢迎关注我,一起交流进步!🚀

前言

应用提交 AppGallery Connect 审核,被退回的理由五花八门,但其中有一类问题集中度很高——隐私政策与实际数据行为不一致。具体来说,不是开发者自己写的功能漏写了,而是接入的第三方 SDK 在背后悄悄收集数据,隐私政策里却只字未提。

这篇文章整理一套在上架前把三方 SDK 隐私问题过一遍的流程,方法可以直接复用。

一、为什么三方 SDK 是审核高频检查点

AppGallery Connect 在应用审核环节会对隐私政策进行人工核查,重点之一是:应用的隐私政策是否如实披露了所有实际采集的数据类型及用途。

问题在于,开发者往往只在意自己写的代码,而忽略了接入的三方 SDK 也是应用行为的一部分。

一个典型场景:你接入了某个推送 SDK,它在初始化时会读取设备标识符(OAID 或其他);或者你引入了一个统计分析 SDK,它默认会采集设备型号、系统版本、网络状态等信息。这些采集行为,在这些 SDK 的隐私声明里有规定,但如果你的应用隐私政策没有同步覆盖,审核就会判定两者不一致。

从审核规则来看,AppGallery Connect 的审核要求明确:应用需要在隐私政策中告知用户个人信息的收集范围、用途、处理方式,三方 SDK 的数据行为同属应用责任范围,不能以"那是 SDK 自己的事"为由省略。

二、先把工程依赖盘出来

在处理隐私政策之前,第一步是弄清楚工程里到底用了哪些三方库。

HarmonyOS 工程依赖统一在 oh-package.json5 中管理。打开项目根目录或各模块下的 oh-package.json5,dependencies 字段列出了所有运行时依赖:

// oh-package.json5(示例结构,字段取自官方文档规范)
{
  "name": "your_app",
  "version": "1.0.0",
  "dependencies": {
    "@ohos/axios": "2.2.0",
    "某推送SDK": "x.x.x",
    "某统计SDK": "x.x.x"
  },
  "devDependencies": {
    "@ohos/hypium": "1.0.16"
  }
}

devDependencies 里是开发/测试专用依赖,不参与最终打包,不需要纳入隐私排查范围。dependencies 里的每一条,才是真正需要逐个核查的对象。

如果工程包含多个 Module(entry、feature、har 等),每个 Module 下都可能有自己的 oh-package.json5,需要逐个检查,不要只看根目录这一份。

另外,如果工程里通过本地路径引入了 .har 包,要额外注意:这类本地包同样可能封装了有数据采集行为的 SDK,需要找到对应 SDK 的原始来源和文档。

三、找到每个 SDK 的官方隐私声明

整理出依赖列表后,针对每一个三方 SDK,去它的官方渠道找隐私声明。

一般来说,正规 SDK 会在以下位置披露隐私信息:

  • 官方接入文档中包含一节"数据处理说明"或"隐私合规说明"
  • 独立的 SDK 隐私政策页面,接入指南里通常有链接
  • OHPM 仓库页面上有时也会附上合规说明入口

以华为自家的 SDK 举例,推送服务(Push Kit)、分析服务(Analytics Kit)等官方 Kit 都在华为开发者联盟文档中提供了专门的隐私说明章节,明确列出采集的数据类型和用途。非华为 SDK 同理,建议直接访问 SDK 提供商的官方网站或 Gitee/GitHub 官方仓库的说明文档,不要参考第三方整理的博客。

找到声明之后,重点关注以下四类信息:

需要摘录的内容说明
采集的数据类型设备标识、位置信息、账号信息、日志等
采集目的推送、统计、广告定向等
数据处理方式本地处理 / 上传至服务器 / 共享给第三方
数据存储与保留周期是否跨境传输、保存多久

四、把 SDK 数据行为映射到自己的隐私政策

这一步是整个流程中最需要耐心的部分。

实际上,很多开发者的隐私政策是从模板改出来的,描述的是应用自身业务的数据行为。三方 SDK 的数据行为需要额外补充进去,通常有两种处理方式:

方式一:在"第三方 SDK 目录"章节中单独列出

这是比较推荐的结构。在隐私政策里单独开一节,按照 SDK 名称逐条列出:SDK 名称、提供方、数据类型、用途,并附上该 SDK 的隐私政策链接。

示例结构(文本,不是代码):

三方 SDK 目录

1. [SDK 名称]
   提供方:XXX公司
   采集数据类型:设备标识符、网络状态
   使用目的:消息推送
   SDK 隐私政策:https://...(SDK 官方链接)

2. [SDK 名称]
   提供方:XXX公司
   采集数据类型:操作日志、设备型号
   使用目的:崩溃分析
   SDK 隐私政策:https://...(SDK 官方链接)

方式二:合并到对应数据类型的描述中

在"我们如何收集您的个人信息"章节里,对于每一种数据类型,标注这个类型是由应用自身采集还是由某个三方 SDK 采集,并注明用途。

两种方式都被接受,但方式一对用户和审核人员来说可读性更好,也更容易逐条核对。

五、映射时的三个关键问题

数据类型的描述要和 SDK 声明对齐

不要把 SDK 声明的"设备标识符(OAID)“在自己的隐私政策里写成泛化的"设备信息”。审核时会要求两者能够对应,描述过于笼统容易被判定为不符。

权限和数据采集要一起看

module.json5 里的 requestPermissions 字段列出了应用声明的权限。某些三方 SDK 在接入时会要求你在 module.json5 里增加特定权限声明,这些权限背后的数据访问行为同样需要在隐私政策里体现。

// module.json5 中的权限声明节选(结构示意)
{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.GET_NETWORK_INFO",
        "reason": "$string:reason_network",
        "usedScene": {
          "when": "inuse"
        }
      }
    ]
  }
}

在检查隐私政策时,建议把 requestPermissions 里的每一条权限都过一遍,确认它对应的数据行为在隐私政策中有明确说明。

共享给第三方这一条不能省

如果 SDK 会把数据上传到其服务器或分享给其他方,这属于"个人信息共享",在隐私政策里需要单独披露,不能混在"使用目的"里一笔带过。

六、容易忽略的几个地方

忽略动态接入的 SDK

有时候 SDK 不是直接写进 oh-package.json5,而是以本地 .har 的形式引入,dependencies 里写的是本地路径。这类情况需要手动找到这个 .har 的来源,确认它是哪个 SDK 的哪个版本,再去找对应的隐私声明。

SDK 版本升级后数据行为可能变化

SDK 更新版本之后,采集的数据类型有时会有变化。如果工程里的 SDK 版本从上次上架到现在有过更新,建议重新确认一下新版本的隐私声明,再对照隐私政策看是否需要同步修改。

隐私政策 URL 要可以公开访问

AppGallery Connect 在提交时要求填写隐私政策 URL,这个链接在应用上架后是公开的。有些开发者把隐私政策页面做成了登录后才能访问的内页,这会导致审核无法访问,直接被退回。

七、上架前的最终比对清单

可以按照下面这个顺序在提交前过一遍:

  1. 打开 oh-package.json5,列出所有 dependencies 条目
  2. 检查各 Module 是否有独立的 oh-package.json5,不遗漏任何模块
  3. 检查工程内有无本地 .har 引用,找到它对应的 SDK 来源
  4. 打开 module.json5,逐条过 requestPermissions,确认每条权限的数据用途在隐私政策中都有覆盖
  5. 访问每个 SDK 的官方隐私声明,摘录数据类型、目的、处理方式
  6. 在隐私政策文本中搜索每个 SDK 名称,确认已经列入"第三方 SDK 目录"
  7. 比对数据类型描述,确认隐私政策中的描述与 SDK 声明中的用词基本对应,没有过度简化
  8. 访问隐私政策 URL 本身,确认链接可以在未登录状态下正常打开
  9. 确认隐私政策版本日期已更新,如果本次新增了 SDK,日期要同步更新

开发经验总结

  • 三方 SDK 的数据行为属于应用整体的数据行为,责任边界不因"那是 SDK 做的"而转移,隐私政策需要完整覆盖
  • oh-package.json5 是依赖盘点的核心入口,多 Module 工程需要逐一检查每个 Module 目录
  • 本地 .har 引入的 SDK 最容易被遗漏,因为它不直接显示 SDK 名称,需要手动追溯来源
  • 权限声明(requestPermissions)和隐私政策应该互相对照,不应出现"权限已声明但隐私政策中未提及"的情况
  • 隐私政策 URL 必须在未登录状态下可公开访问,这是基本要求但确实容易被忽略

如果你的工程里有超过 5 个三方 SDK,可以考虑维护一个独立的 SDK 台账表格,记录 SDK 名称、版本、采集数据类型、官方隐私声明链接,每次版本更新前先更新这张表,再同步更新隐私政策,整个流程会更可控。

📝 写在最后

如果你觉得这篇文章对你有帮助,或者有任何想法、建议,欢迎在评论区留言交流!你的每一个点赞 👍、收藏 ⭐、关注 ❤️,都是我持续更新的最大动力!

我是一个在代码世界里不断摸索的小码农,愿我们都能在成长的路上越走越远,越学越强!

感谢你的阅读,我们下篇文章再见~👋

✍️ 作者:菜鸟不学编程
🧵 本文原创,转载请注明出处。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐