@zfqh/uniapp 0.3.15 → 0.3.17

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.17](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.3.16...@zfqh/uniapp@0.3.17) (2026-09-03)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## [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/consts.md

@@ -192,10 +192,37 @@ if (config.mp.envVersion === MP_ENV_VERSION.develop) {
 
 ## LANGUAGE 使用示例
 
-当前语言标识，用于请求 header 和国际化。
+当前语言标识，用于请求 header 和国际化。key 为 uni-app/vue-i18n 的 locale 标识，value 为请求头 `X-Language` 的语言代码。
 
 ```ts
 import { LANGUAGE } from '@zfqh/uniapp';
 
-headers['X-Language'] = LANGUAGE;
+// locale 取 uni.getLocale() / uni.$i18n.global.locale 或宿主传入的 query.locale
+headers['X-Language'] = LANGUAGE[locale];
 ```
+
+### 支持的语言
+
+| 分组 | locale key | 语言 | X-Language 值 |
+| --- | --- | --- | --- |
+| 亚洲语言 | `zh-Hans` | 简体中文 | `zh-CN` |
+| 亚洲语言 | `zh-Hant` | 繁体中文 | `zh-TW` |
+| 亚洲语言 | `ja` | 日语 | `ja-JP` |
+| 亚洲语言 | `ko` | 韩语 | `ko-KR` |
+| 亚洲语言 | `ar` | 阿拉伯语 | `ar-SA` |
+| 亚洲语言 | `fa` | 伊朗语（波斯语） | `fa-IR` |
+| 亚洲语言 | `th` | 泰语 | `th-TH` |
+| 亚洲语言 | `vi` | 越南语 | `vi-VN` |
+| 亚洲语言 | `my` | 缅甸语 | `my-MM` |
+| 亚洲语言 | `km` | 柬埔寨语 | `km-KH` |
+| 欧洲语言 | `en` | 英语 | `en-US` |
+| 欧洲语言 | `fr` | 法语 | `fr-FR` |
+| 欧洲语言 | `es` | 西班牙语 | `es-ES` |
+| 欧洲语言 | `ru` | 俄语 | `ru-RU` |
+| 欧洲语言 | `pt` | 葡萄牙语 | `pt-PT` |
+| 欧洲语言 | `de` | 德语 | `de-DE` |
+| 欧洲语言 | `it` | 意大利语 | `it-IT` |
+| 欧洲语言 | `el` | 希腊语 | `el-GR` |
+| 欧洲语言 | `pl` | 波兰语 | `pl-PL` |
+
+> **提示**：`LANGUAGE[uni.getLocale()]` 仅在对应 locale 已注册到业务侧 vue-i18n `messages` 时才能命中；未注册时 `uni.getLocale()` 会回退到 `fallbackLocale`（`zh-Hans`）。宿主可通过 `query.locale`（如 `?locale=ar`）直接指定语言。

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/apis/request.js

@@ -36,7 +36,7 @@ http.interceptors.request.use((conf) => {
         }
         // #endif
         const header = {
-            'X-Language': LANGUAGE[query.locale || uni.getLocale()],
+            'X-Language': query.xLanguage || LANGUAGE[query.locale || uni.getLocale()],
             'Tenant-Id': tenantId || 1,
             channel,
             terminal,

package/lib/mixins/webview.js

@@ -1,6 +1,6 @@
 import Url from 'url-parse';
 import { stringify, parse } from 'qs';
-import { PLATFORM_CODE, IS_WEBVIEW_ENV, SYSTEM_INFO, TYPES } from '../utils/consts';
+import { PLATFORM_CODE, IS_WEBVIEW_ENV, SYSTEM_INFO, TYPES, LANGUAGE } from '../utils/consts';
 import app from '../configs/app';
 import { requestPermission, openAuthorizeSetting } from '../utils/permit';
 import web from '../configs/web';
@@ -39,6 +39,7 @@ export default {
                 safeTop: SYSTEM_INFO.safeAreaInsets.top,
                 safeBottom: SYSTEM_INFO.safeAreaInsets.bottom,
                 locale: uni.$i18n?.global?.locale,
+                xLanguage: LANGUAGE[uni.$i18n?.global?.locale],
                 accelerate: cdn.isAccelerate ? 1 : undefined,
             };
             if (query.primary) {

package/lib/utils/consts.d.ts

@@ -30,9 +30,22 @@ export declare const LANGUAGE: {
     'zh-Hans': string;
     'zh-Hant': string;
     ja: string;
+    ko: string;
+    ar: string;
+    fa: string;
+    th: string;
+    vi: string;
+    my: string;
+    km: string;
     en: string;
     fr: string;
     es: string;
+    ru: string;
+    pt: string;
+    de: string;
+    it: string;
+    el: string;
+    pl: string;
 };
 export declare const TYPES: {
     readonly MESSAGE: {

package/lib/utils/consts.js

@@ -60,12 +60,27 @@ export var CHANNEL;
     CHANNEL[CHANNEL["\u95E8\u5E97\u7AEF"] = 3] = "\u95E8\u5E97\u7AEF";
 })(CHANNEL || (CHANNEL = {}));
 export const LANGUAGE = {
-    'zh-Hans': 'zh-CN',
-    'zh-Hant': 'zh-TW',
-    ja: 'ja-JP',
-    en: 'en-US',
-    fr: 'fr-FR',
-    es: 'es-ES',
+    // 亚洲语言
+    'zh-Hans': 'zh-CN', // 简体中文
+    'zh-Hant': 'zh-TW', // 繁体中文
+    ja: 'ja-JP', // 日语
+    ko: 'ko-KR', // 韩语
+    ar: 'ar-SA', // 阿拉伯语
+    fa: 'fa-IR', // 伊朗语（波斯语）
+    th: 'th-TH', // 泰语
+    vi: 'vi-VN', // 越南语
+    my: 'my-MM', // 缅甸语
+    km: 'km-KH', // 柬埔寨语
+    // 欧洲语言
+    en: 'en-US', // 英语
+    fr: 'fr-FR', // 法语
+    es: 'es-ES', // 西班牙语
+    ru: 'ru-RU', // 俄语
+    pt: 'pt-PT', // 葡萄牙语
+    de: 'de-DE', // 德语
+    it: 'it-IT', // 意大利语
+    el: 'el-GR', // 希腊语
+    pl: 'pl-PL', // 波兰语
 };
 // webview 与宿主环境通信的消息类型
 export const TYPES = {

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.17",
   "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": "d56ac10822cd04b832695122cc7daa21e67d6628"
 }