HarmonyOS 7.0将陆续面向全网HarmonyOS NEXT设备发布,其配套的API版本为26.0.0,推荐开发者将所使用的开发套件升级至26.0.0配套版本,并将应用在此版本上完成升级适配,保证终端用户在HarmonyOS 7.0版本上获得良好的应用使用体验。
HarmonyOS版本在快速迭代更新的过程中,新增了大量的API,少量API会被废弃或者发生行为变更。为确保兼容性,在应用升级前需要参考API变更文档评估废弃API以及API行为变更对应用的影响。此外,我们提供了API隔离机制(通过targetSdkVersion进行隔离)以及API变更工具来帮助开发者升级应用。完成应用在开发套件的升级适配后,需要在新老设备上进行兼容性测试,以确保应用的正确运行,验证完成后,将最新应用发布到应用市场。
迁移阶段包含以下几个阶段:

命令行工具中同样预置了配套版本的HarmonyOS SDK,DevEco Studio升级后,请同步升级相同版本的命令行工具,确保使用命令行工具在流水线编译出的应用包与DevEco Studio编译的应用包使用了相同的SDK工具链。
可在官网下载中心的Command Line Tools部分获取与DevEco Studio同版本的命令行工具。
DevEco Studio升级版本后,如果应用工程中未显式配置targetSdkVersion,则该字段会同步升级为DevEco Studio配套的SDK版本。同时,编译应用默认使用的compileSdkVersion也将会同步升级为相同版本,如果希望应用兼容更低版本的SDK,可通过compatibleSdkVersion配置兼容的最低SDK版本。此时需要注意针对以下两种API使用情况进行评估和适配:
对于具体的API行为变更对应用带来的影响,开发者可通过以下两种手段来识别,并参考变更说明文档进行适配。
开发者可以通过DevEco Studio的API变更助手查看当前工程中使用到的ArkTS API/C API是否存在行为变更,并根据工具提供的适配指导链接完成工程代码适配修改。步骤如下:



应用基于新的SDK进行编译后,需要将应用安装到新老版本的设备上进行全量测试验证,覆盖所有的功能点来发现可能存在的不兼容问题。
目前AppGallery Connect提供的云调试功能支持多种设备和多个API版本,如果缺少足够的真机设备进行多API版本的兼容性验证,可通过云调试功能进行测试。