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-05-04 11:30:29

Oracle汉字长度

2009-09-03 16:09:48

.net回车符

2010-09-27 13:14:42

JVM内存限制

2010-03-30 16:04:34

Linux Nginx

2011-08-25 18:35:07

Linux cron执

2020-05-06 14:14:50

Linux依赖软件

2011-03-23 16:38:28

LAMP

2010-04-28 19:24:17

Hp unix

2010-10-08 13:09:38

JavaScript数

2010-05-31 12:53:56

Nagios apac

2010-02-06 14:54:11

C++指针漂移

2010-03-29 11:10:25

Nginx参数

2011-08-10 13:46:36

Navicat MySMySQL

2010-09-15 14:14:29

IE6position

2010-07-30 12:40:00

Flex跨域访问

2010-08-26 08:45:32

margin:0pxa

2010-02-23 17:49:56

WCF传输大数据

2010-02-24 10:55:01

WCF跨域访问

2019-04-04 13:11:37

React内存泄露memory leak
点赞
收藏

51CTO技术栈公众号