如何更換OpenHarmony SDK API 10
如何更換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依賴包。我沒有執行此操作，好像也沒有出錯。是否必須執行此操作，待查。
