appInit 版本更新工具

appInit 是用于 UniApp 应用版本更新管理的工具类。

接口定义

UpdateVersionOptions

参数名	类型	必填	说明
version	string	是	最新版本号（如 1.0.1）
description	string	是	更新内容描述
url	string	是	Android 更新包下载地址（支持 .apk 和 .wgt）
force	boolean	否	是否强制更新，默认 false
iosStoreUrl	string	否	iOS App Store 跳转地址
onProgress	(progress: OnProgressDownloadResult) => void	否	下载进度回调
beforeUpdate	(version: string) => boolean | void	否	更新前回调，返回 false 可阻止更新
onSuccess	() => void	否	更新成功回调
onFail	(error: string) => void	否	更新失败回调
onConfirm	() => void	否	用户点击确认按钮回调
onCancel	() => void	否	用户点击取消按钮回调

OnProgressDownloadResult

参数名	类型	说明
progress	number	下载进度百分比（0-100）
totalBytesWritten	number	已下载字节数
totalBytesExpectedToWrite	number	预期总字节数

函数列表

updateVersion(options) => void

检查并执行应用版本更新，支持 iOS 和 Android 平台。

参数

参数名	类型	必填	默认值	说明
options	UpdateVersionOptions	是	-	更新配置选项

返回值

类型	说明
void	无返回值

示例

import { appInit } from '@hy-app/ui';

appInit.updateVersion({
    version: '1.0.1',
    description: '1. 修复了已知bug\n2. 优化了性能',
    url: 'https://example.com/app.apk',
    force: true,
    onProgress: (res) => {
        console.log(`下载进度: ${res.progress}%`);
    },
});

---

compareVersion(serverVersion, localVersion) => number

比较两个版本号的大小。

参数

参数名	类型	必填	默认值	说明
serverVersion	string	是	-	服务端版本号
localVersion	string	是	-	本地版本号

返回值

类型	说明
number	1 服务端版本更高，0 版本相同，-1 本地版本更高

示例

import { appInit } from '@hy-app/ui';

const result = appInit.compareVersion('1.2.0', '1.1.9');

if (result === 1) {
    // 需要更新
}

---

downloadApp(downloadUrl, callbacks) => void

下载更新包，支持 .wgt 和 .apk 格式。

参数

参数名	类型	必填	默认值	说明
downloadUrl	string	是	-	下载地址
callbacks		否	-	回调函数

返回值

类型	说明
void	无返回值