现象与判定依据

AGC 拒审文案「使用了 HarmonyOS beta 版本的 API」。本地 hvigor 发行构建可成功产出已签名.app与编译失败无关。AGC 扫描的是 HAP 元数据典型字段文件路径拒审值期望值pack.infosummary.modules[].apiVersion.releaseTypeBeta1Release/releasemodule.jsonapp.apiReleaseTypeBeta1Release自检解压.appzip读取根目录pack.info或检查entry/build/release/outputs/default/pack.info。2. 与工程配置的关系以下修改必要但不充分build-profile.json5所有products移除compatibleSdkVersionStage如beta6release产品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 26releaseType 的实际来源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 1011仅修改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*改为Releaseopenharmony决定 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.stagehmsHarmonyOS 组件描述建议同步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 上述 jsonreleaseType: Beta1→Releasesdk-pkg.json中stage: Beta1→Release校验openharmony/ets/oh-uni-package.jsonsdk-pkg.json均为 Release删除unpackage/dist/build/app-harmony全目录含.hvigor缓存仅删oh_modules不够HBuilderX发行 → App-Harmony-本地打包上传前复检pack.info→apiVersion.releaseTypeWindows 下 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 SDKHelp → About HarmonyOS SDKreleaseType为 ReleaseSDK 升级可能重置Beta1每次上架前复检pack.info手工改sdk\default为权宜之计非官方支持路径8. 环境参考脱敏项版本HBuilderX5.07vue3DevEco Studio26.0.0.461compileSdkVersion26.0.0compatibleSdkVersionrelease5.0.5(17)targetSdkVersion6.0.0(20)