• 在Android中开发插件时,插件如需依赖某些远程库,有可能主工程也依赖这些库,比如官方的support库com.android.support:design:xxx
• 这时要求插件构建过程中不能带入这些库的代码,要在运行时使用主工程中的
• 插件为了编译通过,需要以provided方式依赖这些库的代码,而Android Gradle插件不允许provided方式依赖远程project
• 最原始的做法是,手动将这些库的代码打入jar包中,然后provided方式依赖这个jar包
• 但这个做法太费力了,每当远程库有更新,就需要手动重复上面的过程

这个external-support-lib-jars目录里,存放着全部"com.android.support:design:26.0.0"远程project所包含的代码的jar包

• 在build.gradle的dependencies{}块之前,创建一个新的configuration名叫providedExternalModule:

   configurations {
      providedExternalModule.setTransitive(true)
   }
   
   dependencies {
   ....

• 在build.gradle的dependencies{}块中,将想以provided方式依赖的远程库,用providedExternalModule方式依赖:

   dependencies {
      ....
      providedExternalModule "com.android.support:design:26.0.0"
      ....
   }

• 在build.gradle的最后,引入本脚本:

   apply from: "provided_project.gradle"

• 最后,也是最简单的一步,拷贝脚本provided_project.gradle到build.gradle的同级目录

• Android Gradle插件不允许以provided方式依赖aar包或任何project(本地或远程),这是无法改变的
• "provided"是一种configuration,我们可以自定义一个configuration,利用它的asPath方法获取用这个configuration依赖的远程库的所有aar包路径
• 远程库的aar包在用户的gradle缓存目录里,利用上一步得到的路径,可以找到这些aar包,提取其内部的jar包,然后都拷贝到特定目录里
• 最后,用provided方式依赖特定目录里的所有jar包

• 在Android构建过程中,如果java代码总方法数超过65536,就需要进行MultiDex处理,将代码分散到多个Dex中
• 在Android 4.4及以下系统上,应用启动时会先加载apk中的classes.dex,再通过MultiApplication加载其它classesX.dex
• 这个最先加载的classes.dex,称为mainDex,应包含应用启动过程中所需的最低限度的代码.如果缺少了某些类,会导致NoClassDefFound异常,进而崩溃
• 从线上情况看,有些<4.4的手机,mainDex中包含某个类A.class,但不包含这个类的匿名内部类A$B.class,导致启动应用时,A.class调用A$B.class导致崩溃
• 本Gradle脚本的功能就是补足mainDex中缺失的A$B.class这样的内部类

• 使用本脚本后,构建过程中transformClassesWithJarMerging的默认task前,出现了一个新task:transformClassesWithCollectJarClassInfoTransform
• 使用本脚本后,构建过程中transformClassesWithMultidexlist和transformClassesWithDex两个默认的task之间,出现了一个新task:fixMainDexTask

• fixMainDexTask会打印出需要补进mainDex中的所有内部类,比如android/preference/ColorSwitchPreference$Listener.class

• 最终apk的classes.dex中,有了android/preference/ColorSwitchPreference$Listener.class,还有其它补进mainDex的内部类

• 将本demo的buildSrc目录复制到工程目录中,这里面包含本脚本所属的Gradle插件:
• 在build.gradle的开头引入Gradle插件:

   ...
   apply plugin: com.lilong.gradle.Demo
   ...

• 在build.gradle的android块中加入minimal-main-dex设置:

   ...
   android{
   ...
       dexOptions {
           additionalParameters '--minimal-main-dex'
       }
   ...
   }
   ...

• 用transformAPI注册一个名为CollectJarClassInfo的transform,这会导致构建过程中transformClassesWithJarMerging的默认task前,出现了一个新task:transformClassesWithCollectJarClassInfoTransform,其作用是记录所有jar包中的类名
• 默认的Gradle task : transformClassesWithMultidexlist会在build/intermediates/multi-dex/目录下生成maindexlist.txt,内容是它认为应当出现在mainDex中的类
• 默认的Gradle task : transformClassesWithDex会根据maindexlist.txt生成mainDex,即classes.dex
• 在这两个task中间,插入自定义task : fixMainDexTask,其作用是读取构建工具得到的maindexlist.txt,遍历其中每个类名A.class,然后从CollectJarClassInfoTransform中收集的jar包中的所有类名 build/intermediates/classes目录收集的应用代码中的所有类名两者总集中,找到形如A$B.class的类名,写入maindexlist.txt
• --minimal-main-dex配置是为了让mainDex一开始只打进必须的类,尽可能小,给后面补进的类留出空间,也避免非必须类的干扰