更新记录

1.0.0（2026-03-06）

新功能

• APP升级弹出框组件
• 支持版本检测与版本号对比
• 支持更新内容展示（富文本）
• 支持下载进度显示
• 支持强制更新模式
• 支持自定义主题样式
• iOS跳转App Store
• Android下载APK并安装

平台兼容性

uni-app(4.81)

rd-upgrade APP升级弹出框插件

APP升级弹出框UTS插件，支持更新内容展示、强制更新、内置下载等功能。

功能特性

• 标题 + 更新内容展示
• 强制更新模式
• 头部图片自定义（支持网络图片）
• 内置下载功能，支持进度显示
• 支持APK/IPA下载、WGT热更新、应用市场跳转
• SSL证书信任（支持自签名证书）
• 错误提示Toast防抖

安装

将 uni_modules/rd-upgrade 目录复制到项目的 uni_modules 目录下。

API 文档

showUpgrade(options, onDownloadSuccess, onDownloadError)

显示升级弹窗

参数说明：

updateType 说明：

回调函数：

hideUpgrade()

隐藏升级弹窗

使用示例

基础用法 - APK下载

import { showUpgrade } from '@/uni_modules/rd-upgrade'

showUpgrade({
  title: "发现新版本",
  content: "1. 修复已知bug\n2. 优化用户体验\n3. 新增功能模块",
  downloadUrl: "https://example.com/app-v1.2.0.apk"
}, (filePath) => {
  console.log("下载成功:", filePath)
  // 安装APK
  plus.runtime.install(filePath, {}, () => {
    console.log("安装成功")
  })
}, (error) => {
  console.log("下载失败:", error)
})

WGT热更新

import { showUpgrade } from '@/uni_modules/rd-upgrade'

showUpgrade({
  title: "热更新提示",
  content: "发现新版本，是否立即更新？",
  downloadUrl: "https://example.com/app.wgt",
  updateType: 2  // WGT热更新
}, (filePath) => {
  console.log("下载成功:", filePath)
  // 安装热更新包
  plus.runtime.install(filePath)
})

强制更新

import { showUpgrade } from '@/uni_modules/rd-upgrade'

showUpgrade({
  title: "版本过低",
  content: "当前版本过低，请更新到最新版本",
  force: true,  // 强制更新，无法关闭
  upgradeText: "立即更新",
  downloadUrl: "https://example.com/app.apk"
})

跳转应用市场

Android：

import { showUpgrade } from '@/uni_modules/rd-upgrade'

showUpgrade({
  title: "去应用市场更新",
  content: "请前往应用市场下载最新版本",
  updateType: 3,
  marketUrl: "market://details?id=com.example.app"
})

iOS - 跳转App Store：

import { showUpgrade } from '@/uni_modules/rd-upgrade'

showUpgrade({
  title: "去App Store更新",
  content: "请前往App Store下载最新版本",
  updateType: 3,
  marketUrl: "itms-apps://itunes.apple.com/app/id123456789"
})

自定义头部图片

import { showUpgrade } from '@/uni_modules/rd-upgrade'

showUpgrade({
  title: "发现新版本",
  content: "1. 新功能上线\n2. 性能优化",
  headerImage: "https://example.com/header.png",  // 网络图片
  // headerImage: "/static/upgrade-header.png",   // 或本地图片
  downloadUrl: "https://example.com/app.apk"
})

HTML富文本内容（仅Android）

import { showUpgrade } from '@/uni_modules/rd-upgrade'

showUpgrade({
  title: "发现新版本 v2.0.0",
  content: "<b>更新内容：</b><br/>1. 全新UI设计<br/>2. 性能大幅提升<br/>3. 修复已知问题",
  downloadUrl: "https://example.com/app.apk"
})

完整示例

import { showUpgrade, hideUpgrade } from '@/uni_modules/rd-upgrade'

// 显示升级弹窗
showUpgrade({
  title: "发现新版本 v2.0.0",
  content: "1. 全新UI设计\n2. 性能优化\n3. Bug修复",
  force: false,
  upgradeText: "立即更新",
  headerImage: "https://example.com/header.png",
  downloadUrl: "https://example.com/app-v2.0.0.apk",
  updateType: 1
}, 
(filePath) => {
  console.log("下载完成:", filePath)
  plus.runtime.install(filePath, {}, () => {
    console.log("安装成功")
  }, (err) => {
    console.log("安装失败:", err)
  })
},
(error) => {
  console.log("下载失败:", error)
})

// 隐藏弹窗
hideUpgrade()

平台差异说明

注意事项

1. 强制更新模式下，弹窗无法关闭
2. iOS端建议使用 WGT 热更新或跳转 App Store
3. 建议在 App.vue 的 onLaunch 中检查更新
4. 插件支持自签名SSL证书的HTTPS下载

插件结构

uni_modules/rd-upgrade/
├── package.json
├── readme.md
├── changelog.md
└── utssdk/
    ├── app-ios/
    │   ├── index.uts
    │   └── RdUpgradeManager.swift
    └── app-android/
        ├── index.uts
        ├── config.json
        └── RdUpgradeManager.kt