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 可提示"重启应用"而非强制升级。