Android Studio 打包 aar

  需要打包 aar 的 lib 模块如果需要依赖其他 aar、依赖库,可以使用 fat-aar-android 插件,但是项目不再维护,不支持 gradle 8 以上

  8.0 以上可以使用其 fork 项目 fat-aar-android,不过测试 8.2 的时候,发布的版本没成功,最终在 issuse 找到对应版本

AGP 8.2 导入插件依赖

  • settings.gradle
pluginManagement {
    repositories {
        ...
        maven {
            setUrl("https://jitpack.io")
            content { includeGroup("com.github.aasitnikov") }
        }
    }
}
  • build.gradle
buildscript {
    dependencies {
        classpath "com.github.aasitnikov:fat-aar-android:ce932b38ef"
    }
}
plugins {
    id 'com.android.application' version '8.2.0' apply false
    id 'com.android.library' version '8.2.0' apply false
}

  其余的内嵌 aar、依赖、模块打包 aar 的方式请参考 fat-aar-android 示例

dependencies {
    implementation fileTree(dir: 'libs', include: '*.jar')
    // java dependency
    embed project(path: ':lib-java', configuration: 'default')
    // aar dependency
    embed project(path: ':lib-aar', configuration: 'default')
    // aar dependency
    embed project(path: ':lib-aar2', configuration: 'default')
    // local full aar dependency, just build in flavor1
    flavor1Embed project(path: ':lib-aar-local', configuration: 'default')
    // local full aar dependency, just build in debug
    debugEmbed (name:'lib-aar-local2', ext:'aar')
    // remote dependency
    implementation 'com.google.guava:guava:20.0'
    // remote aar dependency
    embed ('com.facebook.fresco:fresco:1.12.0') {
        // exclude any group or module
        // exclude(group:'com.facebook.soloader', module:'soloader')
    }
    // remote aar dependency
    embed ('com.github.bumptech.glide:glide:4.11.0') {
        // If transitive = false, it will not embed dependencies declared in pom.xml
        // If fataar.transitive = false, There is no need to declare.
        transitive = false
    }
    // don't want to embed in
    implementation('androidx.appcompat:appcompat:1.6.1')
}

-------- 下面是早期 gradle 打包 aar 方式,较新的 gradle 版本不再支持 --------


  演示Demo中创建了两个 Library Module,其中A不包含第三方依赖库,B包含;笔者将在下面介绍两种类型的打包,并在app module中引用


图1. 项目目录

一、不包含第三方依赖的打包

  如果需要打包的\color{#AA0000}{module}中没有引入任何的第三方依赖库,或者打包出来的aar在其他项目中并不需要用到依赖的三方库,可以使用该方式打包;否则请看下面 包含第三方依赖的打包

  1. Android Studio 打开右侧的 Gradle 面板,选择需要打包的module —> Tasks —> build, 双击 assemble

图2. assemble 打包 aar

  2. Build Successed 之后,将会在module的build/outputs/aar目录下生成 debug 和 release 两个版本的 aar包

图3. aar包

  3. 在 app module 中引用 libraryA,先将刚才生成的aar拷贝到 app module 的 libs目录下

图4. 导入到app module下

  4. 在打开app module 的 build.gradle, 添加如下红色框中内容

图5. 添加 aar 依赖

repositories  {
    flatDir{ dirs 'libs'  }
}

compile(name: 'librarya-debug', ext: 'aar')


二、包含第三方依赖的打包

  如果library中引用了第三方的依赖包,再采用上面的方式,编译时将会提示说一些第三方的类文件找不到了。所以此时需要将library打成本地或远程的aar仓库,然后在项目中引用;
  1. 打开 library 的 build.gradle 文件,在最外层加入如下内容

apply plugin: 'maven'

// 省略其他配置

uploadArchives{
    repositories.mavenDeployer{
        // Ubuntu本地仓库路径, Windows 为(url:"file://D://***/***/***/")
        repository(url:"file:/home/jinyx/develop/other/")
        // 唯一标识
        pom.groupId = "com.jinyx"
        // 项目名称
        pom.artifactId = "libraryB"
        // 版本号
        pom.version = "1.0"
    }
}

  2. 同样的,打开Android Studio右侧的Gradle面板,双击 module下面的 Tasks/upload/uploadArchives

图6.上传仓库

  3. BUILD SUCCESSFUL之后,本地刚才配置的仓库路径中将会生成aar相关的文件

图7. 生成本地aar仓库

  4. 在app module中引用aar,首先在根目录的 build.gradle 的仓库配置中加入本地仓库地址,然后在app module 的bulid.gradle 中添加 项目依赖

// 添加到 root 的 build.gradle
maven{
    url 'file:/home/jinyx/develop/other/'
}

// 添加到 app 的 build.gradle,注意名字规则和上面配置本地仓库之间的关联
implementation 'com.jinyx:libraryB:1.0'

   远程仓库的就不说了,只是将上面配置的仓库地址 换成线上的


三、补充说明

  1. 打包的module需要是 library,如果是 application的module,需要将 build 配置中的 apply plugin: 'com.android.application' 替换成 apply plugin: 'com.android.library',并且去掉applicationId

  2. 打包的module下的清单文件,application标签下的android:name、android:roundIcon、android:icon三个属性需要移除,避免和引用的项目中的清单文件产生冲突。同样的,由于aar将资源文件也打包在里面,所以需要避免和引用的项目重名,造成资源冲突

  3. 如果是打包的app模块,一般会有自定义的Application,用于一些SDK的初始化等操作,但是上面说到android:name属性需要移除,所以引用aar的项目的application,需要继承aar中原先的application,或者是实现里面的初始化等内容

  4. 上面提到,application模块打包成aar时,需要移除applicationId,所以问题来了;Android7.0对文件访问的限制,需要添加 File Provider,其中使用差值表达式引用了applicationId

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="${applicationId}.file.provider"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/boxing_file_provider" />
</provider>

   如果 build.gradle 中没有定义 applicationId,那么编译时会把 AndroidManfest 中的packageName 作为 applicationId

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容