如何更換OpenHarmony SDK API 10
想了解更多關(guān)于開源的內(nèi)容,請(qǐng)?jiān)L問(wèn):
如何更換OpenHarmony SDK API 10
OpenHarmony社區(qū)已經(jīng)發(fā)布OpenHarmony SDK API 10 beta版本,有些Sample案例也有需要API10。那么如何替換使用新的OpenHarmony SDK API 10呢?本文做個(gè)記錄。
一、如何獲取OpenHarmony SDK
1、每日構(gòu)建流水線
可以從OpenHarmony每日構(gòu)建站點(diǎn)獲取最新的OpenHarmony SDK,每日構(gòu)建流水線訪問(wèn)地址為:http://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist。每日構(gòu)建流水線會(huì)構(gòu)建系統(tǒng)鏡像、SDK等,常用的SDK使用下述流水線進(jìn)行構(gòu)建。
流水線名稱 | 說(shuō)明 | 備注 |
ohos-sdk-public | 適用Linux、Windows平臺(tái)的Public SDK | 面向應(yīng)用開發(fā)者提供,不包含需要使用系統(tǒng)權(quán)限的系統(tǒng)接口 |
mac-sdk-public | 適用macOS平臺(tái)的Public SDK | 面向應(yīng)用開發(fā)者提供,不包含需要使用系統(tǒng)權(quán)限的系統(tǒng)接口 |
ohos-sdk-full | 適用Linux、Windows平臺(tái)Full SDK。如果需要使用系統(tǒng)接口,需要使用此SDK。 | 面向OEM廠商提供,包含需要使用系統(tǒng)權(quán)限的系統(tǒng)接口 |
mac-sdk-full | 適用macOS平臺(tái)的Full SDK。如果需要使用系統(tǒng)接口,需要使用此SDK。 | 面向OEM廠商提供,包含需要使用系統(tǒng)權(quán)限的系統(tǒng)接口 |
2、發(fā)布版本
對(duì)應(yīng)Releasef發(fā)布版本的Public SDK可以通過(guò)DevEco Studio獲取。對(duì)于beta版本,可以在release notes文檔里下載。以https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v4.0-beta1.md為例,提供的下載地址如圖所示。beta1變化較快,不斷合入新特性,如果需要使用beta版本通常會(huì)使用每日構(gòu)建流水線進(jìn)行下載獲取最新版本的SDK。
如何更換OpenHarmony SDK API 10-開源基礎(chǔ)軟件社區(qū)
關(guān)于Full SDK的編譯和替換,可以參考社區(qū)文檔如何編譯full-SDK和如何替換full-SDK。
二、如何使用新的OpenHarmony SDK
自行獲取的SDK,需要被DecEco Studio識(shí)別才能使用。以我獲取的每日構(gòu)建SDK:version-Daily_Version-ohos-sdk-public-20230716_020117-ohos-sdk-public.tar.gz為例。壓縮文件目錄結(jié)構(gòu)如下所示??梢钥吹桨m用于Linux和Windows平臺(tái)的SDK文件。每個(gè)平臺(tái)的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的路徑位置,我的環(huán)境上該路徑為:D:\installed-software\OpenHarmony-sdk。當(dāng)前目錄下已經(jīng)有API9的SDK,我們需要新增下api10的SDK,創(chuàng)建一個(gè)名稱為10的目錄,如下:
如何更換OpenHarmony SDK API 10-開源基礎(chǔ)軟件社區(qū)
復(fù)制SDK壓縮包version-Daily_Version-ohos-sdk-public-20230716_020117-ohos-sdk-public.tar.gzwindows文件夾下的5個(gè)壓縮包,即: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目錄內(nèi)。然后,全選這5個(gè)zip壓縮包,解壓到當(dāng)前位置。如果遇到彈窗是否覆蓋,覆蓋即可。如圖:
如何更換OpenHarmony SDK API 10-開源基礎(chǔ)軟件社區(qū)
解壓后SDK的位置為:
如何更換OpenHarmony SDK API 10-開源基礎(chǔ)軟件社區(qū)
再打開DevEco Studio就可以看到看到新的API,如圖:
如何更換OpenHarmony SDK API 10-開源基礎(chǔ)軟件社區(qū)
三、如何替換HarmonyOS SDK
如果使用的HarmonyOS SDK,則不能使用同樣的方法進(jìn)行替換,現(xiàn)在還不清楚如何替換使用新的SDK。待更新。
四、替換SDK遇到的問(wèn)題
1、The SDK management mode has changed
在替換OpenHarmony SDK API10時(shí),在DevEco Studio遇到了如下錯(cuò)誤:The SDK management mode has changed. The following SDKs are note compatible and will be detected. 如圖:
如何更換OpenHarmony SDK API 10-開源基礎(chǔ)軟件社區(qū)
發(fā)生這樣的原因是解壓的時(shí)候,目錄路徑不對(duì)。在ets目錄下又有了一個(gè)ets目錄。
如何更換OpenHarmony SDK API 10-開源基礎(chǔ)軟件社區(qū)
2、ets-loader安裝node_modules依賴包
印象中,需要在OpenHarmony-sdk\10\ets\build-tools\ets-loader目錄中打開cmd/powerShell窗口,輸入命令npm install下載node_modules依賴包。我沒(méi)有執(zhí)行此操作,好像也沒(méi)有出錯(cuò)。是否必須執(zhí)行此操作,待查。