现象与判定依据
AGC 拒审文案：「使用了 HarmonyOS beta 版本的 API」。本地 hvigor 发行构建可成功产出已签名.app，与编译失败无关。
AGC 扫描的是 HAP 元数据，典型字段：
| 文件 | 路径 | 拒审值 | 期望值 |
|---|---|---|---|
pack.info | summary.modules[].apiVersion.releaseType | Beta1 | Release/release |
module.json | app.apiReleaseType | Beta1 | Release |
自检：解压.app（zip）读取根目录pack.info，或检查entry/build/release/outputs/default/pack.info。
2. 与工程配置的关系
以下修改必要但不充分：
build-profile.json5：所有products移除compatibleSdkVersionStage（如beta6）release产品compatibleSdkVersion使用正式 API 串（如5.0.5(17)）oh-package.json5：发行工程不依赖@uni_modules/hmr-for-uni-app（其compatibleSdkVersionStage与 Beta abc 易触发higher sdkReleaseType）
仅做上述工程侧修改后，pack.info.releaseType仍可能为Beta1——根因在DevEco SDK 的 releaseType 元数据，由 ets-loader 写入 HAP。
3. DevEco 26：releaseType 的实际来源
hvigor 构建日志（app-harmony/.hvigor/outputs/build-logs/build.log）可定位：
etsLoaderPath: ...\sdk\default\openharmony\ets\build-tools\ets-loader etsLoaderReleaseType: Beta1 Change app api release type with 'Beta1' sdkInfo: false:26:26.0.0.23:Beta1结论：ArkTS 编译链读取openharmony/ets，不是hms/ets。
社区旧方案（API 10～11）仅修改hms/toolchains/uni-package.json在 DevEco 26 上无效。
.hvigor/cache/project-config.json中etsLoaderPath亦指向openharmony\ets\build-tools\ets-loader。
4. SDK 文件清单（sdk\default）
需将releaseType（及sdk-pkg.json的stage）从Beta*改为Release：
openharmony（决定 pack.info，优先）
openharmony/ets/oh-uni-package.json ← ets-loader 直接读取 openharmony/js/oh-uni-package.json openharmony/native/oh-uni-package.json openharmony/previewer/oh-uni-package.json openharmony/toolchains/oh-uni-package.json sdk-pkg.json ← data.releaseType, data.stagehms（HarmonyOS 组件描述，建议同步）
hms/ets/uni-package.json hms/js/uni-package.json hms/native/uni-package.json hms/previewer/uni-package.json hms/toolchains/uni-package.json4.1 误报陷阱
仅校验hms/**/uni-package.json全部为Release不能证明可上架；openharmony/**/oh-uni-package.json或sdk-pkg.json仍为Beta1时，产物pack.info不变。
5. 修复流程
- 退出 HBuilderX、DevEco Studio（避免 SDK 目录文件锁）
- 批量 patch 上述 json（
"releaseType": "Beta1"→"Release"；sdk-pkg.json中"stage": "Beta1"→"Release"） - 校验：
openharmony/ets/oh-uni-package.json+sdk-pkg.json均为 Release - 删除
unpackage/dist/build/app-harmony全目录（含.hvigor缓存；仅删oh_modules不够） - HBuilderX：发行 → App-Harmony-本地打包
- 上传前复检
pack.info→apiVersion.releaseType
Windows 下 patch SDK 文件若遇EPERM，需管理员权限并确保 IDE 进程已退出。
6. 中间产物对照（便于 diff 排查）
发行构建后若仍为 Beta，可逐级查看：
entry/build/release/intermediates/process_profile/default/module.json → apiReleaseType entry/build/release/intermediates/loader/default/loader.json → byteCodeHarInfo.*.compatibleSdkVersionStage entry/build/release/outputs/default/pack.info → releaseType build/outputs/release/pack.info → APP 级 pack.infoloader.json中依赖 HAR 的compatibleSdkVersionStage: "beta1"来自预编译 abc，通常不影响主模块apiReleaseType；主模块 Beta 标记仍由 ets-loader 的 SDK releaseType 决定。
7. 长期方案
- 安装Release 渠道DevEco Studio + HarmonyOS SDK（Help → About HarmonyOS SDK，
releaseType为 Release） - SDK 升级可能重置
Beta1，每次上架前复检pack.info - 手工改
sdk\default为权宜之计，非官方支持路径
8. 环境参考（脱敏）
| 项 | 版本 |
|---|---|
| HBuilderX | 5.07（vue3） |
| DevEco Studio | 26.0.0.461 |
| compileSdkVersion | 26.0.0 |
| compatibleSdkVersion（release） | 5.0.5(17) |
| targetSdkVersion | 6.0.0(20) |
参考文章：
- SegmentFault：《针对「您的应用使用了HarmonyOS beta版本的API」的解决方法》（API 早期，仅 toolchains）：https://segmentfault.com/a/1190000046645959
- 51CTO：《HarmonyOS 上架失败，第一次上架 beta 版应用》：HarmonyOS 上架失败，第一次上架beta版应用，提交审核立刻失败了-鸿蒙开发者社区-51CTO.COM
- 51CTO：《HarmonyOS 打包的时候如何指定使用发布版本 API》：HarmonyOS 打包的时候如何指定使用发布版本API -鸿蒙开发者社区-51CTO.COM
- DCloud 问答：《鸿蒙应用无法上架 — 提示使用 beta 版本的 api》：【报Bug】鸿蒙应用无法上架 - DCloud问答
官方文档：
- uni-app 鸿蒙运行和发行（beta API）：uni-app官网
- HarmonyOS 版本说明：文档中心
- 华为 AGC 鸿蒙应用帮助：文档中心
如果本文吸引了你，为你带来了灵感，帮助，麻烦你轻轻点击【推荐】，
你的热心评论，推荐，是我分享文章的强大动力之一。谢谢阅读！
作者：CatcherX
主页：http://catcherX.cnblogs.com
关于我：热爱IT技术、擅于用技术解决实际应用问题，目前专攻Web，网络应用开发。
.Net平台下的ASP.NET MVC；
WinForm（CS端管理系统、数据采集分析、网络应用）开发工作；
熟悉数据库SqlServer开发，Oracle管理技术；