@zfqh/uniapp 0.2.11 → 0.2.15

package/CHANGELOG.md

@@ -3,6 +3,38 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.2.15](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.14...@zfqh/uniapp@0.2.15) (2026-06-25)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## [0.2.14](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.13...@zfqh/uniapp@0.2.14) (2026-06-25)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## [0.2.13](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.12...@zfqh/uniapp@0.2.13) (2026-06-25)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
+## [0.2.12](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.11...@zfqh/uniapp@0.2.12) (2026-06-25)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
 ## [0.2.11](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.10...@zfqh/uniapp@0.2.11) (2026-06-24)
 
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/apis/core.md

@@ -6,7 +6,7 @@
 | --- | --- | --- | --- |
 | `sendSmsCode` | `POST` | `/admin-api/system/auth/send-checkCode` | 发送短信验证码。 |
 | `getTencentToken` | `GET` | `/app-api/infra/file/getTencentToken` | 获取腾讯上传临时 Token。 |
-| `getLastVersion` | `POST` | `/app-api/system/app/version/get-last-version` | 获取最新版本。 |
+| `getLastVersion` | `POST` | `/app-api/system/app/version/get-last-version-v2` | 获取最新版本。 |
 | `getCosUrls` | `POST` | `/app-api/infra/cos/getUrls` | 获取 COS 签名后的地址。 |
 | `postRefreshToken` | `POST` | `/app-api/robot/store/auth/refreshToken?refreshToken=:refreshToken` | 刷新 token。 |
 | `getDictData` | `GET` | `/app-api/system/dict-data/type` | 获取字典数据。 |

package/docs/api/configs/index.md

@@ -109,7 +109,6 @@ export default defineEnvConfig({
 | `path` | `configs/path.ts` | 页面别名配置。 |
 | `link` | `configs/link.ts` | 外部链接配置。 |
 | `page` | `configs/page.ts` | 页面集合、tabBar、原生页、登录页集合。 |
-| `update` | `configs/update.ts` | App 更新请求函数。 |
 | `upload` | `configs/upload.ts` | 上传临时凭证请求函数。 |
 | `navigate` | `configs/navigate.ts` | 登录跳转方式和来源页策略。 |
 | `ver` | `configs/ver.ts` | 当前版本号和版本名。 |
@@ -316,22 +315,6 @@ defineConfig({
 }
 ```
 
-## update
-
-App 更新能力依赖 `update.request`：
-
-```ts
-defineConfig({
-  update: {
-    request(data) {
-      return POST('/app-api/system/app/version/latest', data);
-    },
-  },
-});
-```
-
-返回数据可包含 `hot_update`、`force_update`、`wgt_url`、`apk_url`、`ipa_url`、`exe_url`、`dmg_url` 等字段。
-
 ## storage
 
 ```ts

package/docs/api/mixins/app.md

@@ -5,10 +5,10 @@ App.vue 全局生命周期 mixin。发布路径：`@zfqh/uniapp/lib/mixins/app`
 | 项 | 说明 |
 | --- | --- |
 | `computed isConnected/isLogin/unreadCount` | 读取网络、登录、未读数 getter。 |
-| `watch isConnected` | 网络恢复后非 H5 端触发 update.check()。 |
+| `watch isConnected` | 网络恢复后触发网络状态更新。 |
 | `watch unreadCount` | App 端同步应用角标。 |
 | `onLaunch(e)` | 初始化网络监听，并在启动页命中 needLoginPages 且未登录时触发登录导航。 |
-| `onShow(e)` | 记录 launch 信息，并在非开发环境检查更新。 |
+| `onShow(e)` | 记录 launch 信息。 |
 
 ## 基本使用
 

package/docs/api/utils/index.md

@@ -25,7 +25,7 @@
 | [throttle](./throttle) | 节流类和默认实例。 |
 | [toast](./toast) | loading、toast、success、error、fail、exception 和自定义提示适配。 |
 | [uni](./uni) | 平台运行时补丁或内部实现。 |
-| [update](./update) | App、Electron H5、小程序更新。 |
+| [update](./update) | 版本检查、应用安装和重启。 |
 
 ## 通用工具
 

package/docs/api/utils/update.md

@@ -4,162 +4,160 @@
 `@zfqh/uniapp/lib/utils/update`
 :::
 
-统一检查 App、Electron H5、小程序更新，处理热更新、整包更新和应用重启。
+提供版本检查、应用安装和重启能力，支持 App 和 H5（Electron / WebView）多端。
 
 ## 平台兼容性
 
-| App | H5 | 微信小程序 | 其他小程序 | WebView |
-| --- | --- | --- | --- | --- |
-| √ | √ | √ | 视平台 API 而定 | 视运行容器而定 |
+| App | H5（Electron） | H5（WebView） |
+| --- | --- | --- |
+| √ | √ | √ |
 
 ## 基本使用
 
 ```ts
-import { update } from '@zfqh/uniapp';
+import { checkVersion, installUpdate, restartApp } from '@zfqh/uniapp';
 ```
 
-## 检查更新
+## API
 
-```ts
-import { update } from '@zfqh/uniapp';
+发布路径：`@zfqh/uniapp/lib/utils/update`
 
-// 常规检查（弹出确认框让用户选择）
-await update.check();
+### checkVersion
 
-// 强制更新（跳过确认框，直接下载）
-await update.check(true);
+检查指定应用是否有新版本可用。
+
+```ts
+function checkVersion(appid: string): Promise<VersionInfo | null>
 ```
 
-`check(immediate?: boolean)` 会根据平台自动选择更新方式：
+- 返回 `VersionInfo` 表示有可用更新
+- 返回 `null` 表示已是最新版本或检查失败
 
-| 平台 | 更新方式 |
-| --- | --- |
-| App（Android/iOS） | 热更新（wgt）或整包更新（apk/ipa） |
-| H5（Electron） | 热更新（zip）或整包更新（exe/dmg） |
-| 微信小程序 | `getUpdateManager` 原生更新 |
+```ts
+const versionInfo = await checkVersion('com.example.app');
+if (versionInfo) {
+  console.log('发现新版本', versionInfo.name, versionInfo.version);
+}
+```
 
-## 配置 update.request
+### installUpdate
 
-需要在 `defineConfig` 中配置获取版本信息的请求函数：
+下载并安装更新包。
 
 ```ts
-import { defineConfig } from '@zfqh/uniapp';
-import { POST } from '@zfqh/uniapp/lib/apis';
+function installUpdate(options: InstallOptions): void
+```
 
-defineConfig({
-  update: {
-    request(data) {
-      return POST('/app-api/system/app/version/latest', data);
-    },
+```ts
+installUpdate({
+  appid: 'com.example.app',
+  url: versionInfo.fileUrl || versionInfo.hotUpdateUrl,
+  progress(p) {
+    console.log(`下载进度: ${p}%`);
+  },
+  success() {
+    restartApp();
+  },
+  fail(error) {
+    console.error('安装失败', error.message);
   },
 });
 ```
 
-请求参数包含：
-
-| 字段 | 说明 |
-| --- | --- |
-| `appId` | 当前应用 ID |
-| `appName` | 当前应用名称 |
-| `versionCode` | 当前资源版本号 |
-| `versionName` | 当前资源版本名 |
-| `appVersionCode` | 当前程序版本号 |
-| `appVersionName` | 当前程序版本名 |
-| `platform` | 当前平台 |
-
-响应字段：
-
-| 字段 | 说明 |
+| 平台 | 行为 |
 | --- | --- |
-| `hot_update` | 是否热更新（1 = 热更新） |
-| `force_update` | 是否强制更新 |
-| `external_install` | 是否外部安装（Android 整包更新时跳浏览器） |
-| `wgt_url` | App WGT 热更新资源地址 |
-| `zip_url` | H5 Electron 热更新资源包地址 |
-| `apk_url` | Android 安装包地址 |
-| `ipa_url` | iOS 安装包地址 |
-| `exe_url` | Windows 安装包地址 |
-| `dmg_url` | macOS 安装包地址 |
+| App（主应用） | 下载文件后调用 `plus.runtime.install` 安装 |
+| App（子应用） | 下载后解压到 `_doc/` |
+| H5 WebView | 通过 `postMessage` 通知宿主安装 |
+| H5 Electron | 调用 `electron.webUtils.updateApp` |
 
-## 典型用法
+### restartApp
 
-在 `App.vue` 的 `onLaunch` 或 `onShow` 中检查更新：
+重启当前应用。
 
 ```ts
-import { update } from '@zfqh/uniapp';
-
-export default {
-  onShow() {
-    // 非开发环境检查更新
-    // #ifndef H5
-    update.check();
-    // #endif
-  },
-};
+function restartApp(): void
 ```
 
-在 Updater 组件中使用强制更新：
-
 ```ts
-// 用户点击"立即更新"按钮
-async function onUpdate() {
-  await update.check(true); // 立即更新，不弹确认框
-}
+restartApp();
 ```
 
-## API
-
-发布路径：`@zfqh/uniapp/lib/utils/update`
-
-| 名称 | 签名/声明 | 说明 |
-| --- | --- | --- |
-| `update.check(immediate?)` | `default export member` | 检查 App/H5 Electron/小程序更新；immediate 为 true 时尽量跳过确认直接下载或应用更新。 |
+| 平台 | 行为 |
+| --- | --- |
+| App | `plus.runtime.restart()` |
+| H5 WebView | 通过 `postMessage` 通知宿主重启 |
+| H5 Electron | `ipcRenderer.send('relaunch')` |
 
-## App 更新
+## 类型定义
 
-根入口导出：
+### VersionInfo
 
 ```ts
-import { update } from '@zfqh/uniapp';
+interface VersionInfo {
+  name: string;
+  version: string | number;
+  comment: string;
+  status: number;
+  hotUpdateUrl: string;
+  fileUrl: string;
+}
 ```
 
-更新配置：
+| 字段 | 说明 |
+| --- | --- |
+| `name` | 版本名称 |
+| `version` | 版本号 |
+| `comment` | 更新说明 |
+| `status` | 版本状态（> 2 为可用） |
+| `hotUpdateUrl` | 热更新资源地址 |
+| `fileUrl` | 整包下载地址 |
+
+### InstallOptions
 
 ```ts
-defineConfig({
-  update: {
-    request(data) {
-      return POST('/app-api/system/app/version/latest', data);
-    },
-  },
-});
+interface InstallOptions {
+  appid: string;
+  url: string;
+  progress?: (p: number) => void;
+  success?: () => void;
+  fail?: (error: { message: string }) => void;
+}
 ```
 
-请求参数可能包含：
-
 | 字段 | 说明 |
 | --- | --- |
-| `appId` | 当前应用 ID。 |
-| `appName` | 当前应用名称。 |
-| `versionCode` | 当前资源版本号。 |
-| `versionName` | 当前资源版本名。 |
-| `appVersionCode` | 当前程序版本号。 |
-| `appVersionName` | 当前程序版本名。 |
-| `platform` | 当前平台。 |
+| `appid` | 目标应用 ID |
+| `url` | 安装包下载地址 |
+| `progress` | 下载进度回调（0-100） |
+| `success` | 安装成功回调 |
+| `fail` | 安装失败回调 |
 
-响应字段可能包含：
+## 完整更新流程示例
 
-| 字段 | 说明 |
-| --- | --- |
-| `hot_update` | 是否热更新。 |
-| `version_code` | 新版本号。 |
-| `force_update` | 是否强制更新。 |
-| `external_install` | 是否外部安装。 |
-| `wgt_url` | App WGT 资源地址。 |
-| `zip_url` | 桌面资源包地址。 |
-| `apk_url` | Android 安装包地址。 |
-| `ipa_url` | iOS 安装包地址。 |
-| `exe_url` | Windows 安装包地址。 |
-| `dmg_url` | macOS 安装包地址。 |
-
-具体更新执行逻辑以 `@zfqh/uniapp/lib/utils/update` 的发布实现为准。
+```ts
+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 url = info.hotUpdateUrl || info.fileUrl;
+  if (!url) return;
+
+  installUpdate({
+    appid: config.app.appId,
+    url,
+    progress(p) {
+      // 更新进度 UI
+    },
+    success() {
+      restartApp();
+    },
+    fail(err) {
+      uni.showToast({ title: err.message, icon: 'none' });
+    },
+  });
+}
+```

package/docs/components/index.md

@@ -102,8 +102,3 @@ Options API 组件可使用 `this.$store`。普通 TS 模块中使用 `uni.$stor
 | [`g-trtc-room`](./g-trtc-room) | 音视频房间 UI 组件，包装 g-trtc、来电铃声、缩小悬浮和房间头部信息。 |
 | [`g-trtc-tui`](./g-trtc-tui) | 基于腾讯 TUIChatEngine 的通话邀请层，处理接听、挂断、消息监听和房间状态。 |
 
-### 运行时
-
-| 组件 | 说明 |
-| --- | --- |
-| [`g-env`](./g-env) | 环境切换入口，主要给 H5/Electron 调试环境使用，用于查看和切换当前 env。 |

package/docs/components/usage.md

@@ -42,7 +42,7 @@
 | 弹层反馈 | `g-mask`、`g-popup`、`g-permission-popup`、`g-float` | 遮罩、弹窗、权限提示、悬浮入口。 |
 | 分享 | `g-share-view`、`g-share-photo`、`g-share-weixin` | 分享面板、保存图片、微信分享。 |
 | 音视频/图表 | `g-trtc`、`g-trtc-room`、`g-trtc-tui`、`g-polyline-view`、`g-polyline-chat`、`g-timer` | TRTC、TUI 通话、折线展示、计时器。 |
-| 调试 | `g-env`、`g-back-button` | 环境切换、自定义返回/首页按钮。 |
+| 调试 | `g-back-button` | 自定义返回/首页按钮。 |
 
 ## Store 用法
 

package/lib/apis/core.js

@@ -4,7 +4,7 @@ export const sendSmsCode = (...args) => POST('/admin-api/system/auth/send-checkC
 /** 获取腾讯上传临时Token */
 export const getTencentToken = (...args) => GET('/app-api/infra/file/getTencentToken', ...args);
 /** 获取最新版本 */
-export const getLastVersion = (...args) => POST('/app-api/system/app/version/get-last-version', ...args);
+export const getLastVersion = (...args) => POST('/app-api/system/app/version/get-last-version-v2', ...args);
 /** 获取cos签名后的地址 */
 export const getCosUrls = (...args) => POST('/app-api/infra/cos/getUrls', ...args);
 /** 刷新token */

package/lib/configs/index.d.ts

@@ -5,7 +5,6 @@ import { TabbarConfig } from './tabbar';
 import { PathConfig } from './path';
 import { PageConfig } from './page';
 import { LinkConfig } from './link';
-import { UpdateConfig } from './update';
 import { UploadConfig } from './upload';
 import { NavigateConfig } from './navigate';
 import { ToastConfig } from './toast';
@@ -24,8 +23,6 @@ export interface DefineBaseConfig {
     link?: LinkConfig;
     /** 页面配置 */
     page?: PageConfig;
-    /** 更新配置 */
-    update?: UpdateConfig;
     /** 导航配置 */
     navigate?: NavigateConfig;
     /** 上传配置 */
@@ -126,8 +123,6 @@ declare const conf: {
         needLoginPages: string[];
         notRedirectPages: string[];
     };
-    /** 更新配置 */
-    update: UpdateConfig;
     /** 上传配置 */
     upload: UploadConfig;
     /** 导航配置 */

package/lib/configs/index.js

@@ -10,7 +10,6 @@ import tabbar from './tabbar';
 import path from './path';
 import page from './page';
 import link from './link';
-import update from './update';
 import upload from './upload';
 import navigate from './navigate';
 import toast from './toast';
@@ -41,8 +40,6 @@ const conf = {
     link,
     /** 页面配置 */
     page,
-    /** 更新配置 */
-    update,
     /** 上传配置 */
     upload,
     /** 导航配置 */

package/lib/index.d.ts

@@ -16,7 +16,6 @@ export * from './utils/subscribe';
 export * from './utils/permit';
 export * from './utils/audio';
 export { default as query } from './utils/query';
-export { default as update } from './utils/update';
 export { default as Debounce, debounce } from './utils/debounce';
 export { default as Throttle, throttle } from './utils/throttle';
 export { defineConfig, defineEnvConfig } from './configs';

package/lib/index.js

@@ -17,7 +17,6 @@ export * from './utils/subscribe';
 export * from './utils/permit';
 export * from './utils/audio';
 export { default as query } from './utils/query';
-export { default as update } from './utils/update';
 export { default as Debounce, debounce } from './utils/debounce';
 export { default as Throttle, throttle } from './utils/throttle';
 export { defineConfig, defineEnvConfig } from './configs';

package/lib/mixins/app.js

@@ -1,5 +1,4 @@
 import { IS_WEBVIEW_ENV } from '../utils/consts';
-import update from '../utils/update';
 import navigate from '../utils/navigate';
 import { inPages } from '../utils/pages';
 import page from '../configs/page';
@@ -17,12 +16,7 @@ export default {
     },
     watch: {
         isConnected(connected) {
-            // 网络恢复后检测更新
-            if (connected) {
-                // #ifndef H5
-                update.check().catch(() => { });
-                // #endif
-            }
+            // 网络恢复
         },
         // #ifdef APP
         unreadCount(e) {
@@ -92,14 +86,6 @@ export default {
                 // 设置启动信息
                 this.$store.commit('setLaunchInfo', e);
             }
-            if (process.env.NODE_ENV !== 'development') {
-                // 检测更新
-                setTimeout(() => {
-                    if (uni.showAppFromBackground) {
-                        update.check().catch(() => { });
-                    }
-                }, 1000);
-            }
         }
     },
 };

package/lib/utils/update.d.ts

@@ -1,9 +1,20 @@
-/**
- * 检测更新
- * @param immediate 是否立即更新，不显示确认框
- */
-declare function check(immediate?: boolean): Promise<void>;
-declare const _default: {
-    check: typeof check;
-};
-export default _default;
+export interface VersionInfo {
+    name: string;
+    version: string | number;
+    comment: string;
+    status: number;
+    hotUpdateUrl: string;
+    fileUrl: string;
+}
+export interface InstallOptions {
+    appid: string;
+    url: string;
+    progress?: (p: number) => void;
+    success?: () => void;
+    fail?: (error: {
+        message: string;
+    }) => void;
+}
+export declare function checkVersion(appid: string): Promise<VersionInfo | null>;
+export declare function installUpdate(options: InstallOptions): void;
+export declare function restartApp(): void;