【错误记录】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

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

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

在当前 的 DevEco Studio 4.0 Release 版本中 , 支持下载的 HarmonyOS 的 SDK 版本是 API 9 , 再高版本的 API 10 以及 API11 不提供下载 ;

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/#配套关系

3、HarmonyOS 开发者 3.1/4.0 版本配套的开发者文档

HarmonyOS开发者3.1/4.0版本配套的开发者文档 : https://developer.huawei.com/consumer/cn/doc/harmonyos-releases-V2/harmonyos_release_3_1_202305-0000001582097989-V2 , 这个是版本比较老的文档 , 对应API能力级别为API 9 Release , 并且官网已经给出提示 " 此版本文档已归档不再维护，推荐您使用HarmonyOS NEXT版本。 "

4、HarmonyOS 5.0.1(13) 版本 的 配套文档

HarmonyOS 5.0.1(13) 版本的配套文档 : https://developer.huawei.com/consumer/cn/doc/harmonyos-releases-V13/overview-V13?catalogVersion=V13 这是 最新版本的文档 , 该版本 对应的 API能力级别为API 13 Release , 点击版本概览 , 可以查看版本配套信息 :

版本配套信息如下图所示 :

HarmonyOS版本映射关系对照表 :

5、HarmonyOS 5.0.0(12) 版本 的 配套文档

HarmonyOS 5.0.0(12) 版本的配套文档 : https://developer.huawei.com/consumer/cn/doc/harmonyos-releases-V5/overview-V5 , 对应 API 能力级别为 API 12 Release ;

HarmonyOS 5.0.0 Release 配套信息 :

HarmonyOS版本映射关系对照表 :