atlasplugin
- changelog

atlasplugin

changelog

2.3.3.beta1

升级android builder 到 2.3.3版本
unit tag 非 diff bundle 保持不变
tBuildConfig.minPackageId 可设置最小的自动分配packageId，默认35（10进制）开始
加强对插件配置使用的校验
1. 不推荐在atlasplugin之前添加google官方的插件，推荐让atlasplugin自动依赖传递进来
2. bundle之前的依赖推荐使用bundleCompile，如果使用compile awb，会有警告日志
3. awb 之间允许使用 providedCompile 依赖

databinding优化，后续bundle的databinding需要独立配置是否启用

 tBuildConfig.dataBindingBundles 
 配置值为 bundle 的packageName 
 类型为 Set<String>
 代码： com.taobao.android.builder.extension.TBuildConfig.dataBindingBundles

2.3.1.rc15

bundleInfo 增加unique_tag
增加fastMultiDex功能，该功能需要关闭android里的multidexEnabled，充分利用predex和dexcache。配置开关 atlas.multiDexConfigs.debug.fastMultiDex=true

2.3.1.rc11

支持bundle配置proguard规则，仅支持keep和dontwarn

2.3.0.alpha15

支持手淘灰度版本
升级aapt
增加atlasMultiDex功能,默认关闭，mtl.tBuildConfig.atlasMultiDex=true

2.3.0.alpha11

processManifest 修复无 application ，替换的不对
awb 增加 process resource 逻辑
butterknife 支持

2.3.0.alpha10

修复postprocessmanifest
data-bind支持
升级dex_patch，支持远程bundle patch

2.3.0.alpha7

修复某些场景下buildcache导致的构建失败
修复 awo 快速调试
升级 dex_patch ,兼容windows ，版本 1.1+
依赖解析优化，避免递归循环

2.3.0.alpha4

支持google的最新插件，builder ： 2.3.0 ， gradle ： 3.3 ， buildTools ：25.0.0+

优化atlas插件对官方插件的侵入，允许推荐使用：

 apply plugin: 'com.android.application'
 apply plugin: 'com.taobao.atlas'

对多模块更好的支持，回归原本的本地开发模式

新增2种依赖关系

 providedCompile ： bundle定义运行时依赖，编译运行可见， 最终不会打到bundle的so中
 bundleCompile :  在app中定义bundle的依赖

远程bundle支持

支持 atlas 工程打包的gradle 插件，基于 google 官方的 android builder （2.2.3）

基本概念

atlasplugin : 支持atlas的gradle打包插件，支持打 apk 和 awb
awb ：包结构上和 aar 一致，在 atlas 里每一个 awb 被认为是一个独立的业务模块，有独立的application， awb 之前默认是不能相互依赖，具体参考 atlas-demo/firstbundle
ap : 基线包，里面包含该版本对应的 apk 产物及其他打包过程中的中间产物，是打 patch 包的必要条件

主要功能

支持 awb 类型依赖
支持 bundle 的package
支持动态部署

接入

引用插件

 buildscript {
     repositories {
         mavenLocal()
         jcenter()
     }
     dependencies {
         classpath "com.taobao.android2.2.3.alpha+"
     }
 }

注意尽量不要指定 classpath “com.android.tools.build:gradle”的版本，默认使用的是 2.2.3

应用plugin

  apply plugin: 'com.android.application'
  apply plugin: 'com.taobao.atlas'

配置打包参数， ./gradlew atlasList, 具体见 配置
执行构建 ./gradlew assembleDebug 或者 assembleRelease
构建产物：
1. build/outputs/apk/xx.apk , 构建的产物apk
2. build/outputs/apk/xx.ap , 构建的基线包，里面包含 apk 和其他的打包中间配置
3. build/outputs/dependencyTree-debug.json , 整个工程的依赖树
4. build/outputs/atlasConfig.json , 整个打包的 atlas 配置参数
5. build/outputs/packageIdFile.properties , 每个bundle对应的packageId 列表
6. build/outputs/tpatch-debug , debug 包 patch产物
7. build/outputs/tpatch-release , release 包 patch产物

配置

配置列表

功能	配置名称	类型	值
是否启用atlas	atlas.atlasEnabled	boolean	true
自动生成bundle的packageId	atlas.tBuildConfig.autoPackageId	boolean	true
预处理manifest，如果开启atlas，必须为true	atlas.tBuildConfig.preProcessManifest	Boolean	true
使用自定义的aapt，如果开启atlas，必须为true	atlas.tBuildConfig.useCustomAapt	Boolean	true
aapt输出的R为常量, 建议值设置为false，可以减少动态部署的patch包大小	atlas.tBuildConfig.aaptConstantId	Boolean	true
合并jar中的资源文件	atlas.tBuildConfig.mergeJavaRes	Boolean	false
构建基线包，建议开启，否则后面的patch包无法进行	atlas.tBuildConfig.createAP	Boolean	true
合并bundle jar中的资源文件	atlas.tBuildConfig.mergeAwbJavaRes	Boolean	false
是否依赖冲突终止打包	atlas.tBuildConfig.abortIfDependencyConflict	boolean	false
是否类冲突终止打包	atlas.tBuildConfig.abortIfClassConflict	boolean	false
自启动的bundle列表，值是 packageName	atlas.tBuildConfig.autoStartBundles	List	[com.taobao.firstbundle]
提前执行的方法，格式是 className:methodName	className2:methodName2 ，注意class和methodname都不能混淆，且方法实现是 class.method(Context)	atlas.tBuildConfig.preLaunch	String
基线的依赖坐标，如： com.taobao.android6.3.0-SNAPSHOT@ap	atlas.buildTypes.debug.baseApDependency	String	null
基线的依赖坐标，如： com.taobao.android6.3.0-SNAPSHOT@ap	atlas.buildTypes.release.baseApDependency	String	null
使用atlas的application，包含 atlas基础初始化及multidex逻辑	atlas.manifestOptions.replaceApplication	boolean	true
打动态部署 patch 包	atlas.patchConfigs.debug.createTPatch	boolean	true
打动态部署 patch 包	atlas.patchConfigs.release.createTPatch	boolean	false

最简配置

atlas {
    atlasEnabled true
}

具体参考 atlas-demo/AtlasDemo/app/build.gradle