Skip to content

Clean Reinstall

Clean Reinstall 用于重新建立 App 在设备上的可信基线。Jugg 会安装当前 APK,并在需要时清理 App 数据、重置部署历史和 overlay checkpoint,避免后续增量部署建立在不匹配的状态上。

何时会重新安装

操作场景当前支持情况部署策略
Gradle 构建后的首次部署支持直接安装本轮 APK,并写入 deployment cache
设备未安装目标 App支持install 替代增量部署
clean reinstall 选项开启支持先清理 App 数据,再安装 APK
overlay 或 cache 状态不匹配支持recover 失败后重新安装
APK install 遇到可恢复异常支持有限重试必要时卸载当前 applicationId 后重新安装
多 APK 应用支持按 applicationId 分组安装 base、split 或 test APK

NOTE

Clean Reinstall 会重置增量部署基线。它不是普通热更新路径,但能让下一轮增量部署重新获得可信的 APK、history 和 overlay 状态。

这项能力如何生效

text
需要 install
  -> 停止目标 App
  -> 组装 install 用 JuggDeployData
  -> 按 applicationId 分组安装 APK
  -> 写入 Android Studio deployment cache
  -> 更新 Jugg 部署历史和 overlay id
  -> reset staging / deployed 文件状态

安装前先停止 App,避免用户看到“安装成功后又被停止”的体验。安装成功后,Jugg 会把当前 APK 与 overlay id 作为新的部署 checkpoint;如果是 recover 触发的 reinstall,还会清空旧的 deployed data、resource APK 和 staging 状态。

与增量部署的关系

Clean Reinstall 通常出现在以下边界:

  • Gradle 编译成功后,需要用完整 APK 重新建立基线。
  • dry deploy 或 Direct Overlay 状态校验失败,说明设备端不适合继续热更。
  • App 被外部安装、卸载、清数据或切换工程后,历史 checkpoint 已不可信。

成功 reinstall 后,后续修改仍会优先走增量部署。

关联能力