在上传发布新版本的元服务后,系统将会在不同时机采用不同的方式去检查用户安装的元服务是否有可用的最新版本,并尝试下载更新最新的元服务包。
因元服务更新机制限制,用户设备上运行的未必一定是最新版本的元服务,可使用阻断式更新的方式引导用户将元服务更新为最新版本。
应用市场提供自动更新元服务功能。打开“应用市场 > 选择下方“我的”选项页 > 打开“设置”> 应用网络设置”,以开启自动更新服务。可以引导用户在应用市场中开启自动更新功能。设置后,每当有新版本可用时,应用市场将会闲时在后台自动下载并更新新版本的元服务,无需用户手动操作。
如果用户长时间未更新元服务,当用户打开此元服务时,在启动时,系统会异步检查是否存在更新版本。如果有,将会异步下载元服务包体,待用户再次打开此元服务时更新使用。
该方式无法保证用户设备上的元服务时刻为最新的元服务,可能存在用户当前设备上使用旧版本元服务包体,需等待下次冷启动才可正常更新使用更新的元服务。
如果希望在用户使用元服务过程中立刻进行版本更新,可以使用阻断式更新的方式进行更新。使用监听元服务更新检查接口,检查到有更新后,通过调用重启元服务接口的方式触发更新。
从HarmonyOS 6.0.0(20)开始,阻断式更新的接口支持在元服务中使用。

如果用户在弹窗中选择不升级,则该次启动元服务仍然以旧版本元服务包体启动。

import { updateManager } from '@kit.AppGalleryKit';
import { abilityManager, common } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
struct Index {
@State message: string = 'CheckUpdate'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
.onClick(() => this.callOn)
}
.width('100%')
}
.height('100%')
}
private callOn() {
let callback = (state: updateManager.UpdateSessionState) => {
if (state.code === updateManager.RequestErrorCode.NO_UPGRADE) {
hilog.info (0, 'TAG', `on success, no need update`);
updateManager.off('updateChange');
} else if (state.code === updateManager.RequestErrorCode.NEED_UPGRADE) {
hilog.info (0, 'TAG', `on success, need update`);
} else if (state.code === updateManager.RequestErrorCode.DOWNLOADED) {
hilog.info (0, 'TAG', `on success, need update and download success`);
updateManager.off('updateChange');
abilityManager.restartSelfAtomicService(this.getUIContext().getHostContext() as common.Context);
}
};
try {
updateManager.on('updateChange', callback, 20);
} catch (error) {
hilog.error(0, 'TAG', `on Error.code is ${error.code}, message is ${error.message}`);
}
}
}