head info OTA.tag vendor.img system.img 1.7 執(zhí)行升級(jí)包制作命令 python build_update.py ./target_package/ ./output_package/ -pk ./rsa_private_key2048.pem ?./target_package/：指定target_package路徑。 ?./output_package/：指定升級(jí)包輸出路徑。 ?-pk ./rsa_private_key3072.pem：指定私鑰文件路徑。 ?此處可以使用系統(tǒng)自帶的證書：device/board/hisilicon/hispark_taurus/linux/updater/config/rsa_private_key2048.pem注：OpenHarmony 3.2 Beta3分支上base/update/packaging_tools倉(cāng)制作updater升級(jí)包校驗(yàn)有BUG，會(huì)失敗。開發(fā)者已經(jīng)在master分支上修復(fù)，制作升級(jí)包前請(qǐng)同步master上最新代碼。 2.配置服務(wù)器 搭建搜包服務(wù)器(OTA搜包服務(wù)器采用OpenSSL協(xié)議傳輸數(shù)據(jù)，所以必須使用HTTPS解析)，服務(wù)器源碼見附件sslserver目錄。 3.配置網(wǎng)絡(luò) 3.1 配置客戶端服務(wù)器信息 為了方便調(diào)試，我們提供了本地可配置文件修改方案(patch見附件)。服務(wù)器搭建完成后，只需要在開發(fā)板配置服務(wù)地址，搜包地址，端口號(hào)等信息即可完成搜包，下載等功能。 配置路徑：/system/etc/serverInfo.json

{
    "serverIp": "115.126.57.xx", //服務(wù)器ip
    "serverSearch": "115.126.57.xx", //搜包服務(wù)器
    "serverPort":9556  //端口號(hào)
}

3.2 OpenHarmony 3.2 Beta3分支默認(rèn)route路由是關(guān)閉的，只要先打開route才能連接外網(wǎng)。搜包前先要替換toybox文件，配置好的toybox已在附件中提供，直接通過hdc_std file send toybox(路徑) /system/bin/ 替換即可。 3.3 導(dǎo)入signing_cert.crt證書 hdc_std file send signing_cert.crt(路徑) /data/ota_package 3.4 配置路由地址 hdc_std shell route add default gw 10.51.11.1 dev eth1 //10.51.11.1是網(wǎng)關(guān)地址，根據(jù)實(shí)際情況配置，如果不知道如何查看網(wǎng)關(guān)，請(qǐng)聯(lián)系你們的網(wǎng)絡(luò)管理員。 ping www.huawei.com //ping確認(rèn)是否可以聯(lián)網(wǎng) ? 3.4 為了方便觀察效果，可通過hdc_std shell power-shell setmode 602命令，將屏幕設(shè)置為常亮。 ?4. 升級(jí)客服端代碼實(shí)例

需要權(quán)限：

ohos.permission.UPDATE_SYSTEM和ohos.permission.INTERNET，系統(tǒng)權(quán)限需要使用FULL_SDK.

4.1 獲取在線升級(jí)對(duì)象

//調(diào)用方包名，若在設(shè)置中插入升級(jí)，可添加為設(shè)置應(yīng)用的包名
const PACKAGE_NAME = "com.ohos.ota.updateclient";
let upgradeInfo = {
  upgradeApp: PACKAGE_NAME,
  businessType: {
    vendor: "HZOS",
    subType: 1
  }
}
page.data.updater=client.getOnlineUpdater(upgradeInfo);

4.2 獲取版本信息 4.2.1 獲取升級(jí)任務(wù)信息

page.data.updater.getTaskInfo().then(taskInfo => {  //...});//返回任務(wù)信息對(duì)象

4.2.2 檢查新版本信息

page.data.updater.checkNewVersion().then(data => {
  //...
});//返回搜包結(jié)果對(duì)象

? 4.2.3 獲取新版本信息

page.data.updater.getNewVersionInfo().then(data => {
  //...
});//返回新版本信息對(duì)象

? 4.3 版本下載 調(diào)用download(versionDigestInfo, downloadOptions) 下載新版本。

let versionDigestInfo = {
  versionDigest: "versionDigest" // 檢測(cè)結(jié)果中的版本摘要信息
};
let downloadOptions = {
  allowNetwork: 1,
  order: 1
}
page.data.updater.download(versionDigestInfo, downloadOptions).then(result => {
  console.info(TAG + "updater download result: " + JSON.stringify(result));
}).catch(error => {
  console.error(TAG + "updater download error: " + JSON.stringify(error));
});

? 4.4 安裝新版本 調(diào)用upgrade(versionDigestInfo, upgradeOptions)，安裝新版本，開發(fā)板會(huì)重啟進(jìn)入系統(tǒng)升級(jí)頁(yè)面，待系統(tǒng)升級(jí)完成。

clickInstall: function () {
  if (page.data.pageType == "downSuccess") { // 下載成功，開始升級(jí)
    page.upgrade();
  }
},
upgrade() {
  if (page.data.updater == undefined) {
    //...
    return;
  }
  page.data.updater.on(eventClassifyInfo, eventInfo => {
    console.info(TAG + "upgrade eventInfo: " + JSON.stringify(eventInfo));
    //...
  });
  let upgradeOptions = {
    order: 2 //安裝
  }
  page.data.updater.upgrade(versionDigestInfo, upgradeOptions).then(result => {
    console.info(TAG + "upgrade result: " + JSON.stringify(result));
  }).catch(error => {
    console.error(TAG + "upgrade error: " + JSON.stringify(error));
  });
}

? 進(jìn)入updater模式，升級(jí)過程中會(huì)提示“正在更新 請(qǐng)勿重啟”。 ? ? 升級(jí)完成后頁(yè)面會(huì)提示“升級(jí)完成”，之后重啟。 ? ? 升級(jí)完成后，再次校驗(yàn)當(dāng)前版本信息，提示當(dāng)前已是最新版本。 ? ?

OTA升級(jí)調(diào)試

正常模式：在該路徑下data/updater/log獲取updater_log、updater_stage_log、error_code.log三份日志文件。 updater模式：在該路徑下tmp/獲取updater.log、updater_stage.log、error_code.log三份日志文件。 updater.log搜索關(guān)鍵字fail即可快速定位問題。 ?

總結(jié)

OpenHarmony OTA升級(jí)主要是搭建搜包服務(wù)器，制作升級(jí)包，了解OTA下載包管理，包解析，包管理的代碼邏輯。同時(shí)，對(duì)于常見問題知道如何快速定位！

參考鏈接

升級(jí)客戶端應(yīng)用、服務(wù)器源碼

https://gitee.com/wanfan_yyds/upgrade3.2

基于OpenHarmony 3.2 Beta3分支源碼的patch

https://gitee.com/wanfan_yyds/update_updateservice/commit/44e28bb1d8d84b200348c5ad03f9f4ce3bad3e1e

https://gitee.com/wanfan_yyds/update_updater/commit/0fe02cec5b21bd3f9a47c4e5a0fd0e5790088703

參考文獻(xiàn)

https://docs.openharmony.cn/pages/v3.2Beta/zh-cn/application-dev/reference/apis/js-apis-update.md/

https://gitee.com/openharmony/update_updater

https://gitee.com/openharmony/update_updateservice

https://gitee.com/openharmony/update_update_app

https://gitee.com/openharmony/update_packaging_tools

---