如何更换OpenHarmony SDK API 10

OpenHarmony社区已经发布OpenHarmony SDK API 10 beta版本，有些Sample案例也有需要API10。那么如何替换使用新的OpenHarmony SDK API 10呢？本文做个记录。

1、如何获取OpenHarmony SDK

1.1 每日构建流水线

可以从OpenHarmony每日构建站点获取最新的OpenHarmony SDK，每日构建流水线访问地址为:http://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist。每日构建流水线会构建系统镜像、SDK等，常用的SDK使用下述流水线进行构建。

1.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。

关于Full SDK的编译和替换，可以参考社区文档如何编译full-SDK和如何替换full-SDK。

2、如何使用新的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的目录，如下：

复制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压缩包，解压到当前位置。如果遇到弹窗是否覆盖，覆盖即可。如图：

解压后SDK的位置为：

再打开DevEco Studio就可以看到看到新的API，如图：

3、如何替换HarmonyOS SDK

如果使用的HarmonyOS SDK，则不能使用同样的方法进行替换，现在还不清楚如何替换使用新的SDK。待更新。

4、替换SDK遇到的问题

4.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. 如图：

发生这样的原因是解压的时候，目录路径不对。在ets目录下又有了一个ets目录。

4.2 ets-loader安装node_modules依赖包

印象中，需要在OpenHarmony-sdk\10\ets\build-tools\ets-loader目录中打开cmd/powerShell窗口，输入命令npm install下载node_modules依赖包。我没有执行此操作，好像也没有出错。是否必须执行此操作，待查。