OpenHarmony实践文档

一、新增需要的SDK版本

1.1 下载需要的SDK版本

在 OpenHarmony 数字化协作平台的 工作平台 - CICD - 每日构建 - 运行状况 选择OpenHarmony项目下，需要分支指定日期范围内的流水线。以下以 SDK version 16 举例。

 

下载其中的全量包，为zip压缩包。

 

下载完SDK之后需确认：

a.检查下载文件名是否包含full-SDK字样

b.检查api中是否包含系统API（@ohos.app.ability.abilityManager.d.ts、@ohos.app.form.formInfo.d.ts、@ohos.bluetooth.d.ts等）

注：系统api判定标准以发布api指导文档为主。

1.2 SDK解压缩路径

找到自己下载 deveco studio 时SDK下载的路径，如果忘记，可以打开 deveco studio 在 file - Settings - OpenHramony SDK(部分版本的deveco中是其他名字，找有SDK字样即可) - Location 其中显示的路径既是SDK下载路径。

 

可以直接复制 Location 中的路径在 我的电脑 中，若路径中有文件夹找不到，可能是文件夹被隐藏，需要显示隐藏的项目即可看到。

 

1.3 新建SDK文件夹并解压缩

找到SDK下载的文件夹，打开后能开到已下载的所有版本的SDK，每一个版本是一个文件夹，因此新建一个名为16的文件夹用于装 version 16 的相关内容。

 

将之前下载的zip压缩包中的内容全部解压缩到16文件夹下，其中的5个压缩包需要再次解压缩至这种形式。

 

想要检查下载的SDK版本到底是多少，16文件夹 - ets文件夹/js文件夹/native文件夹/previewer文件夹/toolchains文件夹 - oh-uni-package.json，打开后能够看到 apiVersion、metaVersion、releaseType、version等相关版本信息。

 

需注意：apiVersion后面的版本号必须和SDK中文件夹名的数字保持一致，否则会出现不匹配或者找不到的情况。

1.4 查看 deveco studio 内部SDK并修改api版本

重新进入 deveco studio 在SDK中就能发现新下载的SDK。

 

在项目内部 build-profile.json5 中的 products 字典里，就可以看到当前项目配置和可以兼容的 SDK 并可以进行修改。

{
   "products": [
     {
       // 产品名称为default
       "name": "default",
       // 使用的签名配置为default
       "signingConfig": "default",
       // 编译时使用的SDK版本
       "compileSdkVersion": 16,
       // 兼容的SDK版本
       "compatibleSdkVersion": 12,
       // 运行时操作系统
       "runtimeOS": "OpenHarmony"
     }
   ]
 }