HarmonyOS SDK对应的API版本跃迁引发的历史工程适配问题解决方案

系统 OpenHarmony
文章由鸿蒙社区产出,想要了解更多内容请前往:51CTO和华为官方战略合作共建的鸿蒙技术社区https://harmonyos.51cto.com

[[397917]]

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

历史工程自动适配

由于最新版本的HarmonyOS SDK对应的API Version发生了跃迁,原有的API Version 3变成了当前的API Version 4,原有的API Version 4变成了当前的API Version 5。因此,使用最新版本的DevEco Studio打开历史工程,需要对历史工程进行适配;如果历史工程未做适配,会导致工程出现运行错误INSTALL_PARSE_FAILED_USESDK_ERROR。

在打开历史工程前,建议您先点击Help > Check for Updates,检查并升级DevEco Studio至最新版本;点击Tools >SDK Manager,检查并升级SDK及工具链版本至最新版本。

使用DevEco Studio打开历史工程,会提示您将历史工程进行升级适配,点击Update,工具会自动修改工程中的配置信息,包括:

升级编译构建插件版本为2.4.2.7

在build.gradle中添加OHOS测试框架的依赖

升级config.json和build.gradle中的API Version

升级config.json中的releaseType字段的值:如果是DevEco Studio V2.1 Beta 2及之前的版本的工程,该字段适配为“Release”。工程升级前后的config.json关键字段对比如下表所示。

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

INSTALL_PARSE_FAILED_USESDK_ERROR处理指导

问题现象:

如果工程中的releaseType字段与设备(模拟器和真机)中的SDK镜像版本的值不匹配,则运行时会报INSTALL_PARSE_FAILED_USESDK_ERROR错误,如下图所示。

解决措施:

在设备(模拟器或真机)中运行应用时,设备的Rom版本、releaseType和工程对应的SDK版本需要遵循如下的匹配关系。

说明

真机设备的releaseType取值,可以通过如下命令进行查询。

  1. hdc shell 
  2. getprop hw_sc.build.os.releasetype 

例如:在模拟器中运行时,config.json中的releaseType字段必须修改为Release,SDK Manager中的SDK版本为2.1.1.20,Stage为Release。

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

 

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2012-05-09 10:08:41

跨机房

2010-03-30 16:04:34

Linux Nginx

2010-05-04 11:30:29

Oracle汉字长度

2009-09-03 16:09:48

.net回车符

2010-09-27 13:14:42

JVM内存限制

2011-08-25 18:35:07

Linux cron执

2020-05-06 14:14:50

Linux依赖软件

2010-10-08 13:09:38

JavaScript数

2010-05-31 12:53:56

Nagios apac

2010-02-06 14:54:11

C++指针漂移

2010-04-28 19:24:17

Hp unix

2011-03-23 16:38:28

LAMP

2011-08-10 13:46:36

Navicat MySMySQL

2010-03-29 11:10:25

Nginx参数

2021-01-13 10:18:29

SocketNetty粘包

2010-08-04 10:20:30

Flex组件开发

2010-10-09 12:58:59

JS脚本兼容

2010-04-06 09:33:37

CentOS系统

2010-09-07 09:08:03

DIV弹出层

2023-07-27 07:07:12

git仓库语言是treemacs
点赞
收藏

51CTO技术栈公众号