歷史工程自動(dòng)適配

由于最新版本的HarmonyOS SDK對(duì)應(yīng)的API Version發(fā)生了躍遷，原有的API Version 3變成了當(dāng)前的API Version 4，原有的API Version 4變成了當(dāng)前的API Version 5。因此，使用最新版本的DevEco Studio打開歷史工程，需要對(duì)歷史工程進(jìn)行適配；如果歷史工程未做適配，會(huì)導(dǎo)致工程出現(xiàn)運(yùn)行錯(cuò)誤INSTALL_PARSE_FAILED_USESDK_ERROR。

在打開歷史工程前，建議您先點(diǎn)擊Help > Check for Updates，檢查并升級(jí)DevEco Studio至最新版本；點(diǎn)擊Tools >SDK Manager，檢查并升級(jí)SDK及工具鏈版本至最新版本。

使用DevEco Studio打開歷史工程，會(huì)提示您將歷史工程進(jìn)行升級(jí)適配，點(diǎn)擊Update，工具會(huì)自動(dòng)修改工程中的配置信息，包括：

升級(jí)編譯構(gòu)建插件版本為2.4.2.7

在build.gradle中添加OHOS測(cè)試框架的依賴

升級(jí)config.json和build.gradle中的API Version

升級(jí)config.json中的releaseType字段的值：如果是DevEco Studio V2.1 Beta 2及之前的版本的工程，該字段適配為“Release”。工程升級(jí)前后的config.json關(guān)鍵字段對(duì)比如下表所示。

compatible/target/releaseType(適配前)

compatible/target/releaseType(適配后)

3/3/-

4/5/Release

3/4/Beta1

4/5/Release

3/4/Beta2

4/5/Release

4/4/Beta1

5/5/Release

4/4/Beta2

5/5/Release

如果是DevEco Studio V2.1 Beta 3版本的工程，該字段保持“Beta1”不變。

INSTALL_PARSE_FAILED_USESDK_ERROR處理指導(dǎo)

問題現(xiàn)象：

如果工程中的releaseType字段與設(shè)備(模擬器和真機(jī))中的SDK鏡像版本的值不匹配，則運(yùn)行時(shí)會(huì)報(bào)INSTALL_PARSE_FAILED_USESDK_ERROR錯(cuò)誤，如下圖所示。

解決措施：

在設(shè)備(模擬器或真機(jī))中運(yùn)行應(yīng)用時(shí)，設(shè)備的Rom版本、releaseType和工程對(duì)應(yīng)的SDK版本需要遵循如下的匹配關(guān)系。

運(yùn)行設(shè)備

Rom版本

releaseType字段取值

工程對(duì)應(yīng)的SDK版本

模擬器

Release

"releaseType": "Release"

2.1.1.20(Stage：Release)

真機(jī)設(shè)備

Beta

"releaseType": "Beta1"

2.1.1.18(Stage：Beta)

真機(jī)設(shè)備

Release

"releaseType": "Release"

2.1.1.20(Stage：Release)

說明

真機(jī)設(shè)備的releaseType取值，可以通過如下命令進(jìn)行查詢。

hdc shell

getprop hw_sc.build.os.releasetype

例如：在模擬器中運(yùn)行時(shí)，config.json中的releaseType字段必須修改為Release，SDK Manager中的SDK版本為2.1.1.20，Stage為Release。

總結(jié)

以上是生活随笔為你收集整理的harmonyos sdk,HarmonyOS SDK对应的API版本跃迁引发的历史工程适配问题解决方案的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。