OpenHarmony开发者论坛

标题: 新增需要的SDK版本 [打印本页]

作者: xr_xyg 时间: 2025-3-18 09:34
标题: 新增需要的SDK版本
[md]# OpenHarmony实践文档

## 一、新增需要的SDK版本

### 1.1 下载需要的SDK版本

在 OpenHarmony 数字化协作平台的 `工作平台 - CICD - 每日构建 - 运行状况` 选择OpenHarmony项目下，需要分支指定日期范围内的流水线。以下以 `SDK version 16` 举例。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_10-40-53.png)

下载其中的全量包，为zip压缩包。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_10-44-21.png)

下载完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下载路径。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_10-53-28.png)

可以直接复制 Location 中的路径在 `我的电脑` 中，若路径中有文件夹找不到，可能是文件夹被隐藏，需要显示隐藏的项目即可看到。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_11-29-53.png)

### 1.3 新建SDK文件夹并解压缩

找到SDK下载的文件夹，打开后能开到已下载的所有版本的SDK，每一个版本是一个文件夹，因此新建一个名为16的文件夹用于装 version 16 的相关内容。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_11-33-37.png)

将之前下载的zip压缩包中的内容全部解压缩到16文件夹下，其中的5个压缩包需要再次解压缩至这种形式。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_11-35-23.png)

想要检查下载的SDK版本到底是多少，`16文件夹 - ets文件夹/js文件夹/native文件夹/previewer文件夹/toolchains文件夹 - oh-uni-package.json`，打开后能够看到 apiVersion、metaVersion、releaseType、version等相关版本信息。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_15-21-57.png)

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

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

重新进入 deveco studio 在SDK中就能发现新下载的SDK。
![](https://file+.vscode-resource.vscode-cdn.net/c:/Users/kaihong/github_kaifangyuanzi/%E8%80%83%E6%A0%B8/two/%E6%88%AA%E5%9B%BE/Snipaste_2025-03-17_15-28-53.png)

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

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

欢迎光临 OpenHarmony开发者论坛 (https://forums.openharmony.cn/)