如何更换OpenHarmony SDK API 10
OpenHarmony社区已经发布OpenHarmony SDK API 10 beta版本,有些Sample案例也有需要API10。那么如何替换使用新的OpenHarmony SDK API 10呢?本文做个记录。
一、如何获取OpenHarmony SDK
1、每日构建流水线
可以从OpenHarmony每日构建站点获取最新的OpenHarmony SDK,每日构建流水线访问地址为:http://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist。每日构建流水线会构建系统镜像、SDK等,常用的SDK使用下述流水线进行构建。
流水线名称 | 说明 | 备注 |
ohos-sdk-public | 适用Linux、Windows平台的Public SDK | 面向应用开发者提供,不包含需要使用系统权限的系统接口 |
mac-sdk-public | 适用macOS平台的Public SDK | 面向应用开发者提供,不包含需要使用系统权限的系统接口 |
ohos-sdk-full | 适用Linux、Windows平台Full SDK。如果需要使用系统接口,需要使用此SDK。 | 面向OEM厂商提供,包含需要使用系统权限的系统接口 |
mac-sdk-full | 适用macOS平台的Full SDK。如果需要使用系统接口,需要使用此SDK。 | 面向OEM厂商提供,包含需要使用系统权限的系统接口 |
2、发布版本
对应Releasef发布版本的Public SDK可以通过DevEco Studio获取。对于beta版本,可以在release notes文档里下载。以https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v4.0-beta1.md为例,提供的下载地址如图所示。beta1变化较快,不断合入新特性,如果需要使用beta版本通常会使用每日构建流水线进行下载获取最新版本的SDK。
如何更换OpenHarmony SDK API 10-开源基础软件社区
关于Full SDK的编译和替换,可以参考社区文档如何编译full-SDK和如何替换full-SDK。
二、如何使用新的OpenHarmony SDK
自行获取的SDK,需要被DecEco Studio识别才能使用。以我获取的每日构建SDK:version-Daily_Version-ohos-sdk-public-20230716_020117-ohos-sdk-public.tar.gz为例。压缩文件目录结构如下所示。可以看到包含适用于Linux和Windows平台的SDK文件。每个平台的SDK包含ets、js、native、previewer、toolchains等。
└─version-Daily_Version-ohos-sdk-public-20230716_020117-ohos-sdk-public
│ daily_build.log
│ manifest_tag.xml
│
└─ohos-sdk
├─linux
│ ets-linux-x64-4.0.9.3-Beta2.zip
│ js-linux-x64-4.0.9.3-Beta2.zip
│ native-linux-x64-4.0.9.3-Beta2.zip
│ previewer-linux-x64-4.0.9.3-Beta2.zip
│ toolchains-linux-x64-4.0.9.3-Beta2.zip
│
└─windows
ets-windows-x64-4.0.9.3-Beta2.zip
js-windows-x64-4.0.9.3-Beta2.zip
native-windows-x64-4.0.9.3-Beta2.zip
previewer-windows-x64-4.0.9.3-Beta2.zip
toolchains-windows-x64-4.0.9.3-Beta2.zip
打开DevEco Studio,菜单Tools->SDK Manager,查看Studio中配置的OpenHarmony SDK的路径位置,我的环境上该路径为:D:\installed-software\OpenHarmony-sdk。当前目录下已经有API9的SDK,我们需要新增下api10的SDK,创建一个名称为10的目录,如下:
如何更换OpenHarmony SDK API 10-开源基础软件社区
复制SDK压缩包version-Daily_Version-ohos-sdk-public-20230716_020117-ohos-sdk-public.tar.gzwindows文件夹下的5个压缩包,即:ets-windows-x64-4.0.9.3-Beta2.zip、js-windows-x64-4.0.9.3-Beta2.zip、native-windows-x64-4.0.9.3-Beta2.zip、previewer-windows-x64-4.0.9.3-Beta2.zip和toolchains-windows-x64-4.0.9.3-Beta2.zip。粘贴到D:\installed-software\OpenHarmony-sdk\10目录内。然后,全选这5个zip压缩包,解压到当前位置。如果遇到弹窗是否覆盖,覆盖即可。如图:
如何更换OpenHarmony SDK API 10-开源基础软件社区
解压后SDK的位置为:
如何更换OpenHarmony SDK API 10-开源基础软件社区
再打开DevEco Studio就可以看到看到新的API,如图:
如何更换OpenHarmony SDK API 10-开源基础软件社区
三、如何替换HarmonyOS SDK
如果使用的HarmonyOS SDK,则不能使用同样的方法进行替换,现在还不清楚如何替换使用新的SDK。待更新。
四、替换SDK遇到的问题
1、The SDK management mode has changed
在替换OpenHarmony SDK API10时,在DevEco Studio遇到了如下错误:The SDK management mode has changed. The following SDKs are note compatible and will be detected. 如图:
如何更换OpenHarmony SDK API 10-开源基础软件社区
发生这样的原因是解压的时候,目录路径不对。在ets目录下又有了一个ets目录。
如何更换OpenHarmony SDK API 10-开源基础软件社区
2、ets-loader安装node_modules依赖包
印象中,需要在OpenHarmony-sdk\10\ets\build-tools\ets-loader目录中打开cmd/powerShell窗口,输入命令npm install下载node_modules依赖包。我没有执行此操作,好像也没有出错。是否必须执行此操作,待查。