dxl0812 发表于 2025-3-30 12:37:35

新增需要的SDK版本

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 并可以进行修改。
{
"products": [
    {
      // 产品名称为default
      "name": "default",
      // 使用的签名配置为default
      "signingConfig": "default",
      // 编译时使用的SDK版本
      "compileSdkVersion": 16,
      // 兼容的SDK版本
      "compatibleSdkVersion": 12,
      // 运行时操作系统
      "runtimeOS": "OpenHarmony"
    }
]
}
页: [1]
查看完整版本: 新增需要的SDK版本