鸿蒙 PC 桌面端应用上架实战:版控代码管理因"名称相似"驳回后改名 12 处,却发现提审包里是 12 天前的构建

欢迎加入开源鸿蒙 PC 社区:https://harmonypc.csdn.net/

欢迎在 PC 社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

AtomGit 仓库地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_TortoiseSVN

在这里插入图片描述
在这里插入图片描述


这个应用的第一版名字叫"版控 SVN 客户端"。审核驳回,理由指向名称:与"SVN 客户端"这类既有名称构成相似。

我当时的反应是不服气。SVN 是 Apache Subversion 的通用缩写,全世界的工具都在用,一个"版控"前缀已经足够区分了,怎么会因为一个缩写被拦下来。

后来把驳回意见与几条同类案例放在一起看,才明白问题不在"SVN 是不是通用",而在名字的构成方式:功能词 + 技术缩写 + 品类后缀,把三段里最没有区分度的两段拼在了一起。缩写不因为通用而豁免,"客户端"这三个字更是把品类直接写死在名字里。审核看的是这个名字能不能与既有产品区分,不是这个词在技术上是否通用。

于是改名:版控代码管理。六个字的功能描述,不带任何缩写,不带品类后缀。

改名本身只花了半小时,12 处。真正花时间的是改名之后的两个问题:

  1. 要不要重新签名? 答案是不用,包名没动,签名绑的是包名与证书,不是显示名;
  2. 要不要重新打包? 答案是必须,因为显示名在包里是资源,不是签名。

而第二个问题又牵出一个更麻烦的事实:构建产物目录里躺着三个同名的 hap——两份 10-15 的中间产物(一份在输出目录、一份已经嵌进 .app),外加一份 10-27 重打的包;而提审要交的是外层 .app,那个 .app 是 10-15 打的。

这一篇就把这条链走完:改名半径怎么数、为什么不必重签、为什么必须重打包、以及怎么用三条证据认出"哪个包能提审"。


一、驳回针对的是一类词,不是一个名字

先把结论摆出来,因为它决定后面所有动作的边界。

名称驳回通常不是"这个词不能用",而是"这个组合无法区分"。把这类名字拆开,会看到三段结构:

段例子区分度审核风险
功能词版控、代码、仓库中低,但单独用太泛
技术缩写SVN、Git、PLC、CAD低高,属于他人商标或行业通用名
品类后缀客户端、编辑器、工具、助手极低高,等于自报品类

第一版名字三段里有两段是高风险的,唯一有区分度的"版控"又太泛。这种结构在审核眼里等价于"没有自己的名字"。

改名后的"版控代码管理"只保留功能词,去掉了缩写与品类后缀。它听起来不像一个产品名,更像一个功能模块名——而这恰好是通过审核需要的形态:不暗示与任何既有产品的关系。

这条经验可以带走一句:名字里的技术缩写不因为通用而豁免,品类后缀不因为常见而安全。 判断一个名字危险不危险,不看它是否"准确",看它是否"只描述自己"。

【配图位 2:新旧名称对照。左侧把"版控 SVN 客户端"按功能词 / 技术缩写 / 品类后缀三段拆开标注,右侧放改名后的资源文件截图(四份 string.json 的值逐行对齐),直观看到"版控 SVN 客户端"与"版控代码管理"在构成上的差别。】


二、工程速览:六个文件,86 KB,一个自研 WebDAV 引擎

版控代码管理(包名 com.wei.bankongsvn)是一个跑在鸿蒙 PC 上的代码仓库浏览与版本对比工具。它不调用任何 SVN 命令行,也不依赖任何第三方库,HTTP/WebDAV 请求、目录遍历、日志解析、行级差异对比全部是自己写的 JavaScript。

业务代码是平铺的五个文件,另有一份样式表:

  index.html                 5998 B  crlf=123   lf=123  
  main.js                   14058 B  crlf=348   lf=348  
  package.json                211 B  crlf=8     lf=8    
  renderer.js               24741 B  crlf=644   lf=644  
  svn-engine.js             26231 B  crlf=734   lf=734  
  合计 71239 字节

五个文件 71,239 字节,加上 styles/tortoise.css 的 14,945 字节,一共 86,184 字节。这个体量在 Electron 壳工程里算小的,原因是它没有打包任何运行时:不用 React,不用 Monaco,编辑器是高亮层叠在 textarea 上的老办法,差异对比是自己实现的行级 LCS。

引擎的入口是 svn-engine.js,头两行就把职责写清楚了:

// 版控代码管理 引擎
// 职责:仓库 URL 校验 + 版本路径构建 + 行级 LCS diff(真实算法)+ 日志日期格式化

// ========== 仓库 URL 校验 ==========
function validateRepoUrl(urlStr) {
  var trimmed = String(urlStr || '').trim();
  if (!trimmed) return { valid: false, error: '仓库地址为空' };
  if (!/^https?:\/\//i.test(trimmed)) {
    return { valid: false, error: '仅支持 http:// 或 https:// 协议的 SVN 仓库(svn:// 协议需 svnserve,Web 壳不支持)' };
  }
  try {
    var u = new URL(trimmed);
    if (!u.hostname) return { valid: false, error: 'URL 缺少主机名' };
    return { valid: true, origin: u.origin, path: u.pathname };

第一段校验里有一句值得注意:只接受 http 与 https,svn:// 协议直接拒绝,理由是"需要 svnserve,Web 壳不支持"。这是一句诚实的边界声明——它没有假装支持全部 SVN 协议,而是把能力边界写在错误提示里。

这个工程的身份配置也很朴素:bundleName com.wei.bankongsvn,versionCode 1000000,versionName 1.0.0,minAPIVersion 50005017,targetAPIVersion 60000020,deviceTypes 是 2in1 与 tablet。注意包名里那个 svn——它一直没改,这一点在第五节会成为关键。


三、名字从哪来:一处引用,四份资源

改名前先要搞清楚:界面上那个名字,到底由几个文件决定。

很多人以为改 AppScope 里的 app_name 就够了。实际不止。这个工程里,应用名出现在两类地方:

第一类是资源。四份 string.json:

文件键值
AppScope/resources/base/element/string.jsonapp_name版控代码管理
electron/src/main/resources/base/element/string.jsonEntryAbility_label版控代码管理
electron/src/main/resources/en_US/element/string.jsonEntryAbility_label版控代码管理
electron/src/main/resources/zh_CN/element/string.jsonEntryAbility_label版控代码管理

第二类是引用:

  app.json5 L3   "bundleName": "com.wei.bankongsvn",
  app.json5 L4   "vendor": "wei",
  app.json5 L5   "versionCode": 1000000,
  app.json5 L6   "versionName": "1.0.0",
  app.json5 L7   "icon": "$media:app_icon",
  app.json5 L8   "label": "$string:app_name",
  web_engine/src/main/module.json5  label 行 0
  electron/src/main/module.json5  label 行 1
     L27   "label": "$string:EntryAbility_label",

AppScope 的 app.json5 用 $string:app_name 取应用级名称;electron 的 module.json5 第 27 行用 $string:EntryAbility_label 取入口 ability 的名称。系统桌面上显示的那个名字,来自后者;设置里应用详情页显示的那个名字,来自前者。

这就是"改一处不够"的原因:同一个事实存了四份,其余位置都是引用。 四份里任何一份没改,对应语言或对应层级就会露出旧名。

这里还有一个我改的时候才发现的小问题:en_US 那份 string.json 里,EntryAbility_label 的值也是中文"版控代码管理"。三套语言资源同值,说明这个应用并没有真正做本地化,只是把同一句话抄了三遍。抄三遍的代价不是难看,是改的时候要记得改三遍。

同一份 base/string.json 里还有两个 label 没被处理:

BrowserAbility_label : BrowserAbility
StatelessAbility_label : StatelessAbility

它们不在应用名上,但 StatelessAbility 是 exported 的,理论上会出现在系统的一些多窗口或任务界面里。这两条我留在了待办里(第十二节),没在这一轮动——它们不是这次驳回的原因,改它们属于顺手扩面,容易把一次改名做成一次重构。


四、12 处改名清单:四类落点

改完之后逐处核对,一共 12 处,分四类:

类位置处数是否可见
资源4 份 string.json(AppScope 1 + electron 3)4是(桌面图标名与设置页)
界面index.html 的 title、工具栏品牌、关于弹窗标题3是(应用内三处)
代码头注释main.js、renderer.js、svn-engine.js、styles/tortoise.css4否(只有读源码才看得到)
包描述package.json 的 description1否(只有包元数据里看得到)

完整的扫描输出是这样:

  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L1    # 鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发
  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L3    版控代码管理是一款纯 JavaScript 实现的 SVN 代码仓库浏览与版本对比工具,提供 HTTP/WebDAV PROPFIND 目录浏览、REPOR
  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L24   | 对比项     | 传统 SVN 客户端(TortoiseSVN / svn 命令行) | 鸿蒙适配版(版控代码管理)                 
  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L103  | 应用名称     | 版控代码管理              | 中文显示名            |
  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L1135 **解决:** 将应用名称改为「版控代码管理」,去掉 SVN 字样。bundleName 保持 com.wei.bankongsvn 不变(内部标识不影响审
  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L1139 本文完整记录了在鸿蒙 PC 平台上适配版控代码管理的全过程。通过 Electron 壳方案,我们实现了一个纯 JavaScript 的 SVN 代码仓库浏览
  AppScope\resources\base\element\string.json                            L5    "value": "版控代码管理"
  electron\src\main\resources\base\element\string.json                   L13   "value": "版控代码管理"
  electron\src\main\resources\en_US\element\string.json                  L13   "value": "版控代码管理"
  electron\src\main\resources\zh_CN\element\string.json                  L13   "value": "版控代码管理"
  web_engine\src\main\resources\resfile\resources\app\index.html         L5    <title>版控代码管理</title>
  web_engine\src\main\resources\resfile\resources\app\index.html         L11   <div class="toolbar-brand">版控代码管理</div>
  web_engine\src\main\resources\resfile\resources\app\index.html         L105  <div class="dialog-title">关于 版控代码管理</div>
  web_engine\src\main\resources\resfile\resources\app\main.js            L1    // 版控代码管理 主进程
  web_engine\src\main\resources\resfile\resources\app\package.json       L4    "description": "版控代码管理 - 鸿蒙应用(仓库浏览 + 版本对比)",
  web_engine\src\main\resources\resfile\resources\app\renderer.js        L1    // 版控代码管理 渲染进程
  web_engine\src\main\resources\resfile\resources\app\svn-engine.js      L1    // 版控代码管理 引擎
  web_engine\src\main\resources\resfile\resources\app\styles\tortoise.css L1    /* 版控代码管理 Catppuccin Mocha 深色主题 */
  合计 18 处

18 处命中里有 6 处在仓库内那份适配文章 md 里——那是历史记录,写的是"改名"这件事本身,属于该留的。源码侧的 12 处与上表一致。

再看旧名:

  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L24   | 对比项     | 传统 SVN 客户端(TortoiseSVN / svn 命令行) | 鸿蒙适配版(版控代码管理)                 
  鸿蒙平台版控代码管理适配实战:基于 Electron 壳方案的纯 JavaScript SVN WebDAV 引擎与 LCS 差异对比算法开发.md L1131 **问题现象:** AGC 审核驳回,应用名称「版控 SVN 客户端」中 SVN 为 Apache Subversion 商标名称。
  源树合计 2 处

两处,全在那份 md 里(记录驳回原因时引用了旧名),源码零残留。

这张对照表说明了改名的正确顺序:先改资源(决定系统显示),再改界面(决定用户看到),最后改注释与描述(决定下一个接手的人怎么理解)。 反过来做也生效,但要多一遍返工,因为资源里的旧名会让所有本地检查都显示"没改干净"。


五、为什么不用重签:签名绑的是包名,不是显示名

改名之后第一个问题是签名。

直觉上,"应用的名字变了"应该算重大变更,签名要重做。实际不用。原因是签名绑定的对象里没有显示名这一项:

  • 证书绑的是 bundleName 与证书主体;
  • Profile 里的 acls、权限、设备列表绑的也是 bundleName;
  • 显示名(app_name / EntryAbility_label)是资源,编译进 resources.index,不参与签名计算。

这个工程的 bundleName 一直是 com.wei.bankongsvn——里面明明白白带着 svn 三个字母。改名时我没有动它,也不建议动:

  1. 包名是内部标识,不进审核的名称面;
  2. 改包名等于换一个应用,旧版本的升级路径、已安装用户、签名关联全部要重做;
  3. 包名里的 svn 属于"内部标识使用",与"对外名称使用"是两件事。

包内证据能直接看到这一点:

  hap 条目数 : 28
  app.bundleName       com.wei.bankongsvn
  app.versionCode      1000000
  app.versionName      1.0.0
  app.label            $string:app_name
  app.icon             $media:app_icon
  app.minAPIVersion    50005017
  app.targetAPIVersion 60000020
  buildMode      : release
  debug          : False
  包内权限条目   : 14
  包内 app 资源文件 : 6
     index.html                                                   5998 B
     main.js                                                     14058 B
     package.json                                                  211 B
     renderer.js                                                 24741 B
     styles/tortoise.css                                         14945 B
     svn-engine.js                                               26231 B

这段输出要读三行:

  • app.bundleName 是 com.wei.bankongsvn,带着 svn;
  • app.versionCode 是 1000000,versionName 是 1.0.0;
  • app.label 是 $string:app_name,是一个引用,不是字符串。

也就是说:包里根本没有"版控代码管理"这六个字,只有一句"去 app_name 里取"。 名字的实际值在 AppScope 的 string.json 里,编译进 resources.index。改 string.json 不需要重签,因为它不在签名覆盖的字段里。

这条判据很实用:判断一次改动要不要重签,看它是否落在 bundleName、证书、Profile 这三样上。 落在资源、界面、注释上的改动,一律不需要重签,但一律需要重新打包。

【配图位 3:12 处改名清单的落屏。把第四节的四类表做成一张对照图,左侧列"资源 4 / 界面 3 / 注释 4 / 描述 1",右侧用 grep 结果截图证明旧名在源码里为 0。】


六、必须重打包:包里的字节才是提审物

不用重签,但必须重打包。这一步没得省,因为审核看的是包,不是工程。

先确认"包里的资源就是磁盘上的资源":

  index.html             包    5998 B crc=e0f899b5 | 盘    5998 B crc=e0f899b5 | 相同 True
  main.js                包   14058 B crc=35038ab9 | 盘   14058 B crc=35038ab9 | 相同 True
  renderer.js            包   24741 B crc=749a562f | 盘   24741 B crc=749a562f | 相同 True
  svn-engine.js          包   26231 B crc=47ddbb69 | 盘   26231 B crc=47ddbb69 | 相同 True
  package.json           包     211 B crc=5275f246 | 盘     211 B crc=5275f246 | 相同 True
  styles/tortoise.css    包   14945 B crc=46f26428 | 盘   14945 B crc=46f26428 | 相同 True

六个文件,包内与磁盘的字节数、CRC32 全部相同。这说明这个工程的打包流程没有做任何资源改写或压缩变换,resfile 下的文件是原样进包的。

再看包内的名字:

  版控代码管理           包内 3 次
  版控 SVN 客户端       包内 0 次
  SVN 客户端          包内 0 次
  Apache Subversion 包内 1 次
  TortoiseSVN      包内 1 次
  Apache-2.0       包内 1 次
  不包含任何网络传输        包内 0 次

这七行里,前六行是这一节的核心:

  • 新名在包内出现 3 次(title、工具栏、关于弹窗标题),与磁盘一致;
  • 旧名两次计数都是 0——包内没有任何旧名残留;
  • Apache Subversion 与 TortoiseSVN 各 1 次,它们是关于弹窗里的致谢,属于该留(第七节讲);
  • Apache-2.0 1 次,是开源许可证声明。

第七行是对一个并不存在于本文表述里的句子做负向匹配,结果为 0,没有信息量,属于探针噪音,不构成结论。

也就是说,10-15 那个包里装的是"已经改好名字"的版本。这看起来是好消息,但它同时提出了一个新问题:如果 10-15 的包是对的,那 10-27 又出的那个同名 hap 是什么?

这个问题留到第十节。先把关于弹窗里的边界讲清楚。


七、关于弹窗:功能描述去掉 SVN,致谢留下来

改名这件事最容易走偏的一步,是把"SVN"从整个应用里扫干净——包括致谢。那样做会同时踩两个坑:一是冒认来源,二是丢掉技术出处。

这个工程的处理是分开的:

  <!-- 关于对话框(开源信息) -->
  <div class="dialog-layer hidden" id="aboutDialogLayer">
    <div class="dialog-box">
      <div class="dialog-title">关于 版控代码管理</div>
      <div class="dialog-body about-body">
        <h3>开源声明</h3>
        <p>本应用是运行于鸿蒙 PC 的 Electron 壳应用(Electron 基于 MIT 协议开源),提供代码仓库浏览、文件查看、版本日志与版本对比功能。HTTP/WebDAV 协议请求引擎与 LCS 差异对比算法均使用 JavaScript 独立实现;交互设计参考 Apache Subversion 协议规范与 TortoiseSVN 等开源客户端的通用使用习惯,全部代码独立编写,不包含其任何源代码,在此谨向原作者与开源社区致谢。</p>
        <h3>免责声明</h3>
        <p>本应用仅通过 HTTP/WebDAV 协议浏览与查看代码仓库内容,请遵守目标仓库的使用条款;连接配置(含密码)仅保存在设备本地,不会上传至任何服务器。使用者应自行承担因使用本应用产生的风险与后果。</p>
        <h3>完全开源</h3>
        <p>本项目代码完全开源,遵循 Apache-2.0 开源许可证。欢迎社区贡献代码、报告问题或提出功能建议。</p>

三段式:开源声明、免责声明、完全开源。三段的措辞边界很清楚:

  • 功能描述用"代码仓库浏览、文件查看、版本日志与版本对比",一个 SVN 都不出现;
  • 技术出处用"交互设计参考 Apache Subversion 协议规范与 TortoiseSVN 等开源客户端的通用使用习惯",并在同一句里补上"全部代码独立编写,不包含其任何源代码";
  • 许可证声明写 Apache-2.0。

这就是商标的两种用法:

用法例子审核态度本工程做法
命名性使用应用叫"版控 SVN 客户端"高风险,等于自称是某产品的客户端已改掉
描述性使用“参考 Apache Subversion 协议规范”通常允许,须注明不隶属保留,并补"不包含源代码"

这条边界值得记住:商标可以出现在"说明我从哪来"的句子里,不能出现在"我叫什么"的位置上。 前者是引用,后者是冒用。

顺带说一句,"不包含其任何源代码"这半句不是客套。这个应用的 WebDAV 引擎与 LCS 差异算法确实是独立实现的(第二节那张文件表里没有任何第三方文件),写这句话是有底气的。如果代码里混了上游源码,这句话就变成了风险点——致谢里的每一句自我声明,都必须能被代码验证。


八、密码落盘:一句真话,但不完整

关于弹窗的免责声明里有一句:

连接配置(含密码)仅保存在设备本地,不会上传至任何服务器。

这句话是真的。但它不完整,而"不完整"在安全语境里比"假"更麻烦——用户读完会以为密码是被保护的。

看落盘路径:

// 移除应用级默认菜单栏(File/Edit/View/Window/Help)
Menu.setApplicationMenu(null);

var mainWindow = null;

// 连接配置持久化
var connections = [];
var configPath = path.join(app.getPath('userData'), 'bankongsvn-connections.json');

L25 把配置文件放在 userData 下,文件名 bankongsvn-connections.json。再看写入:

main.js L330  connections[existing].password = conn.password || '';
main.js L337  password: conn.password || ''

直接赋值,没有任何加密。整份 connections 数组被 JSON.stringify 之后写进那个文件(L50),密码字段就是明文。

认证方式是 HTTP Basic:

  if (maxRedirects === undefined) maxRedirects = 5;
  return new Promise(function(resolve, reject) {
    var url = new URL(urlPath, conn.serverUrl);
    var client = url.protocol === 'https:' ? https : http;
    var reqHeaders = { 'User-Agent': 'BankongSVN-OHOS/1.0' };
    var keys = Object.keys(headers);
    for (var i = 0; i < keys.length; i++) reqHeaders[keys[i]] = headers[keys[i]];
    if (conn.username) {
      var auth = Buffer.from(conn.username + ':' + (conn.password || '')).toString('base64');
      reqHeaders['Authorization'] = 'Basic ' + auth;
    }

L91-92 把 username 和 password 拼起来做 base64 塞进 Authorization 头。Basic 认证本身没问题——在 https 下它是标准做法,base64 只是编码不是加密,安全性由 TLS 保证。真正的问题只有一个:密码在本机是明文落盘的。

Electron 壳工程通常的做法是:主进程用 safeStorage 加密后再落盘、排除 basic_text 这类明文后端、界面上只回显前 3 后 4 的掩码、出站文本过一遍脱敏。这几件事都不依赖鸿蒙额外提供能力,Electron 的 API 本来就摆在那里。所以这不是"平台不支持",是"这个工程没做"。

所以免责声明那句话应当补全成:“连接配置保存在本机配置文件中,密码以明文存储,请勿在共享设备上保存生产环境凭据。”——把真相说完,比说一半更安全。

这一条我已经列进待办(第十二节第 5 条),本轮没有动代码:它不属于这次驳回的范围,改它需要连带改设置界面与迁移逻辑,属于另一次迭代。


九、权限 15 行,不等于 15 项

改名之外,这个工程还留着一个计数口径的坑。

先看源码:

  命中行 15
  第一条 "name": "ohos.permission.INTERNET"
  最后一条 "name": "ohos.permission.LOCK_WINDOW_CURSOR"
  definePermissions 块出现 1 次
  LOCK_WINDOW_CURSOR 出现 2 次

15 行命中,第一行 INTERNET,最后一行 LOCK_WINDOW_CURSOR。如果直接把 15 当成权限数量报出去,就错了。

拆开看:14 条是 requestPermissions 里的申请项,第 15 行是 definePermissions 块里的定义——名字也叫 LOCK_WINDOW_CURSOR,所以同一个字符串在文件里出现了两次:

  electron/src/main/module.json5         keys=['abilities', 'actions', 'deliveryWithInstall', 'description', 'deviceTypes', 'entities', 'exported', 'extensionAbilities', 'icon', 'installationFree', 'label', 'launchType', 'mainElement', 'metadata', 'module', 'name', 'pages', 'process', 'removeMissionAfterTerminate', 'scheme', 'skills', 'srcEntry', 'startWindowBackground', 'startWindowIcon', 'type', 'uris', 'value']
     requestPermissions 出现 0 次 / definePermissions 0 次
  web_engine/src/main/module.json5       keys=['definePermissions', 'deviceTypes', 'module', 'name', 'requestPermissions', 'type']
     requestPermissions 出现 2 次 / definePermissions 1 次

web_engine 的 module.json5 同时有 requestPermissions 与 definePermissions 两个键;electron 的 module.json5 一个都没有。

这就引出第二个问题:权限写在 web_engine 里,出包却在 electron 的 module.json 里:

  web_engine/src/main/module.json5       权限行 15  顶层 name 候选 ['"name": "web_engine",', '"name": "ohos.permission.INTERNET"']
     module 名 : ['"name": "web_engine",']
  electron/src/main/module.json5         权限行  0  顶层 name 候选 ['"name": "electron",', '"name": "client_id",']
     module 名 : ['"name": "electron",']
  module.requestPermissions 条目 : 14
     ohos.permission.INTERNET                       reason=
     ohos.permission.GET_NETWORK_INFO               reason=
     ohos.permission.ACCESS_CERT_MANAGER            reason=
     ohos.permission.RUNNING_LOCK                   reason=
     ohos.permission.PRINT                          reason=
     ohos.permission.PREPARE_APP_TERMINATE          reason=
     ohos.permission.ACCESS_BIOMETRIC               reason=
     ohos.permission.PRIVACY_WINDOW                 reason=
     ohos.permission.WINDOW_TOPMOST                 reason=
     ohos.permission.GYROSCOPE                      reason=
     ohos.permission.ACCELEROMETER                  reason=
     ohos.permission.SET_ABILITY_INSTANCE_INFO      reason=
     ohos.permission.GET_FILE_ICON                  reason=
     ohos.permission.LOCK_WINDOW_CURSOR             reason=
  definePermissions : []
  module.name : electron
  abilities   : ['EntryAbility', 'BrowserAbility', 'StatelessAbility']
  extensionAbilities : ['StatusBarEntryAbility', 'BrowserEmbeddedAbility']

三组数字放在一起:

  • 源码 web_engine:15 行命中(14 申请 + 1 定义);
  • 源码 electron:0 行;
  • 包内 hap:module.name 是 electron,requestPermissions 14 项。

也就是说,改权限要改 web_engine 的文件,验权限要到 electron 的包里验。 这两个位置不重合,如果只在一侧核对,很容易得出相反结论:在 electron 的源码里看是 0 项,会以为权限丢光了;在 web_engine 的包里找又找不到包。

这条判据很硬:权限的数量按"申请条目"数,不按"出现 ohos.permission 的行"数;权限的验收一律以包内 module.json 为准。 前者防止把 definePermissions 算进去,后者防止在错误的文件里找答案。


十、三个同名 hap:哪个能提审

现在回到第六节留下的问题:10-15 那个包里装的是改好名字的版本,那 10-27 又出的那个同名 hap 是什么?

先把产物摊开:

  build\outputs\default\ohos_hap-default-signed.app                    82.5 MB  2026-10-15 21:27
  build\outputs\default\ohos_hap-default-unsigned.app                  82.5 MB  2026-10-15 21:27
  electron\build\default\outputs\default\electron-default-signed.hap    187.0 MB  2026-10-27 12:19
  electron\build\default\outputs\default\electron-default-unsigned.hap    185.6 MB  2026-10-27 12:19
  electron\build\default\outputs\default\app\electron-default.hap     184.5 MB  2026-10-15 21:27
  pac.json                                             665 B  crc=e09bb808  2026-10-15 21:27
  pack.info                                           1088 B  crc=f3a0323f  2026-10-15 21:27
  electron-default.hap                           193483615 B  crc=f57da00f  2026-10-15 21:27
  hap 条目数 : 1
  外层 app 内 hap  : 193483615 B  crc=f57da00f  2026-10-15 21:27
  electron-default-signed.hap 196106215 B  crc=339f5e6f  2026-10-27 12:19
  electron-default.hap 193483273 B  crc=8e76e1ad  2026-10-15 21:27

三条事实:

  1. 提审物 ohos_hap-default-signed.app 是 10-15 21:27 的,86,559,471 字节,里面只有一个 hap 条目,193,483,615 字节,CRC f57da00f,时间戳同为 10-15 21:27;
  2. 工程里另有一个 electron-default-signed.hap,10-27 12:19,196,106,215 字节,CRC 339f5e6f——与 app 内那个不是同一个文件;
  3. 还有一个未签名的 electron-default.hap,193,483,273 字节,与 app 内那个只差 342 字节(签名块),CRC 也不同。

同一个工程、同一个名字、三个不同的 hap,尺寸差 2.6 MB。差在哪?把 10-27 那个拆开对比:

  buildMode debug / debug True / versionName 1.0.0
  .pages.info            21384 B
  ets/sourceMaps.map     572033 B
  ets/modules.abc        1499320 B
  module.json            3632 B
  pack.info              746 B
  buildMode release / debug False / versionName 1.0.0
  .pages.info            缺失
  ets/sourceMaps.map     缺失
  ets/modules.abc        912608 B
  module.json            3635 B
  pack.info              1088 B

四行对照足够定性:

条目10-15(app 内,可提审)10-27(工程里的新包)
buildMode / debugrelease / Falsedebug / True
.pages.info缺失21,384 B
ets/sourceMaps.map缺失572,033 B
ets/modules.abc912,608 B1,499,320 B

10-27 那个是 debug 包:模块字节码多了 586,712 字节(调试信息),多了 .pages.info 与 sourceMaps.map,module.json 小 3 字节(release 变 debug 少 2 字节,false 变 true 少 1 字节),pack.info 小 342 字节。

所以答案是:能提审的只有 10-15 那个 .app,10-27 的新包不能提。 12 天的时间差不是问题,"谁是 release"才是问题。

【配图位 4:三个 hap 的对照。左侧放资源管理器里三个文件的名称、大小、时间戳,右侧放两段 module.json 的 buildMode 与 debug 字段并排,中间用箭头标出"提审物是外层 app,不是工程里最新的 hap"。】

这条判据比"看日期"可靠得多。日期只能告诉你哪个新,不能告诉你哪个能用。真正的三个判据是:

  1. module.json 的 buildMode 是 release、debug 是 false;
  2. 包内没有 .pages.info 与 ets/sourceMaps.map;
  3. ets/modules.abc 的体积回到 release 量级(这个工程是 912,608 字节,debug 版多出 64%)。

三条同时成立,才叫"可提审的包"。反过来,只要有一条不成立,即使它是昨天刚出的、名字最新、时间戳最新,也不能交。


十一、判据沉淀:五条

这一篇的东西可以收成五条,每条都对应一次具体的坑。

判据一句话这次对应的坑
名称构成功能词 + 技术缩写 + 品类后缀,两段高风险即危险版控 SVN 客户端被驳回
改名半径资源优先、界面其次、注释描述最后;旧名在源码必须为 0四份 string.json 同值,改一处漏三处
签名判据只有 bundleName、证书、Profile 变化才需要重签以为改名要重签,其实包名带 svn 也没事
打包判据改显示名必须重打包,因为名字是包内资源不用重签但必须重出包
权限判据数申请条目不数代码行;验包内不看源码15 行 vs 14 项;权限写在 web_engine 出在 electron

再补一条关于产物的:提审物的身份不是文件名,是它内嵌 hap 的构建模式。 这条单独列出来,因为它是这一篇里唯一一个"差点交错了包"的地方。

把这条判据再压短成一句:构建产物不会自己标注身份。 名字写在包内资源里,权限写在包内 module.json 里,release 还是 debug 写在 app.buildMode 里——三样都不在文件名和时间戳上,只能解包去读。手上有几个同名文件时,先解包再决定交哪个。


十二、提审前待办:六条

按"影响审核"到"影响维护"排序:

  1. 确认提审物是 10-15 那个 .app,或者重新出一版 release 的 .app。如果后续又改过代码,必须重出,不能拿旧 .app 交新代码。
  2. 补一次 release 构建并核对三条判据:buildMode=release、无 .pages.info 与 sourceMaps.map、modules.abc 回到 912,608 字节量级。
  3. 把 BrowserAbility_label 与 StatelessAbility_label 改成中文名或至少改成有意义的名称。现在它们是模板英文名,StatelessAbility 还是 exported 的,可能在系统界面露出。
  4. 确认三套语言资源的一致性。en_US 里现在放的是中文名,这不影响审核,但会让"本地化"这三个字变成摆设;要么真做英文名,要么承认只支持中文。
  5. 密码落盘加密。用 safeStorage 走一遍,或者干脆不落盘密码、改为每次会话输入;如果都不做,至少把免责声明改成第八节末尾那句完整表述。
  6. 清理构建缓存里的旧名。build 目录下还留着改名前的中转产物,它们不参与打包,但会误导下一次核对——扫到它们,很容易得出"源码里还有旧名"的错误结论。

第 1、2 条是硬性的:交错了包,前面所有改名都白做。第 3、4 条是体验与一致性问题。第 5 条是安全债。第 6 条是维护性。


十三、交付脚本:四问一次跑完

【配图位 5:脚本运行输出的终端截图,四段标题与正文四节一一对应;右侧可并排放关于弹窗原文,把"仅保存在设备本地"那句框出来,与第八节的明文落盘形成对照。】

改名半径、提审包、构建模式、包内一致性,四件事一个脚本就能跑完,不需要设备,不需要构建:

import os, sys, zipfile, io, json
sys.stdout.reconfigure(encoding='utf-8')
B = sys.argv[1]
APP = os.path.join(B, 'web_engine', 'src', 'main', 'resources', 'resfile', 'resources', 'app')
OLD, NEW = 'SVN 客户端', '版控代码管理'


def walk():
    for d, dirs, fs in os.walk(B):
        dirs[:] = [x for x in dirs if x not in ('.hvigor', 'build', 'oh_modules', '.idea')]
        for f in fs:
            if f.endswith(('.json', '.json5', '.js', '.html', '.css', '.ets')):
                yield os.path.join(d, f)


print('== 问一:改名半径 ==')
rows = []
for p in walk():
    t = open(p, encoding='utf-8', errors='ignore').read()
    n, o = t.count(NEW), t.count(OLD)
    if n or o:
        rows.append((os.path.relpath(p, B), n, o))
for r, n, o in sorted(rows):
    print('  %-58s 新名 %d  旧名 %d' % (r, n, o))
print('  命中文件 %d 个:新名 %d 次,旧名 %d 次' % (len(rows), sum(x[1] for x in rows), sum(x[2] for x in rows)))

print()
print('== 问二:提审包里装的是哪一天的 hap ==')
d = os.path.join(B, 'build', 'outputs', 'default')
name = [x for x in os.listdir(d) if x.endswith('signed.app')][0]
outer = os.path.join(d, name)
zf = zipfile.ZipFile(outer)
inner = [i for i in zf.infolist() if i.filename.lower().endswith('.hap')][0]
print('  外层 %s  %d B  %04d-%02d-%02d %02d:%02d' % (name, os.path.getsize(outer), *inner.date_time[:5]))
print('  内嵌 %s  %d B  crc=%08x' % (inner.filename, inner.file_size, inner.CRC))

print()
print('== 问三:这个 hap 是 release 还是 debug ==')
hz = zipfile.ZipFile(io.BytesIO(zf.read(inner)))
mj = json.loads(hz.read('module.json').decode('utf-8'))
print('  buildMode=%s debug=%s module.name=%s' % (mj['app'].get('buildMode'), mj['app'].get('debug'),
                                                 mj['module'].get('name')))
print('  权限 %d 项,能力 %d 个' % (len(mj['module'].get('requestPermissions', [])),
                                  len(mj['module'].get('abilities', []))))
for k in ('.pages.info', 'ets/sourceMaps.map', 'ets/modules.abc'):
    names = hz.namelist()
    print('  %-20s %s' % (k, ('%d B' % hz.getinfo(k).file_size) if k in names else '缺失'))

print()
print('== 问四:包内资源与磁盘是否一致 ==')
same = 0
html = hz.read('resources/resfile/resources/app/index.html').decode('utf-8')
for rel in ('index.html', 'main.js', 'renderer.js', 'svn-engine.js', 'package.json', 'styles/tortoise.css'):
    q = hz.read('resources/resfile/resources/app/' + rel)
    p = open(os.path.join(APP, rel.replace('/', os.sep)), 'rb').read()
    same += (q == p)
print('  6 个文件,逐字节相同 %d 个' % same)
print('  包内 index.html:新名 %d 次,旧名 %d 次' % (html.count(NEW), html.count(OLD)))

实跑输出:

== 问一:改名半径 ==
  AppScope\resources\base\element\string.json                新名 1  旧名 0
  electron\src\main\resources\base\element\string.json       新名 1  旧名 0
  electron\src\main\resources\en_US\element\string.json      新名 1  旧名 0
  electron\src\main\resources\zh_CN\element\string.json      新名 1  旧名 0
  web_engine\src\main\resources\resfile\resources\app\index.html 新名 3  旧名 0
  web_engine\src\main\resources\resfile\resources\app\main.js 新名 1  旧名 0
  web_engine\src\main\resources\resfile\resources\app\package.json 新名 1  旧名 0
  web_engine\src\main\resources\resfile\resources\app\renderer.js 新名 1  旧名 0
  web_engine\src\main\resources\resfile\resources\app\styles\tortoise.css 新名 1  旧名 0
  web_engine\src\main\resources\resfile\resources\app\svn-engine.js 新名 1  旧名 0
  命中文件 10 个:新名 12 次,旧名 0 次

== 问二:提审包里装的是哪一天的 hap ==
  外层 ohos_hap-default-signed.app  86559471 B  2026-10-15 21:27
  内嵌 electron-default.hap  193483615 B  crc=f57da00f

== 问三:这个 hap 是 release 还是 debug ==
  buildMode=release debug=False module.name=electron
  权限 14 项,能力 3 个
  .pages.info          缺失
  ets/sourceMaps.map   缺失
  ets/modules.abc      912608 B

== 问四:包内资源与磁盘是否一致 ==
  6 个文件,逐字节相同 6 个
  包内 index.html:新名 3 次,旧名 0 次

四段输出与正文一一对上:12 次改名、0 次旧名;提审物是 10-15 的外层 app;包内 hap 是 release、14 项权限、3 个 ability、无调试条目;六个资源文件与磁盘逐字节相同。


十四、边界:这篇没有证明的四件事

第一,驳回意见的原文措辞没有留存。本文写"与 SVN 客户端这类既有名称构成相似",是根据当时的处理记录复述的判断,不是逐字引用。这类文章里最容易被写错的就是驳回归因,我把它写成"这一类词的风险",而不是"审核说了什么"。

第二,没有真机截图证明桌面名称已变。改名后的名字在系统里显示成什么,按资源解析链推是"版控代码管理",但我没有在真机上重新安装并截图。这一条要靠本文引用的资源文件与包内字节来支撑,而不是靠肉眼。

第三,10-27 那个 debug 包是谁、为什么打的,不清楚。我能证明它是 debug,不能证明它的用途。可能是某次联调,也可能是某次误操作。本文只用它来说明"同名产物必须验构建模式",不对它的来历下结论。

第四,密码明文这件事没有修。第八节把它写出来,是作为一处"声明为真但不完整"的示例,不是作为已修复项。修它需要动设置界面与配置迁移,属于下一轮。

这四条都不影响主结论,因为主结论只到"名字改了多少处、哪个包能提审、权限怎么数"这一层。它们影响的是这篇文章的边界——它是一份上架前的自检记录,不是审核结论的复盘。


收尾:改名是一次坐标变换,不是一次替换

这篇的两条主线,其实是一件事情的上下游。

上游是名字。审核驳回的不是一个字符串,是一类构成方式:功能词 + 技术缩写 + 品类后缀。所以改名不是把五个字换成六个字,是换一套坐标——从"我是某产品的客户端"换成"我是一个功能模块"。换坐标之后,12 处落点都要跟着动,落点之间还有引用关系(label 指向 string.json,string.json 有三套语言),漏一处就漂一处。

下游是包。改完名字不等于交付了新东西,因为提审看的是包里的字节。这个工程的包里确实装着新名字(包内 index.html 三次新名、零次旧名、六个资源文件与磁盘逐字节相同),但那个包是 10-15 打的;10-27 又出的一版同名 hap 是 debug 包,多了 .pages.info、多了 sourceMaps、modules.abc 涨了 64%。

两件事合起来是一条判据:改名要改到"资源、界面、注释"三层都干净;交付要交到"外层 app 内嵌的那个 hap 是 release"这一层。 前者靠 grep,后者靠解包,都不靠记忆。

这篇到此为止。下次再遇到改名这类任务,顺序只有两步:先把落点数干净——资源、界面、注释、描述,一处不落;再把包解开看字节——名字对不对、权限几项、release 还是 debug。两步都不靠记忆,靠的是当场数出来的数字。

Logo

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

更多推荐