HarmonyOS开发环境与API版本配套关系详解

创作时间:

作者:

@小白创作中心

HarmonyOS开发环境与API版本配套关系详解

引用

CSDN

https://blog.csdn.net/shulianghan/article/details/144968582

在HarmonyOS应用开发过程中，开发者可能会遇到各种编译错误。本文详细记录了一个具体的编译错误案例，并深入分析了DevEco Studio开发环境与API版本之间的对应关系，为HarmonyOS开发者提供了一份实用的参考指南。

一、报错信息

在使用DevEco Studio 4.0 Release版本开发HarmonyOS应用时，遇到了以下编译错误：

D:\001_Develop\053_Huawei\nodejs\nodejs-16.20.1\node.exe C:\Users\octop\.hvigor\project_caches\51881010c49be65805a24b786b95a4fb\workspace\node_modules\@ohos\hvigor\bin\hvigor.js --mode module -p module=entry@default -p product=default assembleHap --parallel --incremental --daemon
> hvigor ERROR: Schema validate failed.
     Detail: Please check the following fields.
{
  instancePath: 'app.compileSdkVersion',
  keyword: 'maximum',
  params: { comparison: '<=', limit: 9 },
  message: 'must be <= 9',
  location: 'D:/002_Project/014_DevEcoStudioProjects/ArkTSAlgorithm/build-profile.json5:18:28'
} 
{
  instancePath: 'app.compatibleSdkVersion',
  keyword: 'maximum',
  params: { comparison: '<=', limit: 9 },
  message: 'must be <= 9',
  location: 'D:/002_Project/014_DevEcoStudioProjects/ArkTSAlgorithm/build-profile.json5:19:31'
} 
> hvigor ERROR: BUILD FAILED in 18 ms 
Process finished with exit code -1

从错误信息可以看出，编译失败的原因在于compileSdkVersion和compatibleSdkVersion的值超过了最大限制9。

二、DevEco Studio开发环境与API版本对应关系分析

1、当前DevEco Studio 4.0 Release版本支持的API版本

在当前的DevEco Studio 4.0 Release版本中，支持下载的HarmonyOS SDK版本是API 9，更高版本的API 10以及API 11不提供下载。

2、如何到官网查看DevEco Studio 4.0 Release版本/API版本/HarmonyOS版本的对应关系

DevEco Studio各版本对应的最高SDK版本：
DevEco Studio 3.1.1 Release：支持的最高API版本为7，这是最后一个支持Java API的版本；
DevEco Studio 4.0 Release：支持的最高API版本为9；
DevEco Studio 5.0：虽然停止了对旧版API的下载支持，但仍然可以使用DevEco Studio 3.1.1 Release版本兼容旧版API。
HarmonyOS旧版本文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-releases-V2/harmonyos_release-0000001059565562-V2
HarmonyOS新版本文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-releases-V13/overview-V13?catalogVersion=V13
OpenHarmony新版本文档：https://docs.openharmony.cn/pages/v5.0/zh-cn/release-notes/OpenHarmony-v5.0.0-release.md/#配套关系