小程序如何进行版本更新

小程序版本更新指南（以微信、支付宝为例）

小程序版本更新分为用户端更新（接收新版本并应用）和开发者端更新（发布新版本）两部分，以下是具体操作流程及注意事项：

一、用户端版本更新（普通用户视角）

用户端更新主要依赖平台自动推送，也可手动触发，具体方式如下：

1. 自动更新（默认方式）

微信/支付宝小程序会通过平台机制自动检测新版本：

• 静默更新：开发者发布新版本后，微信/支付宝客户端会在后续启动或使用过程中自动下载并更新小程序，用户下次打开时直接使用最新版；
• 启动时更新：小程序每次冷启动（首次打开）时，会检查是否有新版本，若有则异步下载，下次启动时应用新版本；
• 未启动时更新：微信6.6.3及以上版本会定时检查最近使用过的小程序，若有新版本，下次打开时同步更新。

2. 手动更新（用户主动触发）

若自动更新失败或用户想立即体验新版本，可通过以下路径手动更新：

• 微信小程序：
  ① 打开微信→「发现」→「小程序」；
  ② 找到目标小程序，点击进入；
  ③ 点击右上角「…」→「关于」→「版本更新」（若有可用更新，点击「立即更新」即可）。
• 支付宝小程序：
  ① 打开支付宝→「我的」→「我的小程序」；
  ② 找到目标小程序，长按进入详情页；
  ③ 点击「版本更新」（若有可用更新，直接下载并应用）。

3. 强制更新（开发者引导用户）

若新版本包含关键修复（如bug、安全漏洞），开发者可通过代码引导用户强制更新：
使用微信wx.getUpdateManagerAPI，监听更新状态：

const updateManager = wx.getUpdateManager();
updateManager.onCheckForUpdate((res) => {
  if (res.hasUpdate) { // 有新版本
    updateManager.onUpdateReady(() => {
      wx.showModal({
        title: '更新提示',
        content: '新版本已准备好，是否重启应用？',
        success: (res) => {
          if (res.confirm) updateManager.applyUpdate(); // 应用新版本
        }
      });
    });
    updateManager.onUpdateFailed(() => {
      wx.showToast({ title: '更新失败，请重试' }); // 更新失败处理
    });
  }
});

二、开发者端版本更新（开发者发布新版本）

开发者需通过开发工具上传代码，经审核后发布新版本，流程如下：

1. 准备工作

• 开发新功能或修复bug，完成本地测试；
• 确认版本号（遵循语义化规范，如1.0.0→1.0.1为修复bug，1.1.0为新增功能）；
• 编写更新日志（说明新版本变化，如“修复登录bug”“新增订单查询功能”）。

2. 上传与审核

• 微信小程序：
  ① 使用微信开发者工具打开项目，点击顶部「上传」，将代码上传至微信服务器；
  ② 登录微信公众平台→「版本管理」，找到刚上传的版本，点击「提交审核」；
  ③ 填写审核信息（如功能说明、测试账号），提交后等待微信团队审核（通常2-5小时）。
• 支付宝小程序：
  ① 使用支付宝开发者工具上传代码，填写版本信息（如版本号、更新日志）；
  ② 提交审核，等待支付宝审核通过（流程类似微信）。

3. 发布上线

审核通过后，开发者需在后台完成发布：

• 微信小程序：在「版本管理」中找到已审核版本，点击「提交发布」，选择发布模式（全量发布/灰度发布，灰度发布可先让部分用户试用）；
• 支付宝小程序：在「开发管理」中提交发布，确认后新版本将推送给用户。

三、版本回滚（应对发布问题）

若新版本出现严重问题（如功能异常、崩溃），需快速回滚到稳定版本：

• 微信小程序：登录微信公众平台→「版本管理」→ 选择历史稳定版本→ 点击「回滚」，系统将自动恢复该版本，用户下次打开时应用回滚版本；
• 支付宝小程序：类似微信，通过「开发管理」→「版本历史」选择稳定版本回滚。

注意事项

• 用户端：若无法自动更新，可尝试重启小程序、清除缓存（微信「我」→「设置」→「通用」→「存储空间」→ 清除小程序缓存；支付宝「我的」→「设置」→「通用」→「存储」→ 清除缓存）或卸载重装；
• 开发者端：发布前务必进行充分测试（尤其是核心功能），避免因bug影响用户体验；回滚版本需确保其稳定性，避免二次问题。