罗罗编程学习记录
本页内容 展开查看

07.2.4.6 发布链路、打包签名与 wgt 热更新

所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.2 跨平台移动开发 / 07.2.4 uni-app

本节要解决的问题

  • HBuilderX 云打包与导出原生工程离线打包,在适用场景、可控性与出包效率上有何本质差别?
  • Android 端 keystore、签名、渠道包、加固各自解决什么问题,哪些环节必须自己持有?
  • iOS 端证书、描述文件、Bundle ID、审核流程的最小闭环是什么?
  • 微信、支付宝、抖音、百度小程序在提审材料、审核红线与更新机制上有哪些差异?
  • H5 端部署在路由模式、静态资源缓存与 CDN 上要注意什么?
  • wgt 资源包热更新的机制、版本判定与平台合规边界在哪里?
  • uni 小程序 SDK 把已有 App 转为小程序能力时,能力与限制是什么?
  • 灰度与降级在多端发布链路中如何落地?

版本前提:本节以 HBuilderX 4.x、uni-app(Vue3)为基线描述打包链路;具体云打包选项、wgt 版本字段、各小程序平台审核规则与计费方式随平台更新,凡涉及平台支持矩阵、字段名、限额处均标「待确认」并给出验证点,以 DCloud 官方文档与各小程序开放平台最新规则为准。

覆盖范围

知识域 关键内容
App 打包形态 HBuilderX 云打包、导出原生工程离线打包、自定义基座、打渠道包
Android 签名与加固 keystore 生成、签名对齐、渠道包、第三方加固、应用市场合规
iOS 发布闭环 证书类型、描述文件、Bundle ID、TestFlight、审核要点
小程序多端发布 微信/支付宝/抖音/百度提审材料、审核差异、更新机制
H5 部署 hash/history 路由、静态资源缓存、CDN、Nginx 配置
wgt 热更新 资源包机制、版本号比对、生效时机、合规红线、uni 小程序 SDK
灰度与降级 按比例/按渠道/按版本灰度、强制更新与静默降级

题号索引

题号区间 主题
001-003 云打包与离线打包的差异、适用场景与选型
004-006 Android 签名、keystore、渠道包与加固
007-008 iOS 证书、描述文件与审核要点
009-010 小程序多端发布差异与 H5 部署
011-014 wgt 热更新机制、版本管理、合规边界与 uni 小程序 SDK
015-018 灰度降级、鸿蒙端现状、综合场景题

07.2.4.6-001 HBuilderX 云打包与离线打包的本质区别是什么?

一句话结论

云打包是 DCloud 云端用宿主工程 + 你的 wgt/资源 + 云端签名配置直接产出 apk/ipa,你不接触原生工程;离线打包是把 uni-app 导出为标准 Android Studio / Xcode 原生工程,由你在本地编译、签名、加固,完全可控但需要原生工具链。

概念解释

云打包的核心是 DCloud 维护一套标准 uni-app 宿主(含原生渲染引擎、推送、统计、分享等原生模块),你在 HBuilderX 里填包名、证书、SDK 参数,云端把你的前端资源打包进宿主并回传安装包。它的优点是无需配置 Android/iOS 原生环境、出包快、内置模块开箱即用;缺点是宿主版本由 DCloud 控制、自定义原生能力要走原生插件或离线打包、加固与市场对齐有时需要额外处理。

离线打包则是导出一个原生工程:Android 是含 uni-app 原生 SDK(aar)的 Android Studio 工程,iOS 是含 framework 的 Xcode 工程。你可以改 manifest、接自己的 SDK、做加固、配混淆、按渠道出包。代价是必须维护原生工程与 DCloud SDK 的版本同步,每次升级 uni-app 版本可能要重新对齐 SDK。

原理流程

云打包:HBuilderX 上传前端资源 + 证书配置 → DCloud 云端宿主 → 产出 apk/ipa
离线打包:HBuilderX 导出原生工程 → Android Studio/Xcode 打开 → 本地编译签名加固 → 产出包

代码或图示

维度 云打包 离线打包
原生工程 不接触,DCloud 维护 自己持有,可改原生代码
出包速度 快,无需本地工具链 慢,需编译环境
自定义能力 受宿主与原生插件限制 完全自由
加固/混淆 需出包后自行加固 可在工程内集成
版本升级 跟随 HBuilderX 需手动对齐 DCloud SDK

常见误区

  • 误区:云打包出的包不能加固;正解:云打包出包后可自行用第三方加固工具处理,但要注意重签名与渠道对齐。
  • 误区:离线打包就是"把 uni-app 当成 WebView 套壳";正解:离线打包工程仍使用 uni-app 原生渲染引擎(nvue/weex 或 App 端 webview 渲染),不是裸 WebView。

追问

  • 什么场景必须离线打包?答:需要深度定制原生启动、集成自研原生 SDK、加固/混淆要求高、或对宿主版本有合规要求时。
  • 云打包的证书安全吗?答:你上传 keystore/描述文件给 DCloud 云端签名,对安全性要求极高的项目应评估是否改用离线打包自签。

07.2.4.6-002 自定义基座与标准基座有何区别?为什么调试阶段要打自定义基座?

一句话结论

标准基座是 HBuilderX 内置的通用调试壳,内置了常用 SDK 但不包含你在 manifest 里配置的离线原生插件与自定义参数;自定义基座是把你项目里配置的原生插件、SDK 参数、签名打进一个专用调试包,真机运行时才能调用到这些原生能力。

概念解释

uni-app 在 App 端真机调试时,HBuilderX 会把前端代码热部署到一个"基座"App 里。标准基座是 DCloud 预置的通用版本,它的包名、签名、SDK 配置是固定的,如果你在 manifest 里配置了微信分享、高德定位、推送等需要包名与签名绑定的 SDK,用标准基座运行时这些能力会因为签名/包名不匹配而失效。

自定义基座则是针对你这个项目的 manifest 配置专门云打包或本地打包出来的调试壳,包名、签名、SDK 配置都和正式包一致。打自定义基座后,真机运行 = 把你的前端代码推到这个与正式包同配置的壳里,原生能力行为与正式包一致。

原理流程

开发期:HBuilderX 真机运行 → 选择基座
  ├─ 标准基座:通用壳,仅含公共 SDK,自定义插件不可用
  └─ 自定义基座:按本项目 manifest 打包,含本项目插件与签名
       → 安装到手机 → 热部署前端代码 → 调试

代码或图示

场景 用标准基座 用自定义基座
纯前端页面调试 可以 不必要
微信登录/分享(需签名包名绑定) 不行 必须
离线原生插件 不行 必须
推送、地图等 SDK 通常不行 必须

常见误区

  • 误区:标准基座能跑通就等于正式包能跑通;正解:涉及原生 SDK 绑定签名/包名的能力必须用自定义基座验证。
  • 误区:改了 manifest 的 SDK 配置后不用重打基座;正解:原生配置变更必须重新打自定义基座。

追问

  • 自定义基座要频繁重打吗?答:manifest 里原生插件、SDK 参数、包名、签名变更时才需要重打,纯前端改动不需要。
  • 自定义基座能上架应用市场吗?答:不能,它是调试包,正式发布要用正式打包流程出 release 包。

07.2.4.6-003 什么时候应该从云打包切到离线打包?判断树是什么?

一句话结论

当云打包宿主无法满足你的原生定制需求、加固/混淆要求、或对包体与启动有极致要求时,切到离线打包;判断标准是"是否需要修改原生工程、是否需要替换宿主模块、是否需要深度加固"。

概念解释

这是一个渐进式迁移决策,不是非黑即白。云打包能覆盖大多数商业 App 的需求:登录、分享、支付、推送、地图、统计都有原生插件市场。但当出现以下情况时云打包会遇到边界:一是需要修改启动屏、启动流程、添加自研 APM/安全 SDK;二是需要按渠道深度定制(不同渠道包接入不同 SDK、不同品牌);三是加固要求极高,需要在打包阶段集成加固 SDK 与混淆规则;四是宿主版本与你依赖的某原生库版本冲突,无法等 DCloud 升级。

离线打包的成本是持续维护:DCloud 发布新 SDK 版本时,你要把新的 aar/framework 替换进工程,处理版本对齐。所以只有当云打包的"天花板"确实挡住了关键需求时才值得付这个维护成本。

原理流程

需求出现
  ├─ 标准 API/插件市场能解决 → 继续云打包
  ├─ 需要原生插件但不改宿主 → 云打包 + 原生插件
  ├─ 需要改原生代码/启动/加固/多渠道 → 离线打包
  └─ 不确定 → 先用云打包验证主链路,再评估离线投入

代码或图示

判定树:
需要改宿主代码? ── 是 → 离线打包
需要深度加固/混淆? ── 是 → 离线打包
需要多渠道差异化原生配置? ── 是 → 离线打包
以上都否 → 云打包(+必要原生插件)

常见误区

  • 误区:云打包永远比离线打包差;正解:云打包出的包在多数场景性能与稳定性足够,离线是为定制而不是为性能。
  • 误区:切离线打包后就可以不管 DCloud 版本了;正解:必须持续对齐 DCloud SDK,否则会遇到新 API 不支持。

追问

  • 离线打包后还能热更新 wgt 吗?答:可以,离线打包工程同样支持 wgt 资源热更新,机制与云打包一致。
  • 切离线打包的主要工作量在哪?答:原生工程初始化、SDK 版本对齐、签名与渠道脚本、加固集成,以及后续每次升级的回归。

07.2.4.6-004 Android 端 keystore 的作用是什么,为什么必须自己持有?

一句话结论

keystore 是 Android 应用的数字签名私钥库,应用市场、系统升级覆盖、微信/支付宝 SDK 校验都以它为身份依据;一旦丢失或泄露,App 将无法发布更新(应用市场不认新签名)或被冒充,所以 keystore 与密码必须由开发者自己妥善保管,不能依赖 DCloud 云端或他人。

概念解释

Android 要求所有 apk 必须签名才能安装。签名有两个作用:一是身份认证,后续升级包必须用同一 keystore 签名才能覆盖安装;二是 SDK 校验,微信开放平台、高德、分享等 SDK 在后台登记的是"包名 + 签名指纹",App 运行时 SDK 会校验当前安装包的签名指纹是否与登记一致,不一致就无法登录或分享。

keystore 一旦丢失,你无法在应用市场发布更新(市场要求签名一致),只能以新包名重新上架,等于换了一个 App;keystore 一旦泄露,别人可以伪造你的 App 签名。所以 keystore 必须离线备份、密码分级管理、禁止上传到公开仓库。

原理流程

生成 keystore(keytool)→ 在各 SDK 后台登记 SHA1 指纹 → 打包时用它签名
  → 用户安装 → 后续升级必须同 keystore 签名 → 否则市场拒签/覆盖安装失败

代码或图示

# 示意:生成 keystore(具体参数以官方文档为准)
# keytool -genkey -alias myalias -keyalg RSA -keysize 2048 -validity 36500 -keystore my-release.keystore

常见误区

  • 误区:debug keystore 可以用于正式包;正解:正式包必须用独立发布 keystore,debug 证书有有效期且不安全。
  • 误区:keystore 丢了可以找应用市场重置;正解:绝大多数市场不接受签名重置,只能换包名重新上架。

追问

  • 云打包时 keystore 怎么管理?答:上传到 DCloud 云打包用于签名,但本地必须保留副本;对安全敏感项目建议离线打包自签。
  • 微信登录提示"签名不匹配"怎么排查?答:用 keytool 打出当前包的签名 MD5/SHA1,与微信开放平台后台登记的指纹逐字符核对。

07.2.4.6-005 Android 渠道包是怎么打的,为什么需要渠道包?

一句话结论

渠道包是同一代码按不同分发渠道(应用市场、运营商、预装)打出的差异化安装包,通过在 apk 中写入渠道标识来统计来源、配置差异化 SDK;uni-app 云打包支持按渠道矩阵批量出包,离线打包则通过 ManifestPlaceholders 或 Walle/美团渠道方案实现。

概念解释

渠道包的核心需求是归因:你在 360、应用宝、华为、小米、OPPO、vivo 等多个市场上架,需要知道每个渠道的下载量、激活量、留存率,从而分配推广预算。技术上有两种思路:一是"整包重打",每个渠道一个独立 apk,体积大但简单;二是"渠道注入",打出一个基础包后,通过修改 apk 的 ZIP 注释或 Manifest 占位符写入渠道值,不重新编译。

uni-app 云打包支持在打包界面配置渠道列表,云端批量产出渠道包;离线打包则可以在 AndroidManifest 的 meta-data 里用占位符,或使用 Walle 之类的"多渠道轻量打包"工具,避免整包重打。

原理流程

代码与资源一致
  ├─ 方案A:每个渠道重打一次 apk(修改 manifest 渠道值)
  └─ 方案B:打一个基础包 → 工具注入渠道标识到 apk → 产出多渠道包
        → 用户安装 → SDK 读取渠道值 → 上报统计平台

代码或图示

方案 出包速度 包体一致性 适用
整包重打 慢(每渠道一次编译) 完全一致 渠道少、需差异化配置
渠道注入 快(一次编译多次注入) 基础包一致 渠道多、仅统计差异

常见误区

  • 误区:渠道包就是改个图标名字;正解:渠道包主要差异在统计标识与可能的 SDK 配置,功能一致。
  • 误区:渠道包越多越好;正解:每个渠道都要维护上架、审核与崩溃分析,渠道数量要有 ROI。

追问

  • 渠道值怎么在 App 内读取?答:通过原生 SDK(如 uni 统计、第三方 SDK)读取 manifest 里的渠道 meta-data,前端通过 uni.getSystemInfo 或原生插件获取。
  • 云打包渠道包支持加固吗?答:云打包出包后需自行加固,加固会重签名,要注意渠道标识与签名的对应关系。

07.2.4.6-006 Android 加固是什么,为什么应用市场要求加固?

一句话结论

加固是对 apk 加壳保护,防止反编译、二次打包、动态调试与代码注入;金融、政企、支付类应用在主流市场上架时常常被要求加固或提供加固证明,uni-app 云打包出的原始 apk 可通过第三方加固服务处理后再上架。

概念解释

未加固的 apk 用 apktool 等工具很容易反编译出 Java 代码、资源与 manifest,攻击者可以注入广告、篡改支付、窃取数据。加固的原理是:把原始 dex 加密,外层套一个壳 dex(native 层),运行时壳在内存中解密加载真实 dex。常见加固服务包括腾讯乐固、360 加固、爱加密、梆梆安全等。

加固对 uni-app 项目的特殊意义在于:前端 JS 资源虽然在 apk 里是加密/打包的,但原生层与 JS 逻辑都可能被逆向。需要注意的是,加固可能与 wgt 热更新、某些原生插件、崩溃捕获 SDK 冲突,加固后必须全链路回归。

原理流程

原始 apk(含 dex、资源、wgt)
  → 上传加固服务 → 加密 dex + 套壳
  → 产出加固 apk → 用发布 keystore 重签名(加固后通常要重签)
  → 上架市场 → 运行时壳在内存解密加载

代码或图示

加固类型 保护强度 性能影响 适用
不加固 无 无 内部工具、非敏感应用
基础加固(加壳) 中 小 一般商业 App
深度加固(ollvm/反调试) 高 中 金融、政企、支付

常见误区

  • 误区:加固后就不用混淆了;正解:加固与混淆是两层,ProGuard/R8 混淆仍应开启。
  • 误区:加固后 wgt 热更新照常工作;正解:部分加固方案会影响动态加载,必须实测 wgt 升级流程。

追问

  • 加固后崩溃日志怎么收?答:加固壳会影响原始堆栈,崩溃捕获 SDK 需集成加固服务的"反混淆/堆栈还原"方案,或使用加固服务自带的崩溃分析。
  • 加固会导致包体变大吗?答:会,壳本身增加体积,通常增加数 MB,需在市场 100MB 限制内评估。

07.2.4.6-007 iOS 发布闭环的最小步骤是什么?证书与描述文件如何对应?

一句话结论

iOS 发布闭环是:注册 Apple Developer 账号 → 创建 App ID(Bundle ID)→ 创建证书(开发/发布)→ 创建描述文件(Provisioning Profile)绑定证书与 App ID → Xcode/HBuilderX 签名打包 → App Store Connect 上传 → TestFlight 测试 → 提交审核 → 上架。

概念解释

iOS 签名体系有三个核心对象:Certificate(证书,含公钥/私钥对,证明你是合法开发者)、App ID(Bundle ID,唯一标识一个 App)、Provisioning Profile(描述文件,把证书、App ID、设备 UDID 或分发范围打包在一起,允许某证书在某 App 上签名)。

开发证书用于真机调试,描述文件需绑定设备 UDID;发布证书(Distribution)用于上架,描述文件是 App Store 类型,不绑定具体设备。HBuilderX 云打包 iOS 时需要上传发布证书(.p12)与描述文件(.mobileprovision),云端用它们签名。

原理流程

Apple Developer 后台
  → Certificates:创建 Distribution 证书(导出 .p12)
  → Identifiers:注册 App ID(com.example.app)
  → Profiles:创建 App Store 描述文件(绑定证书 + App ID)
  → HBuilderX 上传 .p12 + .mobileprovision + 前端资源
  → 云打包产出 ipa → Transporter/Xcode 上传 App Store Connect
  → TestFlight 验证 → 提交审核 → 上架

代码或图示

对象 作用 开发 vs 发布
Certificate 身份私钥 Development / Distribution
App ID Bundle ID 同一 App ID 贯穿开发与发布
Provisioning Profile 签名授权范围 Development 绑设备,App Store 不绑设备
描述文件有效期 90 天到 1 年 过期后需重新生成,待确认

常见误区

  • 误区:同一个描述文件可以给不同 Bundle ID 用;正解:描述文件绑定具体 App ID,换包名必须重建。
  • 误区:p12 密码可以随便设;正解:p12 含私钥,泄露等于开发者账号身份泄露,需严格保管。

追问

  • TestFlight 的作用?答:上架前给内部/外部测试人员安装,收集崩溃与反馈,不经过 App Store 审核即可分发(外部测试仍需审核,待确认)。
  • iOS 审核被拒常见原因?答:权限说明不充分、付费引导问题、虚拟支付、元数据不符、Bug,具体以 Apple 审核指南为准。

07.2.4.6-008 iOS 审核对 uni-app 项目有哪些特殊红线?

一句话结论

uni-app 项目在 iOS 上最常踩的红线是:虚拟支付(App 内购买必须走 IAP)、热更新(JS 热更新需遵守 Apple 对动态代码的条款)、权限用途说明、以及"类 React Native/WebView 应用"的质量审核;wgt 热更新与 Apple 条款的边界必须谨慎评估。

概念解释

Apple 对"动态下发代码"有严格要求:iOS App 不能下载可执行代码运行(JSPatch、动态库等),但 Apple 对基于 JS 解释器的框架(如 React Native、uni-app、wxapp 类)有一定容忍空间,前提是不改变 App 的核心功能与元数据、不引入新的二进制代码。wgt 资源包本质是更新 JS/Vue 资源,通常被视为资源更新而非可执行代码,但仍需遵守:不能绕过 IAP、不能在审核后突然出现审核时没有的功能、不能用于加载第三方插件市场。

另一个高频红线是虚拟支付:如果 App 内有"解锁内容/数字商品",必须走 Apple 的 IAP,不能用微信/支付宝/H5 支付绕过;但实体商品、服务费、阅读类 App 的"Reader"分类有例外,具体以 Apple 审核指南最新条款为准(待确认)。

原理流程

提交审核
  → Apple 审核:元数据、权限说明、功能完整性、支付方式、动态代码
  ├─ 合规 → 上架
  └─ 被拒 → 按拒绝条款修改 → 重新提交
       → 上架后 wgt 热更新不能引入审核时不存在的新二进制能力

代码或图示

风险点 Apple 要求 应对
虚拟商品支付 必须 IAP 数字商品走 IAP,实体走三方支付
wgt 热更新 不能下发可执行二进制 仅更新 JS/资源,不改原生核心
权限说明 每次使用都要说明用途 Info.plist 文案清晰
审核后功能变更 不能大变 热更新仅限 bug 修复与资源调整

常见误区

  • 误区:uni-app 的 wgt 热更新完全不受 Apple 限制;正解:边界是"不引入新的可执行代码与核心功能变更",过度使用有被拒风险。
  • 误区:iOS 内所有支付都必须 IAP;正解:实体商品、服务、Reader 类应用有例外,需按分类判断。

追问

  • wgt 热更新在 iOS 上是否需要关闭?答:官方建议是仅用于 bug 修复,不要用于大版本功能更新;具体策略以 Apple 审核指南与 DCloud 建议为准(待确认)。
  • 如何降低审核被拒概率?答:准备阶段对照 Apple Review Guidelines 逐条自查,权限文案、支付方式、元数据提前梳理。

07.2.4.6-009 微信、支付宝、抖音、百度小程序在发布与审核上有哪些差异?

一句话结论

四者都遵循"上传代码 → 平台审核 → 发布"流程,但在包体限制、类目资质、审核时长、更新机制、虚拟支付要求上差异明显;微信最严且生态最成熟,支付宝偏服务场景,抖音偏内容电商,百度偏搜索与智能小程序。

概念解释

微信小程序:主包 + 分包有体积上限(具体限额以微信最新文档为准,待确认),类目需要资质(如医疗、金融、教育),审核通常 1-7 天,虚拟支付在 iOS 端受 Apple 与微信双重约束,支持灰度发布与版本回退。支付宝小程序:偏 B 端服务与生活场景,审核要求与微信类似但类目体系不同,支持企业级能力。抖音小程序:偏内容种草与电商闭环,与抖音流量、直播间、短视频挂载强绑定,审核对营销内容与诱导分享敏感。百度小程序:偏搜索分发与智能小程序,在百度系流量(搜索、信息流)有入口,审核规则随百度业务调整。

uni-app 编译到各端时,通过 manifest 配置各端的 AppID、名称、图标、隐私协议;各端的开发者后台是独立的,需要分别注册与提交。

原理流程

uni-app 源码
  → 编译为各端小程序产物
  → 在各端开发者工具上传代码
  → 各端后台填写类目、资质、隐私协议
  → 各端审核(时长与标准不同)
  → 发布(支持灰度/分阶段)

代码或图示

维度 微信 支付宝 抖音 百度
分发主入口 社交/扫码 生活服务 内容/电商 搜索/信息流
审核严格度 高 中高 中高(营销敏感) 中
虚拟支付 iOS 受 IAP 约束 类似 类似 类似
灰度发布 支持 待确认 待确认 待确认

常见误区

  • 误区:一个小程序审核通过后其他端自动通过;正解:各端独立审核,类目与资质要分别准备。
  • 误区:uni-app 编译产物可以直接上传不需要各端开发者工具;正解:仍需用各端开发者工具上传与预览。

追问

  • 小程序审核被拒常见原因?答:类目与功能不符、权限用途不清、诱导分享、虚拟支付绕过、功能不完整。
  • 多端小程序如何统一版本管理?答:在 manifest 统一版本号,但各端后台版本需分别提交与记录。

07.2.4.6-010 H5 端部署在路由模式、静态资源缓存与 CDN 上要注意什么?

一句话结论

uni-app 编译到 H5 时要选择 hash 或 history 路由模式;静态资源需配合长缓存 + 内容哈希文件名实现增量更新,CDN 回源与 Nginx history 配置要到位,否则刷新 404 或缓存不更新。

概念解释

hash 路由(默认)URL 带 #,兼容性好,服务端不需要配置,刷新不会 404,但 URL 不美观且对 SEO 不友好。history 路由基于 HTML5 History API,URL 干净,但服务器必须把所有路径都回退到 index.html,否则用户刷新任意子路径都会 404;Nginx 配置 try_files $uri $uri/ /index.html 即可。

静态资源缓存策略:uni-app 构建产物里 JS/CSS 文件名带内容哈希,适合设置 Cache-Control: max-age=31536000, immutable 长缓存;index.html 必须设置 no-cache,否则用户拿到旧入口就永远进不了新版本。CDN 回源时要注意 index.html 不缓存,资源文件走长缓存。

原理流程

构建产物
  ├─ index.html:no-cache(每次回源拿最新)
  ├─ static/js/*.[hash].js:长缓存 immutable
  └─ static/css/*.[hash].css:长缓存 immutable
  → Nginx:history 模式 try_files 回退 index.html
  → CDN:资源缓存,index.html 不缓存

代码或图示

# 示意:H5 部署 history 路由的 Nginx 配置
server {
  root /var/www/h5;
  index index.html;
  location / {
    try_files $uri $uri/ /index.html;
  }
  location ~* \.(js|css|png|jpg|woff2)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
  }
  location = /index.html {
    add_header Cache-Control "no-cache";
  }
}

常见误区

  • 误区:history 模式部署后忘记配 Nginx 回退;正解:所有子路径都要回退到 index.html,否则刷新 404。
  • 误区:index.html 也设长缓存;正解:index.html 是入口,必须 no-cache,否则用户拿不到新版本。

追问

  • H5 端怎么做强制更新?答:index.html 里嵌版本号,启动时轮询后端版本,发现新版本提示刷新或静默重载。
  • H5 在微信/支付宝内打开有什么差异?答:受 WebView 内核与 JSSDK 限制,支付、分享、定位需用对应 JSSDK 而非原生 API。

07.2.4.6-011 wgt 资源包热更新的机制是什么?

一句话结论

wgt 是 DCloud 打包的前端资源更新包(本质是 zip),uni-app App 端启动时检查本地 wgt 版本与服务器最新版本,发现更新就下载 wgt、校验、解压覆盖到应用沙盒资源目录,下次启动生效;它只更新前端 JS/Vue/资源,不更新原生二进制。

概念解释

uni-app App 端的结构是:原生壳(apk/ipa 里的原生代码 + 首次内置的 wgt)+ 可更新的 wgt 资源包。首次安装时 wgt 内置在包内;后续通过 plus.runtime.getProperty 获取当前版本,通过 uni 统计或自己的接口检查服务器最新 wgt 版本,下载后用 plus.runtime.install 安装。

wgt 更新的关键边界:它不能更新原生代码(不能换 apk/ipa 里的 dex/Framework),不能改变 App 的原生能力,不能引入新的原生二进制。这与 Apple 对动态代码的要求对齐(见 07.2.4.6-008)。

原理流程

App 启动
  → plus.runtime.getProperty 取当前 wgt 版本
  → 请求后端/uni 云托管最新版本号
  → 有更新:下载 wgt(zip)→ 校验(版本号、可选签名)
  → plus.runtime.install(wgtPath) → 解压覆盖资源目录
  → 重启应用 → 加载新 wgt

代码或图示

// 示意:检查并安装 wgt 更新(API 以版本为准)
plus.runtime.getProperty(plus.runtime.appid, (info) => {
  // info.version 为应用版本,info.versionCode 为 wgt 版本
  uni.request({
    url: 'https://example.com/check-update',
    data: { version: info.version },
    success: (res) => {
      if (res.data.wgtUrl) {
        uni.downloadFile({
          url: res.data.wgtUrl,
          success: (dl) => {
            plus.runtime.install(dl.tempFilePath, { force: false }, () => {
              plus.runtime.restart();
            }, (e) => console.error('install fail', e));
          }
        });
      }
    }
  });
});

常见误区

  • 误区:wgt 可以频繁更新大版本功能;正解:wgt 只应做 bug 修复与小调整,大版本功能应发应用市场更新。
  • 误区:wgt 安装后立即生效;正解:通常需要重启应用才生效(部分场景支持静默安装下次启动生效)。

追问

  • wgt 更新失败怎么办?答:必须有失败兜底:保留旧版本 wgt,下载/安装失败不影响启动,下次启动重试。
  • wgt 是否需要签名?答:DCloud 提供 wgt 签名机制(具体配置方式以官方文档为准,待确认),防止 wgt 被篡改。

07.2.4.6-012 wgt 版本管理与生效条件是什么?

一句话结论

wgt 版本与应用版本是两个维度:应用版本(versionName/versionCode)随 apk/ipa 走应用市场,wgt 版本(盒子版本)随资源更新走;wgt 只能在"当前应用版本支持的功能范围内"更新,若原生层 API 升级,wgt 无法调用新能力。

概念解释

uni-app 里有三层版本号:versionName(给用户看的版本名,如 1.2.0)、versionCode(应用市场版本号,整数递增)、以及 wgt 资源版本(manifest 里的 version,由 DCloud 管理)。wgt 热更新时,版本比对的核心是"wgt 版本是否高于当前运行版本",而不是应用 versionCode。

关键约束:wgt 是跑在"当前安装的原生壳"里的。如果新版 wgt 用了只有更新版原生壳才支持的 API,而用户还没升级原生壳,那部分功能会失败。所以 wgt 发布时要评估"最低支持的原生壳版本",对低于该版本的用户提示升级 App,而不是下发 wgt。

原理流程

服务器记录:{ appVersion, wgtVersion, minAppVersion }
App 启动
  → 拿到当前 appVersion 与 wgtVersion
  → 对比服务器
  → 若 wgt 有更新且当前 appVersion >= minAppVersion → 下发 wgt
  → 若当前 appVersion < minAppVersion → 引导应用市场升级

代码或图示

版本维度 载体 更新渠道 约束
versionName/versionCode apk/ipa 应用市场 走商店审核
wgt 资源版本 wgt 包 应用内下载 不能更新原生能力
minAppVersion 服务器配置 后端下发 低版本壳提示升级

常见误区

  • 误区:wgt 版本可以无限高于应用版本;正解:wgt 调用的 API 必须在当前原生壳版本支持范围内。
  • 误区:所有用户都能收到同一份 wgt;正解:需要按当前 appVersion 分桶下发,旧壳用户应引导升级原生。

追问

  • wgt 回滚怎么做?答:服务器保留历史 wgt 版本,若新版 wgt 出问题,可把最新版本号指回旧 wgt,让用户下次启动重新下载旧版 wgt。
  • 强制更新与 wgt 更新的区别?答:强制更新是原生壳版本太低,必须走应用市场;wgt 更新是资源层修复,不需要商店审核。

07.2.4.6-013 wgt 热更新与平台合规的红线边界在哪里?

一句话结论

wgt 热更新的合规边界是"只更新资源与 bug 修复,不改变 App 审核时的核心功能、不绕过 IAP、不下发可执行二进制";越界会导致应用市场拒审、下架或 Apple 警告,Android 端相对宽松但仍需遵守各市场规则。

概念解释

Apple 对热更新的态度是:基于 JS 解释器的资源更新允许,但不能下载新的可执行代码(dylib、framework)、不能改变审核时声明的功能与元数据、不能绕过 IAP。Android 端各市场(华为、小米、OPPO、vivo)对热更新相对宽松,但也有反作弊/安全要求,若热更新被用于分发恶意代码或诱导更新,会被下架。

实践中的安全做法:一是 wgt 仅用于 bug 修复与文案/资源调整;二是大版本功能必须发应用市场;三是 wgt 服务端要有灰度与回滚;四是不要在 wgt 里动态加载第三方未审核的插件市场;五是 iOS 上更保守,重大更新走 TestFlight。

原理流程

wgt 更新内容分类
  ├─ bug 修复、文案、图片、页面调整 → 合规,可热更新
  ├─ 新业务模块、新原生能力、绕过 IAP 的支付 → 不合规,必须发市场
  └─ 第三方动态插件市场 → 高风险,避免

代码或图示

更新类型 iOS 合规性 Android 合规性
JS/Vue/资源 bug 修复 通常允许 允许
新页面/新业务模块 灰色,需谨慎 相对允许
新原生二进制/插件 禁止 通常允许但需安全合规
绕过 IAP 的支付 禁止 各市场规则不同

常见误区

  • 误区:Android 上 wgt 想更就更;正解:国内市场对热更新有安全审核要求,过度使用会被巡检下架。
  • 误区:wgt 可以绕过 App Store 审核上支付功能;正解:这是 Apple 明确禁止的,会被拒或下架。

追问

  • 如何做合规自检?答:每次 wgt 更新前过一遍清单:是否新增原生能力、是否新增支付路径、是否改变核心功能,任何一项命中就走应用市场。
  • uni 官方对 wgt 的建议是什么?答:以 DCloud 官方"wgt 热更新最佳实践"文档为准(待确认),通常建议 wgt 仅用于 bug 修复与小调整。

07.2.4.6-014 uni 小程序 SDK 是什么,能把已有 App 转为小程序能力吗?

一句话结论

uni 小程序 SDK(也称 uniMPSDK/小程序支持 SDK)是 DCloud 提供的原生 SDK,让已有的原生 App 可以内嵌运行 uni-app 编译出的小程序/uni 小程序页面,从而在 App 内打开 H5/小程序形态的业务模块;它不是把你的 App 变成微信小程序,而是在 App 内集成一个"小程序运行时"。

概念解释

这个能力的典型场景是:你有一个原生 App(或 uni-app 打的 App),需要在 App 内嵌入大量"小程序化"的业务页面(如商家入驻、活动页、第三方服务商提供的页面),这些页面可以独立发版、热更新,而不影响 App 主包。uni 小程序 SDK 提供了类似微信小程序的运行时:在原生 App 里加载 uni-app 编译的小程序包,支持路由、组件、API、JSSDK 能力。

它的限制是:SDK 要集成到原生工程(Android/iOS),有包体成本;小程序页面的能力受 SDK 暴露的 JSSDK 范围限制;与微信小程序的生态不互通,不能直接跑微信小程序代码。

原理流程

已有原生 App
  → 集成 uni 小程序 SDK(aar/framework)
  → App 内通过 API 打开一个 uni 小程序包
  → SDK 加载小程序包 → 渲染页面 → 业务运行
  → 小程序包可独立热更新,不影响主 App

代码或图示

维度 uni 小程序 SDK 微信小程序
运行宿主 你的 App 微信客户端
代码来源 uni-app 编译产物 微信小程序工程
生态互通 不与微信互通 微信生态
更新方式 App 内包更新 微信后台发布

常见误区

  • 误区:uni 小程序 SDK 能把我的 App 变成微信小程序;正解:它是在 App 里内嵌小程序运行时,不是发布到微信。
  • 误区:集成后就能跑所有微信小程序代码;正解:uni-app 编译的小程序包与微信小程序代码不互通。

追问

  • 这个 SDK 解决什么痛点?答:大型 App 内业务模块需要独立发版、热更新、插件化时,避免主 App 频繁发版。
  • 包体成本多大?答:SDK 会增加原生包体积,具体以 DCloud 官方说明为准(待确认)。

07.2.4.6-015 多端发布时如何做灰度与降级?

一句话结论

灰度按"用户比例/渠道/版本/地域"分桶下发,降级通过开关(远程配置)关闭高风险功能或切回旧链路;App 端灰度靠 wgt + 服务器分桶,小程序端靠平台灰度发布,H5 端靠 CDN/路由或 A/B 平台。

概念解释

灰度的核心是"先小流量验证,再全量"。App 端:wgt 更新时按用户 ID 哈希分桶,先 1%、10%、50%、100%;同时服务器配置开关,发现新版本 wgt 崩溃率高就停止下发或回滚。小程序端:微信等平台提供"灰度发布"能力,按百分比放量,可随时回退到上一版本。H5 端:通过 CDN 灰度或 A/B 平台把流量切到新版本,或直接保留旧版本目录。

降级是另一套机制:远程配置开关控制某个功能是否开启(如支付、推荐、AI 能力),发现故障时一键关闭;或者把某接口流量切到备用通道。uni-app 项目通常封装一个远程配置服务,App 启动时拉取开关,运行时动态判断。

原理流程

新版本发布
  → 灰度桶(1% → 10% → 50% → 100%)
  → 监控崩溃率、接口成功率、关键行为漏斗
  ├─ 指标正常 → 继续放量
  └─ 指标异常 → 停止下发 / 回滚 wgt / 切降级开关

代码或图示

端 灰度手段 降级手段
App wgt 分桶、按渠道/版本 远程开关、wgt 回滚、强制更新
小程序 平台灰度发布 远程开关、版本回退
H5 CDN/A/B 切流 切回旧目录、关闭功能

常见误区

  • 误区:灰度就是"先发给测试用户";正解:灰度是按真实用户比例放量,需要监控数据支撑决策。
  • 误区:降级只在故障时才需要;正解:降级开关必须在发布前就准备好,故障时再做就来不及。

追问

  • wgt 灰度怎么分桶?答:用用户 ID/设备 ID 哈希取模,命中桶内才下载新 wgt,桶外继续用旧 wgt。
  • 小程序灰度如何回退?答:各平台后台支持"暂停灰度"或"回退到上一版本",具体操作以平台为准。

07.2.4.6-016 鸿蒙端 uni-app 打包现状如何?

一句话结论

uni-app 对鸿蒙(HarmonyOS NEXT / 纯血鸿蒙)的支持在快速演进中,uni-app x 已支持编译到 HarmonyOS,传统 uni-app(Vue)对鸿蒙的支持路径与版本边界需以 DCloud 官方最新文档为准,本节相关能力均标「待确认」。

概念解释

鸿蒙生态从 2024 年起快速崛起,DCloud 也在跟进 uni-app 到鸿蒙的编译能力。已知方向是通过 uni-app x(UTS + uvue)编译到 HarmonyOS,因为 UTS 可以编译到 Kotlin/Swift 类原生语言,映射到鸿蒙 ArkTS 更顺;传统 Vue 版 uni-app 走 webview 渲染的路径在鸿蒙上受限(鸿蒙没有 WebView 兼容层的完整支持)。

但具体支持哪些组件、哪些 API、是否支持云打包、是否需要 DevEco Studio 离线工程、发布到华为应用市场的流程,都随 DCloud 版本快速变化,不能凭记忆断言。

原理流程

uni-app x 工程
  → DCloud 工具链编译到 HarmonyOS(ArkTS 工程)
  → DevEco Studio 打开 → 签名 → 华为应用市场发布
  (具体组件/API 支持矩阵待确认)

代码或图示

项 状态 验证点
uni-app x 编译到 HarmonyOS 演进中 查 DCloud 官方"uni-app x 鸿蒙"文档最新支持列表
传统 uni-app(Vue)到鸿蒙 受限 查是否支持 webview 渲染到鸿蒙
云打包鸿蒙包 待确认 查 HBuilderX 最新版本是否提供鸿蒙云打包
鸿蒙市场发布流程 独立 华为开发者联盟后台,按鸿蒙应用规范

常见误区

  • 误区:uni-app 已经完全支持鸿蒙;正解:鸿蒙支持是快速演进中的能力,具体组件与 API 覆盖必须查官方文档。
  • 误区:鸿蒙包可以直接复用 Android 包;正解:鸿蒙 NEXT 不兼容 Android apk,需要独立编译。

追问

  • 新项目要不要优先考虑 uni-app x 而不是传统 uni-app?答:如果目标包含鸿蒙,uni-app x 是更顺的路线;如果只做小程序与 H5,传统 uni-app 生态更成熟。
  • 鸿蒙端调试用什么工具?答:DevEco Studio 与鸿蒙模拟器/真机,具体流程以 DCloud 与华为文档为准。

07.2.4.6-017 综合题:一个 uni-app 项目要同时发微信小程序、Android、iOS、H5,发布链路怎么组织?

一句话结论

以 manifest 为单一配置源,按"端"组织构建脚本与发版清单:小程序走各端开发者工具上传审核,Android/iOS 走 HBuilderX 云打包 + 签名/加固/渠道,H5 走 CDN 部署;版本号统一管理,wgt 热更新只在 App 端做,灰度与回滚各端独立。

概念解释

多端发布最大的坑是"配置分散、版本错位"。组织方式应该是:manifest.json 里集中配置各端 AppID、名称、图标、版本号;CI/构建脚本按端分别出包;发版清单明确每个端的版本、审核状态、回滚方案。

具体节奏:先在 H5 与微信小程序灰度(成本最低、回滚最快),再 Android 云打包 + 加固 + 渠道,再 iOS TestFlight + 审核,最后 App 端 wgt 热更新修复小问题。版本号统一在 manifest 维护,各端后台版本号要人工或脚本对齐记录。

原理流程

manifest 统一配置(版本号、AppID、图标、SDK)
  → H5:构建 → CDN 部署(先灰度)
  → 微信小程序:微信开发者工具上传 → 灰度发布
  → Android:云打包 → 加固 → 多渠道 → 各市场上架
  → iOS:云打包 → Transporter → TestFlight → 审核上架
  → 上线后:App 端 wgt 热更新(仅 bug 修复)+ 远程开关降级

代码或图示

端 发布动作 回滚手段 周期
H5 构建 → CDN 切回旧目录 分钟级
微信小程序 上传 → 灰度 后台回退版本 小时级
Android 云打包 → 加固 → 渠道 下架渠道 + wgt 回滚 天级
iOS TestFlight → 审核 拒绝新二进制,wgt 受限 天级

常见误区

  • 误区:四端同时发版最省事;正解:应该先 H5/小程序灰度,再 App 端,问题在低成本端先暴露。
  • 误区:版本号各端独立随意;正解:manifest 统一版本号,否则后端兼容逻辑与崩溃分析无法对齐。

追问

  • 如何做发布 checklist?答:每个端列:包名/Bundle ID、签名、隐私权限文案、类目资质、隐私协议、测试账号、审核要点、回滚方案。
  • 后端接口如何配合多端发布?答:接口版本号兼容,新接口对旧 App 端保留降级路径,不要让旧版本 App 因新接口而崩。

07.2.4.6-018 综合题:用户反馈"App 更新后白屏/部分功能失效",你怎么排查?

一句话结论

先分层定位:是原生壳启动失败、还是 wgt 资源加载失败、还是 JS 运行时报错、还是远程配置/灰度桶问题;用 APM/日志区分"原生崩溃"与"前端白屏",再按 wgt 回滚、远程开关降级、强制升级三步兜底。

概念解释

这类问题的排查顺序是:第一步确认影响范围(全量还是某灰度桶、某版本、某机型);第二步区分原生崩溃(apk 闪退)还是前端白屏(壳在但页面空白);第三步如果是 wgt 问题,立即把服务器 wgt 版本指回上一版,让用户下次启动重新下载旧 wgt;第四步如果是 JS 报错,通过远程开关关闭相关功能模块;第五步如果是原生壳 bug,只能走应用市场热更或强制升级。

关键预防是:wgt 发布前必须有灰度桶与监控(崩溃率、JS 错误率、关键页面打开率),发现异常立即回滚。

原理流程

白屏/失效反馈
  → 影响范围:全量?灰度桶?某版本?某机型?
  → 分层:
      ├─ 原生闪退 → 崩溃日志 → 应用市场热更/强制升级
      ├─ 壳在但页面空白 → wgt/JS 错误
      │     ├─ 服务器 wgt 回滚到上一版
      │     ├─ 远程开关关闭问题模块
      │     └─ 下次启动用户拉回旧 wgt
      └─ 仅某功能异常 → 远程开关降级该功能

代码或图示

判定树:
用户反馈
  ├─ App 直接闪退? → 看崩溃平台堆栈 → 原生壳问题 → 紧急修复包
  ├─ 启动后白屏? → 看 wgt 版本与下载日志 → 回滚 wgt
  ├─ 仅某功能失效? → 远程关闭该功能 → 查 JS 错误
  └─ 某机型/系统版本独有? → 缩小范围,查该版本 API 兼容

常见误区

  • 误区:白屏就是网络问题;正解:白屏可能是 wgt 下载失败、JS 报错、入口路由异常、远程配置下发了错误开关。
  • 误区:出问题才准备回滚方案;正解:wgt 回滚与远程开关必须在每次发布前就准备好,故障时再做就来不及。

追问

  • 如何监控 wgt 版本分布?答:启动时上报当前 appVersion 与 wgtVersion 到后端,分桶看各版本的错误率。
  • 用户长时间不更新 wgt 怎么办?答:wgt 检查要有重试机制,但不要强杀;关键 bug 可提示"重启应用"而非强制升级。