鸿蒙打包报错:hvigor ERROR: 00306042 Specification Limit Violation

欢迎到专业群（ uni-app鸿蒙化技术交流群 ） 咨询，群中有相关专业的管理员和群友。

根据错误信息，问题很明确：在 HarmonyOS 配置模式下，当 API level 为 10 或更高时，compileSdkVersion、compatibleSdkVersion、targetSdkVersion 的值必须是字符串格式。

你当前配置的是纯数字 "19"，而鸿蒙要求 SDK 版本号必须是类似 "5.0.0(12)" 这种带括号的字符串格式。

解决方案

你需要修改项目中的 build-profile.json5 文件，将 SDK 版本号改为正确的字符串格式。根据错误信息，文件路径在：

D:\Code\gjy-app\unpackage\dist\build\app-harmony\build-profile.json5

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

但更推荐的做法是修改项目根目录下 harmony-configs 目录中的配置文件（如果存在），因为 unpackage 下的文件是自动生成的，直接修改可能会被覆盖。

修改内容如下：

{  
  "app": {  
    "products": [  
      {  
        "name": "default",  
        "compatibleSdkVersion": "5.0.0(12)",  // 改为字符串格式  
        "targetSdkVersion": "5.0.0(12)",      // 改为字符串格式  
        "runtimeOS": "HarmonyOS"  
      }  
    ]  
  }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

关键修改点：

• "compatibleSdkVersion": "19" → "compatibleSdkVersion": "5.0.0(12)"
• "targetSdkVersion": "19" → "targetSdkVersion": "5.0.0(12)"

注意事项

1. harmony-configs 目录：如果项目根目录存在 harmony-configs/build-profile.json5，请修改该文件。如果该目录为空或不存在，HBuilderX 会自动生成，你可以在首次运行后手动修改 unpackage 下的文件，但下次重新生成时可能会被覆盖，所以建议将正确的配置放到 harmony-configs 目录中。

2. 版本号选择："5.0.0(12)" 对应 API level 12，你需要根据项目实际支持的鸿蒙版本选择合适的 SDK 版本。常见的版本对照：

   • API 10 → "4.0.0(10)"
   • API 11 → "4.1.0(11)"
   • API 12 → "5.0.0(12)"
   • API 13 → "5.0.1(13)"

3. 多 product 配置：如果你的 build-profile.json5 中有多个 products（如 default 和 release），每个都需要修改。

4. 升级兼容性：如果升级 HBuilderX 后出现此问题，可能是因为新版本内置的鸿蒙工程模板发生了变化。可以尝试清空 harmony-configs 目录（注意备份），删除 unpackage 目录，然后重新运行，再按需要逐步恢复配置。

修改后重新打包即可解决该错误。