Android Apply Changes 源码 Deployer 解析

源码链接

https://android.googlesource.com/platform/tools/base/+/37d63d4040a41987551704400d471793285f1c85/deploy/deployer/src/main/java/com/android/tools/deployer/Deployer.java

一般代码直接看 studio-master-dev 分支就好,此处为了溯源指定了具体 commit。

功能:

IDE 上面的三个按钮对应三个方法
Run -> Deployer::install
Apply Code Changes -> Deployer::codeSwap
Apply Changes and Restart Activity -> Deployer::fullSwap

参数分析:

Deployer::install

/**
 * 对应 IDE 中的 Run 按钮。
 * 
 * @param packageName 包名
 * @param apks 待安装的 apk 文件列表
 * @param options 设置 adb install 的参数
 * @param installMode 安装模式,分为三种:发送整个 APK 安装;只发送变化部分进行安装,只发送变化部分进行安装且如果 APK 无变化也不跳过安装
 */
public Result install(String packageName, List<String> apks, InstallOptions options, InstallMode installMode)

Deployer::codeSwap

/**
 * 对应 IDE 中的 Apply Code Changes 按钮。
 * 
 * @param apks 待安装的 apk 文件列表
 * @param redefiners 类重定义实现类。从源码来看,主要是未 debug attached 时传入 DebuggerRedefiner,其他情况传入empty map
 */
public Result codeSwap(List<String> apks, Map<Integer, ClassRedefiner> redefiners)

Deployer::fullSwap

/**
 * 对应 IDE 中的 Apply Changes and Restart Activity 按钮。
 * 对比可以发现,fullSwap 和 codeSwap 区别只有两点:
 * 1. 是否支持传入 redefiners(codeSwap 支持,fullSwap 不支持)
 * 2. 是否重启 Activity(codeSwap 不重启,fullSwap 重启)
 * 
 * @param apks 待安装的 apk 文件列表
 */
public Result fullSwap(List<String> apks)

流程分析

版本区别

  • Android 11 以上 supportsNewPipeline = true
  • Android 11 支持新的 swap 流程 optimisticSwap
  • optimistic 意思是“乐观的”,流程中 optimisticSwap 会假设部署 cache 是正确的,以减少设备通信数据量,从而提高 swap 效率
  • optimisticSwap 支持资源更新

Deployer::install

调用 ApkInstaller 安装 apk,如果设备 supportsNewPipeline,则讲 apk 录入到数据库中,用于后续 codeSwap 和 fullSwap

Deployer::codeSwap

如果支持 supportsNewPipeline 且开启 useOptimisticResourceSwap,则调用 optimisticSwap;否则调用 swap

Deployer::fullSwap

如果支持 supportsNewPipeline 且开启 useOptimisticResourceSwap,则调用 optimisticSwap;否则调用 swap

fullSwap 和 codeSwap 区别只有两点:

  1. 是否支持传入 redefiners
  2. 是否重启 Activity(codeSwap 不重启,fullSwap 重启)

Deployer::swap

runner.create 会将创建的 Task 加入队列,随后调用 run/runAsync 时会将任务队列拷贝一份然后清空,然后按顺序执行拷贝的任务队列。
Task 命名方式是以 Task 运行完后返回的结果命名

  1. paths: (参数)Apk 路径
  2. restart: 重启
  3. splitter: (参数)拆分 Dex 实现类 CachedDexSplitter
  4. newFiles: 解析新 apk 的 zip entries
  5. dumps: 从设备上拉取已安装的同包名 apk 的 zip entries
  6. diffs: 对以上两个列表做 diff,得出变更文件的列表
  7. sessionId: 通过 ApkPreInstaller 安装 apk
  8. dexDiffs: 过滤掉不支持 swap 的文件
  9. toSwap: 比较本地和设备上的 dex 文件,根据文件列表 dexDiffs 验证是否支持 apply changes(是否改动 dex,资源之外的内容),如果不支持则退出。不支持的情况如:新增了类,改变了方法签名等。
  10. swapper: 开始 swap dex 和资源
  11. (如果成功)CACHE, DEPLOY_CACHE_STORE: 异步将变更文件列表存储在数据库

Deployer::optimisticSwap

  1. paths: (参数)Apk 路径
  2. restart: 重启任务
  3. splitter: (参数)拆分 Dex 实现
  4. newFiles: 解析新 apk 的 zip entries
  5. packageName,pids,arch,获取包名,进程 id,架构
  6. speculativeDump: 从设备上拉取已安装的同包名 apk 的 zip entries,假设本地 cache 是正确的
  7. dumper: (参数)ApplicationDumper
  8. verifyDump: 校验拉取的 apk 的 zip entries
  9. diffs: 对以上两个列表做 diff,得出变更文件的列表,并推测本地 cache 是正确性
  10. extractedFiles: 解压 apk 的res 和 assets 资源
  11. dexDiffs: 过滤掉不支持 swap 的文件
  12. changedClasses: 比较本地和设备上的 dex 文件,根据文件列表 dexDiffs 验证是否支持 apply changes(是否改动 dex,资源之外的内容),如果不支持则退出。不支持的情况如:新增了类,改变了方法签名等。
  13. swapper: 开始 swap dex 和资源
  14. overlayUpdate: 收集更新资源列表
  15. nextOverlayId: 更新资源
  16. (如果成功)CACHE, DEPLOY_CACHE_STORE: 异步将变更文件列表存储在数据库

可以看到 optimisticSwap 和 swap 区别是:

  1. 从设备拉取变更文件列表的流程不同了
  2. 支持资源 overlay

附录

参考资料:Android Studio Apply Changes

版权所有,转载请注明出处:
https://sickworm.com/?p=1861

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据