HarmonyOS 云端编译报 00303313?先检查 compileSdkVersion
背景
最近在云端鸿蒙开发环境里拉了一个纯端侧案例(ArkTS + ArkUI),工程拉下来后直接编译,hvigor 立刻报错:
ERROR: 00303313 Configuration Error
Error Message: compileSdkVersion is incompatible with the current DevEco Studio version.
configured version: 24, DevEco Studio version: 26.0.0.
报错信息其实已经把答案写出来了,但两个数字容易被误读:24 说的是 SDK API 版本,26.0.0 说的是工具链(DevEco Studio)版本。两者对不上,工程就编不过。
三个版本字段到底管什么
它们都在 build-profile.json5 的 app.products[0] 里:
- compatibleSdkVersion:最低兼容 API 版本,必填,写错会直接 schema 校验失败;
- compileSdkVersion:编译时使用的 SDK 版本,老版本 DevEco 习惯显式写死,新版已改为“不写就用 IDE 内置 SDK”;
- targetSdkVersion:目标 API 版本,影响行为变更开关。
所以当工程写死了 compileSdkVersion: 6.1.1(24),而环境里的 DevEco 是 26 时,写死的值就成了地雷。
两个坑
坑一:把三个字段一起删。我一开始图省事,把 compileSdkVersion、targetSdkVersion、compatibleSdkVersion 全删了,结果换了个错:Schema validate failed ... must have required property 'compatibleSdkVersion'。正确做法是:只删 compileSdkVersion(可再删 targetSdkVersion),保留 compatibleSdkVersion,比如写成 6.0.0(20),让编译 SDK 用 IDE 内置版本。
坑二:依赖没装就编译。案例仓库里 oh-package.json5 有依赖,但 oh_modules 不进 Git。直接跑 hvigorw 会找不到依赖,先 ohpm install,看到 install completed 再编译。
一次完整的云端编译
cd harmony_app
ohpm install
hvigorw assembleHap --mode module -p product=default --no-daemon
成功日志长这样:
> hvigor Finished :entry:default@PackageHap... after 466 ms
> hvigor Finished :entry:assembleHap... after 1 ms
> hvigor BUILD SUCCESSFUL in 9 s 93 ms
34 tasks in total: 34 executed, 0 up-to-date
两个容易被吓到的细节
- 日志里的 Will skip sign 'hos_hap'. No signingConfigs profiles is configured 意思是打包成功但未签名,只验证能不能编过可以忽略;要装真机需要用 AGC 证书和 profile 补签名配置。
- ArkTS 里 back 已废弃之类的 WARN 会刷很多行,它们不是失败,只看最后的 BUILD SUCCESSFUL 还是 FAILED。
小结
- 00303313 的本质是 IDE 版本与工程写死的 SDK 版本不一致:删写死值、保留 compatibleSdkVersion 是成本最低的解法。
- 顺序是 ohpm install → hvigorw assembleHap,云端一次性编译加 --no-daemon 更稳。
- 看日志只看三件事:有无 schema/配置错误、PackageHap 有没有 Finished、最后是 SUCCESSFUL 还是 FAILED。
- 点赞
- 收藏
- 关注作者
评论(0)