鸿蒙 PC 桌面端应用上架实战:版控代码管理因“名称相似“驳回后改名 12 处,却发现提审包里是 12 天前的构建
鸿蒙 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 处。真正花时间的是改名之后的两个问题:
- 要不要重新签名? 答案是不用,包名没动,签名绑的是包名与证书,不是显示名;
- 要不要重新打包? 答案是必须,因为显示名在包里是资源,不是签名。
而第二个问题又牵出一个更麻烦的事实:构建产物目录里躺着三个同名的 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.json | app_name | 版控代码管理 |
| electron/src/main/resources/base/element/string.json | EntryAbility_label | 版控代码管理 |
| electron/src/main/resources/en_US/element/string.json | EntryAbility_label | 版控代码管理 |
| electron/src/main/resources/zh_CN/element/string.json | EntryAbility_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.css | 4 | 否(只有读源码才看得到) |
| 包描述 | package.json 的 description | 1 | 否(只有包元数据里看得到) |
完整的扫描输出是这样:
鸿蒙平台版控代码管理适配实战:基于 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 三个字母。改名时我没有动它,也不建议动:
- 包名是内部标识,不进审核的名称面;
- 改包名等于换一个应用,旧版本的升级路径、已安装用户、签名关联全部要重做;
- 包名里的 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
三条事实:
- 提审物 ohos_hap-default-signed.app 是 10-15 21:27 的,86,559,471 字节,里面只有一个 hap 条目,193,483,615 字节,CRC f57da00f,时间戳同为 10-15 21:27;
- 工程里另有一个 electron-default-signed.hap,10-27 12:19,196,106,215 字节,CRC 339f5e6f——与 app 内那个不是同一个文件;
- 还有一个未签名的 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 / debug | release / False | debug / True |
| .pages.info | 缺失 | 21,384 B |
| ets/sourceMaps.map | 缺失 | 572,033 B |
| ets/modules.abc | 912,608 B | 1,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"。】
这条判据比"看日期"可靠得多。日期只能告诉你哪个新,不能告诉你哪个能用。真正的三个判据是:
- module.json 的 buildMode 是 release、debug 是 false;
- 包内没有 .pages.info 与 ets/sourceMaps.map;
- 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 里——三样都不在文件名和时间戳上,只能解包去读。手上有几个同名文件时,先解包再决定交哪个。
十二、提审前待办:六条
按"影响审核"到"影响维护"排序:
- 确认提审物是 10-15 那个 .app,或者重新出一版 release 的 .app。如果后续又改过代码,必须重出,不能拿旧 .app 交新代码。
- 补一次 release 构建并核对三条判据:buildMode=release、无 .pages.info 与 sourceMaps.map、modules.abc 回到 912,608 字节量级。
- 把 BrowserAbility_label 与 StatelessAbility_label 改成中文名或至少改成有意义的名称。现在它们是模板英文名,StatelessAbility 还是 exported 的,可能在系统界面露出。
- 确认三套语言资源的一致性。en_US 里现在放的是中文名,这不影响审核,但会让"本地化"这三个字变成摆设;要么真做英文名,要么承认只支持中文。
- 密码落盘加密。用 safeStorage 走一遍,或者干脆不落盘密码、改为每次会话输入;如果都不做,至少把免责声明改成第八节末尾那句完整表述。
- 清理构建缓存里的旧名。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。两步都不靠记忆,靠的是当场数出来的数字。
更多推荐




所有评论(0)