Awesome Open Source
Awesome Open Source

fastdex

license Download

如果你忍受不了apk龟速的编译(尤其是项目中有多个dex),fastdex可以帮助你加快apk生成过程

fastdex.png

Android API 9(2.3)+ ; android-gradle-build 2.0.0+

版本记录

使用方式

idea 插件

在Android Studio中,打开搜索插件页面:

  • MacOS

    Android Studio → Preferences → Plugins → Browse repositories

  • Windows 和 Linux

    File → Settings → Plugins → Browse repositories

搜索fastdex安装重启Android Studio就可以了。

手动配置

  • 1、关闭Instant Run功能 点击左上角Android studio -> Preferences -> Build,Execution,Deployment -> Instant Run -> Enable Instant Run......(把对勾去掉)

  • 2、在root project下的build.gradle中添加依赖

     buildscript {
         repositories {
             jcenter()
         }
         
         dependencies {
             classpath 'com.github.typ0520:fastdex-gradle:0.8.6'
         }
     }
    
  • 3、在app的项目中的build.gradle添加插件

    apply plugin: 'fastdex.app'
    
  • 4、直接点击studio的run或者执行打包命令,就会在任务执行的过程中做hook

    第一次全量打包成功后,fastdex支持把增量的dex和资源推送到正在运行的app里重启并加载,这样会省去安装app的时间开销
    拿debug为例如果没有配置flavor就执行(gradlew fastdex${Variant})
    
    Mac/Linux:
    ./gradlew fastdexDebug
    
    Windows:
    gradlew.bat fastdexDebug
    

注意事项

  • 1、不要把fastdex打出来的包用在生产环境,因为fastdex打出来的包项目所有的代码都在第二个dex后面,会造成5.0以 下机器首次运行比较慢(如果是本地调试就无所谓了);当打包生产环境apk时注释掉加入插件的代码 //apply plugin: 'fastdex.app'

  • 2、fastdex会忽略开启混淆的buildType

  • 3、强烈建议你的application不要直接依赖library工程,打成aar包让application工程远程依赖

实现原理

  • gradle在执行transformClassesWithDexFor${variant}任务生成dex文件时会很慢(尤其是开启了multidex),我们在开发中,修改的几乎全是项目代码,第三方库改动比较小。fastdex的原理就是预先把所有代码生成dex, 当下次执行assemble任务时只会把项目目录下变化的代码生成dex,然后和缓存的dex合并生成apk,这样即不影响调试,又能在生成dex的过程中省下了大量的时间。 详情

  • 应用安装的速度比较慢,尤其是5.0以后的版本,fastdex会把补丁dex和资源通过adb推到正在运行的app里直接重启app

打包流程

全量打包时的流程:
  • 1、合并所有的class文件生成一个jar包
  • 2、扫描所有的项目代码并且在构造方法里添加对fastdex.runtime.antilazyload.AntilazyLoad类的依赖 这样做的目的是为了解决class verify的问题, 详情请看 安卓App热补丁动态修复技术介绍
  • 3、对项目代码做快照,为了以后补丁打包时对比那些java文件发生了变化
  • 4、对当前项目的所以依赖做快照,为了以后补丁打包时对比依赖是否发生了变化,如果变化需要清除缓存
  • 5、调用真正的transform生成dex
  • 6、缓存生成的dex,并且把fastdex-runtime.dex插入到dex列表中,假如生成了两个dex,classes.dex classes2.dex 需要做一下操作 fastdex-runtime.dex => classes.dex classes.dex => classes2.dex classes2.dex => classes3.dex 然后运行期在入口Application(fastdex.runtime.FastdexApplication)使用MultiDex把所有的dex加载进来
  • @see fastdex.build.transform.FastdexDexTransform
  • 7、保存资源映射表,为了保持id的值一致,详情看
  • @see fastdex.build.task.FastdexResourceIdTask
补丁打包时的流程
  • 1、检查缓存的有效性
  • @see fastdex.build.variant.FastdexVariant 的prepareEnv方法说明
  • 2、扫描所有变化的java文件并编译成class
  • @see fastdex.build.task.FastdexCustomJavacTask
  • 3、合并所有变化的class并生成jar包
  • 4、生成补丁dex
  • 5、把所有的dex按照一定规律放在transformClassesWithMultidexlistFor${variantName}任务的输出目录 fastdex-runtime.dex => classes.dex patch.dex => classes2.dex dex_cache.classes.dex => classes3.dex dex_cache.classes2.dex => classes4.dex dex_cache.classesN.dex => classes(N + 2).dex

Thanks

Instant Run

Tinker

Freeline

安卓App热补丁动态修复技术介绍

Android应用程序资源的编译和打包过程分析


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (705,197
Android (40,328
Gradle (2,961
Android Studio (2,468
Android Studio (2,468
Build Tool (1,013
Apk (569
Dex (265
Idea Plugin (188
Related Projects