@zfqh/uniapp 0.3.14 → 0.3.16

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.3.16](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.3.15...@zfqh/uniapp@0.3.16) (2026-09-03)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## [0.3.15](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.3.14...@zfqh/uniapp@0.3.15) (2026-08-28)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
 ## [0.3.14](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.3.13...@zfqh/uniapp@0.3.14) (2026-08-15)
 
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/utils/update.md

@@ -31,7 +31,7 @@ function checkVersion(options: CheckVersionOptions): Promise<CheckVersionResult>
 ```
 
 - `code`: `0` 表示无更新或检查失败，`1` 表示有新版本可用
-- `data.info`: 本地版本信息（`versionCode` 已归一化为 `number`）
+- `data.info`: 本地版本信息（`versionCode` 已归一化为 `number`）；传入 `versionCode` 时即为传入值
 - `data.latest`: 远端最新版本信息（`VersionInfo`），无数据时为 `undefined`
 - `message`: 失败时的错误信息
 
@@ -42,6 +42,21 @@ if (code === 1 && data.latest) {
 }
 ```
 
+下载失败重试时，建议回传首次检查记住的 `data.info`，跳过本地版本读取，以首次基线重新对比，避免期间本地版本发生变化导致 `code` 返回 `0`：
+
+```ts
+// 首次检查：记住基线
+const { code, data } = await checkVersion({ appId: 'com.example.app' });
+const info = data.info;
+
+// 重试：传入首次基线版本
+const retry = await checkVersion({
+  appId: 'com.example.app',
+  versionCode: info.versionCode,
+  versionName: info.versionName,
+});
+```
+
 ### installUpdate
 
 下载并安装更新包。
@@ -98,12 +113,18 @@ restartApp();
 ```ts
 interface CheckVersionOptions {
   appId: string;
+  path?: string;
+  versionCode?: number;
+  versionName?: string;
 }
 ```
 
 | 字段 | 说明 |
 | --- | --- |
 | `appId` | 目标应用 ID |
+| `path` | 子应用安装目录，App 端用于读取本地 `manifest.json`（默认 `_doc/`） |
+| `versionCode` | 指定本地版本号（`number`）。传入后跳过本地 manifest 读取，直接以该值作为检查基线（下载失败重试场景） |
+| `versionName` | 指定本地版本名称，与 `versionCode` 配套，回填到返回的 `data.info` |
 
 ### CheckVersionResult
 
@@ -163,7 +184,7 @@ interface InstallOptions {
 | --- | --- |
 | `appId` | 目标应用 ID |
 | `url` | 安装包下载地址 |
-| `progress` | 下载进度回调（0-100） |
+| `progress` | 下载进度回调（0-99 的整数，下载完成时回调 100） |
 | `success` | 安装成功回调 |
 | `fail` | 安装失败回调 |
 

package/lib/utils/permit.js

@@ -118,10 +118,6 @@ export async function requestPermission(name, system = true) {
             break;
         }
         case 'storage': {
-            result = await requestMpPermission('scope.userLocation');
-            break;
-        }
-        case 'bluetooth': {
             break;
         }
         default: {

package/lib/utils/query.js

@@ -1,10 +1,9 @@
 const query = {};
 export function parseQuery(search = '') {
-    search = decodeURIComponent(search);
     const q = {};
     search.split('&').forEach((value) => {
         const [key, val] = value.split('=');
-        q[key] = val;
+        q[key] = decodeURIComponent(val);
     });
     return q;
 }

package/lib/utils/update.d.ts

@@ -19,6 +19,10 @@ export interface InstallOptions {
 export interface CheckVersionOptions {
     appId: string;
     path?: string;
+    /** 指定本地版本号，传入后跳过本地 manifest 读取（重试场景） */
+    versionCode?: number;
+    /** 指定本地版本名称，与 versionCode 配套 */
+    versionName?: string;
 }
 export declare function checkVersion(options: CheckVersionOptions): Promise<{
     code: number;

package/lib/utils/update.js

@@ -44,21 +44,27 @@ function h5GetProperty(appId, path) {
 }
 // #endif
 export async function checkVersion(options) {
-    const { appId } = options;
+    const { appId, versionCode = 0, versionName = '' } = options || {};
     let info;
     let latest;
     let code = 0;
     let message = '';
     try {
         let version = 0;
-        // #ifdef APP
-        info = await appGetProperty(appId, options.path);
-        version = Number(info.versionCode || 0);
-        // #endif
-        // #ifdef H5
-        info = await h5GetProperty(appId, options.path);
-        version = Number(info.versionCode || 0);
-        // #endif
+        if (options?.versionCode != null) {
+            info = { versionCode, versionName };
+            version = Number(info.versionCode || 0);
+        }
+        else {
+            // #ifdef APP
+            info = await appGetProperty(appId, options.path);
+            version = Number(info.versionCode || 0);
+            // #endif
+            // #ifdef H5
+            info = await h5GetProperty(appId, options.path);
+            version = Number(info.versionCode || 0);
+            // #endif
+        }
         info.versionCode = version;
         let type = 3;
         let plat;
@@ -107,25 +113,30 @@ function appInstall({ appId, url, path, progress, success, fail }) {
             if (res.statusCode !== 200)
                 return fail?.({ message: 'download failed' });
             progress?.(100);
-            if (appId === app.appId) {
-                plus.runtime.install(res.tempFilePath, { force: true }, success, fail);
-            }
-            else {
-                plus.io.resolveLocalFileSystemURL('_doc/', (docDir) => {
-                    if (path) {
-                        docDir.getDirectory(path, { create: true }, (subDir) => {
-                            plus.zip.decompress(res.tempFilePath, subDir.fullPath, success, fail);
-                        }, (e) => fail?.({ message: e?.message || String(e) }));
-                    }
-                    else {
-                        plus.zip.decompress(res.tempFilePath, docDir.fullPath, success, fail);
-                    }
-                }, (e) => fail?.({ message: e?.message || String(e) }));
-            }
+            setTimeout(() => {
+                if (appId === app.appId) {
+                    plus.runtime.install(res.tempFilePath, { force: true }, success, fail);
+                }
+                else {
+                    plus.io.resolveLocalFileSystemURL('_doc/', (docDir) => {
+                        if (path) {
+                            docDir.getDirectory(path, { create: true }, (subDir) => {
+                                plus.zip.decompress(res.tempFilePath, subDir.fullPath, success, fail);
+                            }, (e) => fail?.({ message: e?.message || String(e) }));
+                        }
+                        else {
+                            plus.zip.decompress(res.tempFilePath, docDir.fullPath, success, fail);
+                        }
+                    }, (e) => fail?.({ message: e?.message || String(e) }));
+                }
+            }, 1000);
         },
         fail: (e) => fail?.({ message: e?.errMsg || String(e) }),
     });
-    downloadTask.onProgressUpdate(({ progress: p }) => progress?.(p));
+    downloadTask.onProgressUpdate(({ progress: p }) => {
+        const value = Number.isFinite(p) ? Math.min(99, Math.max(0, Math.floor(p))) : 0;
+        progress?.(value);
+    });
 }
 // #endif
 // #ifdef H5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.3.14",
+  "version": "0.3.16",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
@@ -46,5 +46,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "74b0768a80522cef891995db7aad9f9ed8e1f64c"
+  "gitHead": "482fb66642df55a676ac10fb902cba10da3720d2"
 }