@zfqh/uniapp 0.2.27 → 0.2.28

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.2.28](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.27...@zfqh/uniapp@0.2.28) (2026-07-02)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
 ## [0.2.27](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.26...@zfqh/uniapp@0.2.27) (2026-06-30)
 
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/utils/update.md

@@ -27,16 +27,18 @@ import { checkVersion, installUpdate, restartApp } from '@zfqh/uniapp';
 检查指定应用是否有新版本可用。
 
 ```ts
-function checkVersion(appId: string): Promise<VersionInfo | null>
+function checkVersion(appId: string): Promise<CheckVersionResult>
 ```
 
-- 返回 `VersionInfo` 表示有可用更新
-- 返回 `null` 表示已是最新版本或检查失败
+- `code`: `0` 表示无更新或检查失败，`1` 表示有新版本可用
+- `data.info`: 本地版本信息（`versionCode` 已归一化为 `number`）
+- `data.latest`: 远端最新版本信息（`VersionInfo`），无数据时为 `undefined`
+- `message`: 失败时的错误信息
 
 ```ts
-const versionInfo = await checkVersion('com.example.app');
-if (versionInfo) {
-  console.log('发现新版本', versionInfo.name, versionInfo.version);
+const { code, data } = await checkVersion('com.example.app');
+if (code === 1 && data.latest) {
+  console.log('发现新版本', data.latest.name, data.latest.version);
 }
 ```
 
@@ -51,7 +53,7 @@ function installUpdate(options: InstallOptions): void
 ```ts
 installUpdate({
   appId: 'com.example.app',
-  url: versionInfo.fileUrl || versionInfo.hotUpdateUrl,
+  url: data.latest.fileUrl || data.latest.hotUpdateUrl,
   progress(p) {
     console.log(`下载进度: ${p}%`);
   },
@@ -91,6 +93,26 @@ restartApp();
 
 ## 类型定义
 
+### CheckVersionResult
+
+```ts
+interface CheckVersionResult {
+  code: number;
+  data: {
+    info: { versionCode: number; versionName: string };
+    latest: VersionInfo;
+  };
+  message: string;
+}
+```
+
+| 字段 | 说明 |
+| --- | --- |
+| `code` | `0` 无更新或失败，`1` 有新版本 |
+| `data.info` | 本地版本信息 |
+| `data.latest` | 远端最新版本信息 |
+| `message` | 失败时的错误信息 |
+
 ### VersionInfo
 
 ```ts
@@ -140,10 +162,10 @@ import { checkVersion, installUpdate, restartApp } from '@zfqh/uniapp';
 import { config } from '@zfqh/uniapp';
 
 async function doUpdate() {
-  const info = await checkVersion(config.app.appId);
-  if (!info) return;
+  const { code, data } = await checkVersion(config.app.appId);
+  if (code !== 1 || !data.latest) return;
 
-  const url = info.hotUpdateUrl || info.fileUrl;
+  const url = data.latest.hotUpdateUrl || data.latest.fileUrl;
   if (!url) return;
 
   installUpdate({

package/lib/utils/update.d.ts

@@ -15,6 +15,16 @@ export interface InstallOptions {
         message: string;
     }) => void;
 }
-export declare function checkVersion(appId: string, cb?: any): Promise<VersionInfo | null>;
+export declare function checkVersion(appId: string): Promise<{
+    code: number;
+    data: {
+        info: {
+            versionCode: number;
+            versionName: string;
+        };
+        latest: VersionInfo;
+    };
+    message: string;
+}>;
 export declare function installUpdate(options: InstallOptions): void;
 export declare function restartApp(): void;

package/lib/utils/update.js

@@ -34,27 +34,31 @@ function appGetProperty(appId) {
 // #ifdef H5
 function h5GetProperty(appId) {
     return new Promise((resolve) => {
-        if (appId === app.appId) {
-            resolve({ version: ver.name, versionCode: ver.code });
-        }
-        else if (window.electron) {
+        if (appId !== app.appId && window.electron) {
             window.electron.webUtils.getProperty(appId, (manifest) => resolve(manifest || {}));
         }
+        else {
+            resolve({ version: ver.name, versionCode: ver.code });
+        }
     });
 }
 // #endif
-export async function checkVersion(appId, cb) {
+export async function checkVersion(appId) {
+    let info;
+    let latest;
+    let code = 0;
+    let message = '';
     try {
         let version = 0;
-        let data = null;
         // #ifdef APP
-        data = await appGetProperty(appId);
-        version = data.versionCode || 0;
+        info = await appGetProperty(appId);
+        version = Number(info.versionCode || 0);
         // #endif
         // #ifdef H5
-        data = await h5GetProperty(appId);
-        version = data.versionCode || 0;
+        info = await h5GetProperty(appId);
+        version = Number(info.versionCode || 0);
         // #endif
+        info.versionCode = version;
         let type = 3;
         let plat;
         if (!IS_WEBVIEW_ENV && appId === app.appId) {
@@ -67,26 +71,32 @@ export async function checkVersion(appId, cb) {
             type,
             platform: plat,
         }, { custom: { message: false } });
-        const lastVer = { ...res?.data };
-        if (typeof cb === 'function') {
-            cb(lastVer);
-        }
-        // #ifdef APP
-        if (uni.$store?.state?.dict && platform === 'android' && appId === app.appId && env.key === 'prod') {
-            await uni.$store.dispatch('getDictInfo', { name: 'group_relation', cache: true });
-            if (uni.$store.state.dict.info.group_relation?.values?.includes(brand)) {
-                lastVer.hotUpdateUrl = '';
+        latest = res?.data;
+        if (latest) {
+            // #ifdef APP
+            if (uni.$store?.state?.dict && platform === 'android' && appId === app.appId && env.key === 'prod') {
+                await uni.$store.dispatch('getDictInfo', { name: 'group_relation', cache: true });
+                if (uni.$store.state.dict.info.group_relation?.values?.includes(brand)) {
+                    latest.hotUpdateUrl = '';
+                }
+            }
+            // #endif
+            if (Number(latest.version) > Number(version)) {
+                code = 1;
             }
         }
-        // #endif
-        if (Number(lastVer.version) > Number(version)) {
-            return lastVer;
-        }
-        return null;
     }
-    catch {
-        return null;
+    catch (e) {
+        message = e?.message || e?.data?.message || e?.data?.msg || '';
     }
+    return {
+        code,
+        data: {
+            info,
+            latest,
+        },
+        message,
+    };
 }
 // #ifdef APP
 function appInstall({ appId, url, progress, success, fail }) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.2.27",
+  "version": "0.2.28",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
@@ -46,5 +46,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "6bc8ded30fa266be58a4affc226f9b540b32b006"
+  "gitHead": "40a5dcdb57439185a27c906c03a97f55f87de58a"
 }