Skip to content

Files

Latest commit

 

History

History
 
 

buildSrc

gradle-small-plugin是一个gradle插件,用来打包安卓组件包。

使用方法

  1. 在root工程的build.gradle中添加依赖:
buildscript {
    repositories {
        jcenter()
        mavenLocal()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'net.wequick.tools.build:gradle-small:0.9.0'
    }
}

allprojects {
    repositories {
        jcenter()
        mavenLocal()
    }
}
  1. 应用工程配置插件
apply plugin: 'net.wequick.small'

原理

gradle-small-plugin内部注册了5个插件:

名称 ID
工程配置插件 net.wequick.small net.wequick.gradle.RootPlugin
宿主配置插件 net.wequick.small.host net.wequick.gradle.HostPlugin
App组件打包插件 net.wequick.small.application net.wequick.gradle.AppPlugin
Library组件打包插件 net.wequick.small.library net.wequick.gradle.LibraryPlugin
资源组件打包插件 net.wequick.small.asset net.wequick.gradle.AssetPlugin

假设工程目录结构为:

Sample (Root)
  |-- app (Host)
  |    `-- build.gradle
  |-- app.home
  |    `-- build.gradle
  |-- lib.utils
  |    `-- build.gradle
  |-- web.about
  |    `-- build.gradle
  `-- build.gradle 

当在Root的build.gradle中配置aply plugin 'net.wequick.small时,将会遍历其所有的子模块(subprojects):

  • app 模块应用 HostPlugin
  • app.* 模块应用 AppPlugin
  • lib.* 模块应用 LibraryPlugin
  • [others].* 模块应用 AssetPlugin

HostPlugin

用于配置宿主:

  1. 增加jni libs目录smallLibs

    • 该目录用以存放其它组件包生成的*.so文件;
    • 宿主运行时将自动复制其下*.so文件至应用程序缓存。
  2. 复制release签名配置到debug模式

    • 各组件编译时使用宿主的release签名,以使得release版本的宿主可以通过比对签名来校验插件。为此在调试运行宿主的时候也使用release签名,避免调试时签名校验失败而中断。
  3. 增加buildLib task

    • 宿主程序作为一个壳,通过该task预编译生成宿主的jar文件,供其它组件引用以便打包时分离。

AppPlugin

用于App组件打包:

  1. 分离宿主、公共库的类与资源

    • 移除宿主的主题资源(AppCompat),将插件中的Theme.AppCompat等资源id替换为宿主程序对应的id。(主题的递归应用在Native层的ResourcesType.cpp中实现,无法在Java层做动态替换,为此我们需要在编译阶段,提前做好主题的资源id映射)
    • 移除其它公共资源
    • 移除公共类
  2. 分配资源id

    • 为保证整合在一起的程序资源id不冲突,对组件包分配 [0x03, 0x7e] 之间的package id。

LibraryPlugin

用于公共库组件打包:

  1. 在编译App组件包时,使用com.android.library模式
  2. 在编译自己时,切换为com.android.application模式,并按App组件打包
  3. 增加buildLib task,生成jar包,供其它组件引用以便打包时分离

AssetPlugin

用于资源组件打包:

  1. 复制assets目录下文件
  2. 生成二进制AndroidManifest.xml
    • 携带versionCode以供插件版本比对
    • 使插件可以通过PackageManager的getPackageArchiveInfo方法获取签名信息
  3. 签名组件包

此类打包忽略所有java文件,直接将assets目录中的文件进行压缩打包。

aar-small内部内置了WebBundleLauncher(网页资源组件包加载器)用来加载web.*的网页组件。

基于这个架构,您可以扩展自己的自定义组件,比如扩展支持Markdown组件:

  1. 新建md.*模块,该模块的src/main/assets目录中添加index.md文件
  2. 新建MdBundleLauncher类来加载md.*模块