@zfqh/uniapp 0.3.15 → 0.3.16

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.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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 aniu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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/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.15",
+  "version": "0.3.16",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
@@ -45,5 +45,6 @@
     "@types/crypto-js": "^4.2.2",
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
-  }
+  },
+  "gitHead": "482fb66642df55a676ac10fb902cba10da3720d2"
 }