DevEco Studio从HarmonyOS SDK5升级至SDK6后打开旧项目报错如何解决

第一步：接受缺失组件的许可协议 #

• 打开DevEco Studio，依次进入File -> Settings -> Appearance & Behavior -> System Settings -> HarmonyOS SDK页面
• 切换到SDK Platforms标签页，勾选右下角的Show Package Details展开所有版本明细
• 找到HarmonyOS SDK 5对应的Java组件（版本号2.1.1.21），勾选后点击Apply，弹出许可协议窗口后选择Accept完成协议同意和组件下载

如果SDK列表里找不到SDK 5的版本包，可手动下载SDK 5离线包后，在该页面的HarmonyOS SDK Location右侧点击Edit，选择离线包解压路径完成导入，再重复上述许可接受操作

第二步：适配项目SDK配置 #

方案1：保持原有SDK 5兼容（无需修改项目业务代码） #

• 打开项目根目录下的build.gradle文件，找到ohos配置块，确认sdk节点的compileSdkVersion、targetSdkVersion参数值为5，java节点的version参数值为2.1.1.21
• 同步项目配置即可正常加载

方案2：升级项目适配SDK 6 #

• 打开项目根目录下的build.gradle文件，修改ohos配置块下的sdk节点参数：

ohos {
    sdk {
        compileSdkVersion 6
        targetSdkVersion 6
        java {
            version "2.2.0.2" // SDK 6对应Java组件版本号
        }
    }
}

• 同步项目配置，完成后检查项目中是否有SDK 5废弃API的调用，替换为SDK 6兼容API即可

补充验证操作 #

如果完成上述操作后仍报错，可清理项目缓存后重启：

• 依次点击File -> Invalidate Caches / Restart，选择Invalidate and Restart等待DevEco Studio重启后重新加载项目

内容的提问来源于stack exchange，提问作者Kanak Sony