stellar-ui-v2 1.40.28 → 1.40.30

package/README.md

@@ -10,9 +10,9 @@
 
 ## ✨ 特性
 
-- 🎯 多平台覆盖，支持 微信小程序、支付宝小程序、H5.
-- 🚀 40+ 个高质量组件，覆盖移动端主流场景.
-- 📖 提供丰富的文档和组件示例.
+- 🎯 多平台覆盖，支持 微信小程序、支付宝小程序、H5.
+- 🚀 40+ 个高质量组件，覆盖移动端主流场景.
+- 📖 提供丰富的文档和组件示例.
 - 🎨 支持修改 CSS 变量实现主题定制.
 
 ## 📱 预览
@@ -75,11 +75,11 @@ npm i stellar-ui-v2 -S
 
 ## 周边生态
 
-| 项目																							| 描述															|
-| ---																							| ---															|
-|[StellarUI-Plus](https://github.com/wuhanshuzhiyun/stellar-ui-plus)							| 一个基于vue3构建，打造的uni-app组件库								|
-|[ste-vue-inset-loader](https://github.com/wuhanshuzhiyun/ste-vue-inset-loader)					|常用于小程序需要全局引入组件的场景的包								|
-|[ste-helper](https://github.com/wuhanshuzhiyun/stellar-ui-plus/tree/main/plugins/ste-helper)	|旨在帮助开发者更加有效率的使用 StellarUI-Plus来开发项目的vscode插件	|
+| 项目																							| 描述															|
+| ---																							| ---															|
+|[StellarUI-Plus](https://github.com/wuhanshuzhiyun/stellar-ui-plus)							| 一个基于vue3构建，打造的uni-app组件库								|
+|[ste-vue-inset-loader](https://github.com/wuhanshuzhiyun/ste-vue-inset-loader)					|常用于小程序需要全局引入组件的场景的包								|
+|[ste-helper](https://github.com/wuhanshuzhiyun/stellar-ui-plus/tree/main/plugins/ste-helper)	|旨在帮助开发者更加有效率的使用 StellarUI-Plus来开发项目的vscode插件	|
 |[ste-cli](https://github.com/wuhanshuzhiyun/ste-cli)											|stellar配套的脚手架												|
 
 ## 核心团队

package/components/ste-app-update/README.md

@@ -9,9 +9,15 @@
 
 - 属性`clientId`用于设置APP的应用编码
 - 属性`clientSecret`用于设置APP的应用密钥
+- 属性`fallbackApiUrl`用于设置兜底检查接口地址
 - 函数`start`用于开始检查更新
+- 函数`getSkippedVersions`用于获取跳过版本列表
+- 函数`clearSkippedVersions`用于清空跳过版本记录
 - 回调事件`cancel`取消更新
-- 回调事件`complete`取消，成功更新都会执行
+- 回调事件`update`发现新版时触发
+- 回调事件`no-update`没有新版时触发
+- 回调事件`skip-version`跳过版本时触发
+- 回调事件`fallback`命中兜底更新时触发
 
 ```html
 <script>
@@ -31,12 +37,34 @@ export default {
 				});
 			}
 		},
+		// 获取跳过版本列表
+		getSkippedList() {
+			if (this.$refs.appUpdate) {
+				const list = this.$refs.appUpdate.getSkippedVersions();
+				console.log('已跳过的版本：', list);
+			}
+		},
+		// 清空跳过记录
+		clearSkipped() {
+			if (this.$refs.appUpdate) {
+				this.$refs.appUpdate.clearSkippedVersions();
+			}
+		},
 	},
 };
 </script>
 <template>
-    <ste-app-update ref="appUpdate" clientId="workbench_android" clientSecret="gkS6lEEncqAocYK2qsrvPQZykm3ISeMx"></ste-app-update>
+    <ste-app-update 
+        ref="appUpdate" 
+        clientId="workbench_android" 
+        clientSecret="gkS6lEEncqAocYK2qsrvPQZykm3ISeMx"
+        fallbackApiUrl="https://example.com/api/app-update/check"
+        @skip-version="onSkipVersion"
+        @fallback="onFallback"
+    ></ste-app-update>
     <button @click="checkForUpdates">检查更新</button>
+    <button @click="getSkippedList">获取跳过版本列表</button>
+    <button @click="clearSkipped">清空跳过记录</button>
 </template>
 ```
 
@@ -45,23 +73,34 @@ export default {
 ### API
 
 #### Props
-| 属性名				| 说明																| 类型							| 默认值																																									| 可选值	| 支持版本	|
-| -----					| -----															| ---							| -------																																								| ------| --------|
-| `clientId`		| 应用编码														| `string`				| -																																											| -			| -				|
-| `clientSecret`| 应用密钥														| `string`				| -																																											| -			| -				|
-| `apiUrl`			| 更新API地址												| `string`				| `https://zboa.whzb.com/inte-cloud-dev/blade-system/api/inte/client/ver/currentDetail`	| -			| -				|
-| `appType`			| APP环境,版本号的最后一位为环境标识	| `string`				| -																																											| -			| -				|
-| `btnText`			| 立即体验按钮文本										| `string`				| `立即体验`																																							| -			| -				|
-| `appVersion`	| 应用当前版本												| `string`				| -																																											| -			| `1.40.9`|
-| `zIndex`			| 弹窗层级														| `string/number`	| `998`																																									| -			| `1.40.9`|
+| 属性名				| 说明																				| 类型							| 默认值																																	| 可选值	| 支持版本	|
+| -----					| -----																			| ---							| -------																																	| ------| --------|
+| `clientId`		| 应用编码																	| `string`					| -																																								| -			| -				|
+| `clientSecret`| 应用密钥																	| `string`					| -																																								| -			| -				|
+| `apiUrl`			| 更新API地址															| `string`					| `https://zboa.whzb.com/inte-cloud-dev/blade-system/api/inte/client/ver/currentDetail`	| -			| -				|
+| `appType`			| APP环境,版本号的最后一位为环境标识	| `string`					| -																																								| -			| -				|
+| `btnText`			| 立即体验按钮文本											| `string`					| `立即体验`																																			| -			| -				|
+| `appVersion`	| 应用当前版本															| `string`					| -																																								| -			| `1.40.9`|
+| `zIndex`			| 弹窗层级																		| `string/number`	| `998`																																							| -			| `1.40.9`|
+| `fallbackApiUrl`| 兜底检查接口地址										| `string`					| -																																								| -			| `1.41.0`|
 
 
 #### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
 | `cancel` | 取消更新 | - | - |
-| `update` | 发现新版时本触发 | - | - |
-| `no-update` | 没有新版时本触发 | - | - |
+| `update` | 发现新版时触发 | - | - |
+| `no-update` | 没有新版时触发 | - | - |
+| `skip-version` | 跳过版本时触发 | version: string | `1.41.0` |
+| `fallback` | 命中兜底更新时触发 | { title, description, downloadUrl } | `1.41.0` |
+
+
+#### Methods
+| 方法名 | 说明 | 返回值 | 支持版本 |
+| ----- | ----- | ----- | -------- |
+| `start(callback)` | 开始检查更新 | - | - |
+| `getSkippedVersions()` | 获取已跳过的版本列表 | string[] | `1.41.0` |
+| `clearSkippedVersions()` | 清空跳过版本记录 | - | `1.41.0` |
 
 
 ---$

package/components/ste-app-update/method.js

@@ -1,10 +1,31 @@
 export function download(data, { success, error, onProgressUpdate, downloadSuccess }) {
 	const package_type = data.package_type;
+	let timeout;
+
+	// 参数验证
+	if (!data.updateFile) {
+		const errorMsg = '更新文件地址不能为空';
+		uni.showToast({ title: errorMsg, icon: 'none' });
+		error && error(new Error(errorMsg));
+		throw new Error(errorMsg);
+	}
+
 	const downloadTask = uni.downloadFile({
 		url: data.updateFile,
 		success: (res) => {
+			clearTimeout(timeout);
+
 			if (res.statusCode === 200) {
+				// 文件完整性检查
+				if (!res.tempFilePath) {
+					const errorMsg = '下载文件路径为空';
+					uni.showToast({ title: errorMsg, icon: 'none' });
+					error && error(new Error(errorMsg));
+					return;
+				}
+
 				downloadSuccess && downloadSuccess(res.tempFilePath);
+
 				plus.runtime.install(
 					res.tempFilePath,
 					{ force: true },
@@ -27,10 +48,11 @@ export function download(data, { success, error, onProgressUpdate, downloadSucce
 						}
 					},
 					(e) => {
-						//提示部分wgt包无法安装的问题
+						// 提示部分wgt包无法安装的问题
+						const errorMsg = e.message || '安装失败';
 						uni.showModal({
 							title: '提示',
-							content: e.message,
+							content: errorMsg,
 							showCancel: false,
 							success: () => {
 								error && error(e);
@@ -38,11 +60,87 @@ export function download(data, { success, error, onProgressUpdate, downloadSucce
 						});
 					}
 				);
+			} else {
+				const errorMsg = `下载失败，状态码：${res.statusCode}`;
+				uni.showToast({ title: errorMsg, icon: 'none' });
+				error && error(new Error(errorMsg));
 			}
 		},
+		fail: (err) => {
+			clearTimeout(timeout);
+			const errorMsg = `网络请求失败：${err.errMsg || '未知错误'}`;
+			uni.showToast({ title: errorMsg, icon: 'none' });
+			error && error(err);
+		}
 	});
-	// 下载进度
+
+	// 下载进度监控
 	downloadTask.onProgressUpdate((res) => {
-		onProgressUpdate && onProgressUpdate(res);
+		// 添加进度验证
+		if (res.progress >= 0 && res.progress <= 100) {
+			onProgressUpdate && onProgressUpdate(res);
+		}
+
+		// 重置超时计时器
+		clearTimeout(timeout);
+		timeout = setTimeout(() => {
+			downloadTask.abort();
+			const errorMsg = '下载超时，请检查网络连接';
+			uni.showToast({ title: errorMsg, icon: 'none' });
+			error && error(new Error(errorMsg));
+		}, 300000); // 5分钟超时
 	});
+
+	// 初始超时设置
+	timeout = setTimeout(() => {
+		downloadTask.abort();
+		const errorMsg = '下载超时，请检查网络连接';
+		uni.showToast({ title: errorMsg, icon: 'none' });
+		error && error(new Error(errorMsg));
+	}, 300000);
+
+	return downloadTask;
 }
+
+// 获取设备唯一标识
+export const getDeviceId = () => {
+	// #ifdef APP-PLUS
+	return plus.device.uuid || '';
+	// #endif
+	// #ifndef APP-PLUS
+	return '';
+	// #endif
+};
+
+// 获取当前平台
+export const getPlatform = () => {
+	// #ifdef APP-PLUS
+	return plus.os.name?.toLowerCase() || 'android';
+	// #endif
+	// #ifndef APP-PLUS
+	return 'unknown';
+	// #endif
+};
+
+// 获取APPID
+export const getAppId = () => {
+	// #ifdef APP-PLUS
+	return plus.runtime.appid || '';
+	// #endif
+	// #ifndef APP-PLUS
+	return '';
+	// #endif
+};
+
+// 获取当前版本号
+export const getVersion = (appVersion) => {
+	return new Promise((resolve) => {
+		if (appVersion) {
+			resolve(appVersion);
+		} else {
+			plus.runtime.getProperty(plus.runtime.appid || '', (inf) => {
+				resolve(inf.version || '');
+			});
+		}
+	});
+};