目录
前置知识
这篇文章的内容会涉及以下前置 / 相关知识，贴心的我都帮你准备好了，请享用~
Gradle | 进阶篇（Project & Task & 构建生命周期）Gradle | 手把手自定义 Gradle 插件1. 概念剖析1.1 什么是 POM？
POM（Project Object Model）指项目对象模型，用于描述项目构件的基本信息。一个有效的 POM 节点中主要包含一下信息：
| 配置 | 描述 | 举例（‘com.github.bumptech.glIDe:glIDe:4.11.0’） |
|---|---|---|
| groupID | 组织 / 公司的名称 | com.github.bumptech.glIDe |
| artifactID([ˈɑːtɪfækt]) | 组件的名称 | glIDe |
| version | 组件的版本 | 4.11.0 |
| packaging | 打包的格式 | aar |
在项目中，我们会需要依赖各种各样的二方库或三方库，这些依赖一定会存放在某个位置（Place），这个 “位置” 就叫做仓库。使用仓库可以帮助我们管理项目构件，例如 jar、aar 等等。
主流的构建工具都有三个层次的仓库概念：
1、本地仓库： 无论使用 linux 还是 Window，计算机中会有一个目录用来存放从中央仓库或远程仓库下载的依赖文件；2、中央仓库： 开源社区提供的仓库，是绝大多数开源库的存放位置。比如 Maven 社区的中央仓库 Maven Central；3、私有仓库： 公司或组织的自定义仓库，可以理解为二方库的存放位置。构建时搜索依赖的顺序如下：
1、在本地仓库搜索，如果搜索不到，执行步骤 2；2、在中央仓库和私有仓库中搜索，搜索顺序按照repositorIEs中声明的顺序依次查找。如果找到，则下载依赖文件到本地仓库，否则执行步骤 3；3、如果最终找不到依赖项，则抛出错误 “无法找到依赖项”。如何在项目中声明仓库：
Gradle 默认的本地仓库目录：C:\Users\administrator\.gradle\caches\modules-2\files-2.1，Gradle 不会默认执行远程仓库和中央仓库，需要在项目级或模块级 build.gradle 文件中声明。例如：
项目级别 build.gradle
buildscript { repositorIEs { [Gradle 插件的仓库] }}allprojects { repositorIEs { [项目中所有模块依赖的仓库] }}模块级别 build.gradle
repositorIEs{ [当前模块依赖的仓库]}Gradle 支持多种类型的仓库，例如 Maven、ivy、flatDir。其中 flatDir 一般用于指定本地 aar 文件的地址。更多分析在 第 4.2 节。
repositorIEs{ maven { url '...' } ivy { url '...' } flatDir { dirs '...' }}Gradle 内置了一些常用中央仓库的路径，可以直接通过函数获取。例如：
Google() // https://dl.Google.com/dl/androID/maven2/mavenCentral() // https://repo.maven.apache.org/maven2/jCenter() // https://jcenter.bintray.com/有时候，直接访问中央仓库的速度太慢，此时可以尝试替换为国内大厂的中央仓库镜像。例如：
maven { url 'http://maven.aliyun.com/nexus/content/repositorIEs/Google' }maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }maven { url 'http://maven.aliyun.com/nexus/content/repositorIEs/jcenter' }「Gradle 插件」和「Gradle」这两个概念是比较容易混淆的。Gradle 是构建工具，相当于一个构建环境；而 Gradle 插件本质上就是具体的构建任务，我们将一个构建任务模块化抽离出来，提供给其他项目复用，就是一个 Gradle 插件。例如：
com.androID.application：AndroID 应用插件com.androID.library：AndroID 模块插件kotlin-androID：AndroID Kotlin 插件maven & maven-pulish：Maven 插件1.4 快照（SNAPSHOT）有什么用？快照是一种特殊的版本，与常规版本最大的不同是：快照版本每次构建时都会在远程仓库中检查最新的快照。
快照版本：1.0.0-SNAPSHOT常规版本：1.0.0为什么会有这种设计呢（牺牲编译时间）？因为在大型软件项目中，往往是多个团队（或多个同学）协同开发不同模块，例如 A 模块依赖 B 模块，两个模块并行开发。如果模块 B 不使用快照版本（例如版本为 1.0.0），那么当 B 模块在开发阶段需要更新，A 模块就无法接收到更新。因为 A 模块本地仓库中已经下载了 B 模块的 1.0.0 版本，所以构建时不会重复去下载远程仓库中更新的版本。
直接的解决办法可以清除 A 模块的本地仓库缓存，或者每次 B 模块更新都升级版本，很显然两个办法都不灵活，频繁升级版本也是对版本号的滥用，不利于版本管理。而如果模块 B 使用快照版本（1.0.0-SNAPSHOT），A 模块每次构建都会去检查远程仓库是否有 B 模块的新快照，就可以保证一直依赖 B 模块的最新版本。
总的来说，SNAPSHOT 适合快节奏协同开发阶段，代表着不稳定 & 开发中的版本。常规版本适合于正式发布版本，如果正式版本使用 SNAPSHOT，会导致重复构建正式版本不稳定。
2. Maven 构建生命周期
我们需要使用 Maven 插件来发布类库，简单理解下 Maven 构建的生命周期，主要分为以下个步骤：
| 任务 | 阶段 | 描述 |
|---|---|---|
| compile | 编译 | 编译源代码 |
| test | 测试 | 执行单元测试 |
| package | 打包 | 创建发布组件，如 jar、aar |
| install | 安装 | 安装组件包到本地仓库 |
| deploy / upload | 部署 | 上传组件包到远程仓库 |
—— 图片引用自网络
3. 如何发布组件（artifacts）？
在 Gradle 中发布组件，可以使用以下两个 Maven 插件：
Maven Plugin（旧版）Maven Publish Plugin3.1 发布到本地仓库我们需要使用 Maven 插件的uploadArchives任务，并且需要指定组件的信息。例如：
模块级 build.gradle
plugins { ID 'com.androID.library' ID 'kotlin-androID' ID 'maven'}...uploadArchives { repositorIEs { mavendeployer { // 发布地址：直接发布到项目本地路径 repository(url: uri('../repository')) // 组件信息：com.pengxr.demo:maven:v1.0.0 pom.groupID = "com.pengxr.demo" pom.artifactID = "maven" pom.version = "v1.0.0" } }}执行 Gradle Sync 之后，就可以在 Gradle 窗口该模块的 Tasks 列表中找到名为uploadArchives的任务。执行任务，完成后项目中会新增一个repository目录，里面就是新发布的组件。
注意事项：
1、升级到 AndroID Stidio 4.2 之后，如果在 Gradle 栏目中找不到 Task 列表，在设置里取消勾选此项即可：2、无法发布应用模块plugins { ID 'com.androID.application' // 无法发布应用模块 ID 'kotlin-androID' ID 'maven'}发布组件到本地仓库只能单机使用，在实际工作中，我们往往需要将组件发布给其他团队成员使用。此时，可以将组件发布到 局域网私有仓库。最常见的私有仓库管理工具是 Nexus [ˈneksəs]。按照以下步骤搭建环境：
1、下载 Nexus 安装包： 这里以 Mac 环境为例：下载地址；
2、启动 Nexus 服务进程： 进入安装路径/nexus-3.30.1-01/bin，在终端运行命令：
./nexus start./nexus status输出：nexus is running. 表示启动成功需要停止服务时，可以执行命令：./nexus stop这个列表包含了所有的 Nexus 仓库，点击 “copy” 按钮，可以复制仓库的 URL 地址。其中两个仓库比较常用：
maven-release：策略为 Release 的宿主类型仓库，用于部署内部组件的发布版本；
maven-snapshots：策略为 Shapshot 的宿主类型仓库，用于部署内部组件的快照版本。
类型（Type）：group（仓库组）、hosted（宿主）、proxy（代理）和 virtual（虚拟）；
格式（Format）：maven1、maven2、nuget
5、发布到指定仓库： 在模块级 build.gradle 中增加配置：模块级 build.gradle
apply plugin: 'maven' // Maven 插件...uploadArchives { repositorIEs { mavendeployer { // url：仓库路径 // username：账号名 // password：密码 repository(url: "http://127.0.0.1:8081/repository/maven-releases/"){ authentication(username: "admin", password: "pengxurui123") } pom.groupID = "com.pengxr.demo" pom.artifactID = "maven" pom.version = "v1.0.0" } }}执行任务，发布成功后可以在 nexus 管理平台上看到新发布的类库：
6、依赖类库： 在项目级 build.gradle 声明远程仓库，在模块级 build.gradle 中依赖类库。项目级 build.gradle
allprojects { repositorIEs { Google() mavenCentral() maven { url "http://127.0.0.1:8081/repository/maven-releases/" } }}模块级 build.gradle
dependencIEs { ... implementation 'com.github.pengxurui:MavenPuhlish:v1.0.4'}3.3 发布到 Github 仓库提示： 当然了，实际项目中 nexus 不可能配置在本机上，而是会配置在局域网服务器中。
如果你需要将开源，那么就需要发布到公共仓库，这一节介绍发布到 Github 的步骤：
1、依赖 Github Maven 插件： 在项目级 build.gradle 中添加插件依赖：项目级 build.gradle
dependencIEs { ... classpath "com.github.dcendents:androID-maven-gradle-plugin:1.5" // // GitHub Maven 插件}模块级 build.gradle
apply plugin: 'com.github.dcendents.androID-maven' // GitHub Maven 插件模块级 build.gradle
apply plugin: 'com.github.dcendents.androID-maven' // GitHub Maven 插件group = 'com.github.pengxurui' // github 的用户名4、将项目 push 到 Github
5、在 Github 上创建 Release Tag（在本地创建 Tag 再推到 Gtihub 也一样）：
6、将项目上传到 JitPack： 打开 jitpack.io/，将项目链接复制到输入… Look up，等待编译完成。到这里就完成发布了。7、依赖类库： 在项目级 build.gradle 声明远程仓库，在模块级 build.gradle 中依赖类库。项目级 build.gradle
allprojects { repositorIEs { Google() mavenCentral() maven { url "https://jitpack.io" } }}模块级 build.gradle
dependencIEs { ... implementation 'com.github.pengxurui:MavenPuhlish:v1.0.4'}踩坑记录：
模块 build.gradle 中应用了 Github Maven 插件后，要去掉 uploadArchives 任务，否则构建会报错。Exception is:java.lang.IllegalAccessError: trIEd to access method org.gradle.API.internal.artifacts.DefaultModuLeversionIDentifIEr.<init>(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V from class org.gradle.API.plugins.AndroIDMavenPlugin使用新版 Maven 插件，可以直接以指定二进制文件的方式发布组件。例如：
apply plugin: 'maven-publish'publishing { publications { [任务名](MavenPublication) { groupID MAVEN_GROUP_ID artifactID MAVEN_ARTIFACTID version MAVEN_VERSION artifact([文件路径]) } } repositorIEs { maven { // 发布仓库路径 url MAVEN_RELEASE_URL } }}4. 实战应用4.1 封装通用发布脚本
随着项目组件化程度加深，越来越多组件需要发布到 Maven 仓库，此时就很有必要将 Maven 发布能力封装为一个通用脚本，步骤如下：
步骤 1：封装发布脚本：maven.gradle
apply plugin: 'maven'uploadArchives { repositorIEs { mavendeployer { // 是否快照版本 def isSnapShot = Boolean.valueOf(MAVEN_IS_SNAPSHOT) def versionname = MAVEN_VERSION if (isSnapShot) { versionname += "-SNAPSHOT" } // 组件信息 pom.groupID = MAVEN_GROUP_ID pom.artifactID = MAVEN_ARTIFACTID pom.version = versionname // 快照仓库路径 snapshotRepository(url: uri(MAVEN_SNAPSHOT_URL)) { authentication(username: MAVEN_USERname, password: MAVEN_USERname) } // 发布仓库路径 repository(url: uri(MAVEN_RELEASE_URL)) { authentication(username: MAVEN_USERname, password: MAVEN_USERname) } println("###################################" + "\nuploadArchives = " + pom.groupID + ":" + pom.artifactID + ":" + pom.version + "." + pom.packaging + "\nrepository =" + (isSnapshot ? MAVEN_SNAPSHOT_URL : MAVEN_RELEASE_URL) + "\n###################################" ) } }}这段脚本会读取 MAVEN_IS_SNAPSHOT 配置参数，如果为 true，会在版本号后追加 -SNAPSHOT 后缀，表示快照版本。随后声明了两个仓库：repository(…) 声明的是 Release 仓库地址，而 snapshotRepository(…) 声明的是快照仓库地址。Maven 会自动将版本号带 -SNAPSHOT 后缀的组件发布到 snapshotRepository(…) 仓库中，这样就 自动将正式版本和快照版本分发的不同仓库中。
当然了，不用 snapshotRepository(…) 也有办法实现：
def url = isSnapShot ? MAVEN_SNAPSHOT_URL : MAVEN_RELEASE_URLrepository(url: url) { authentication(username: MAVEN_USERname, password: MAVEN_USERname)}项目级 gradle.propertIEs
MAVEN_SNAPSHOT_URL = /Users/pengxurui/workspace/public/DemoHall/snapshotRepositoryMAVEN_RELEASE_URL = /Users/pengxurui/workspace/public/DemoHall/releaseRepositoryMAVEN_USERname = MAVEN_PASSWORD = MAVEN_IS_SNAPSHOT = trueMAVEN_GROUP_ID = com.pengxr.demo...| 参数 | 描述 |
|---|---|
| MAVEN_SNAPSHOT_URL | 快照仓库地址 |
| MAVEN_RELEASE_URL | 发布仓库地址 |
| MAVEN_USERname | 仓库账号 |
| MAVEN_PASSWORD | 仓库密码 |
| MAVEN_IS_SNAPSHOT | 是否快照版本 |
| MAVEN_GROUP_ID | 组织 / 公司的名称 |
| MAVEN_ARTIFACTID | 组件的名称（在发布模块配置） |
| MAVEN_VERSION | 组件的版本（在发布模块配置） |
模块级 build.gradle
apply from: '../maven.gradle'...模块级 gradle.propertIEs
MAVEN_ARTIFACTID = mavenMAVEN_VERSION = v1.0.0MAVEN_IS_SNAPSHOT = true...完成以上步骤并 Sync 后，就可以在 Gradle 窗口中该模块下找到 uploadArchives 任务，执行发布：
输出：Executing tasks: [uploadArchives] in project /Users/pengxurui/workspace/public/DemoHall/MavenPublish/lib> Configure project :lib###################################uploadArchives = com.pengxr.demo:maven:v1.0.0-SNAPSHOT.jarrepository =/Users/pengxurui/workspace/public/DemoHall/snapshotRepository###################################> Task :lib:preBuild UP-TO-DATE...项目级 build.gradle
allprojects { repositorIEs { maven { url MAVEN_RELEASE_URL } maven { url MAVEN_SNAPSHOT_URL } ... }}模块级 build.gradle
dependencIEs { implementation "com.pengxr.demo:maven:v1.0.0+"}其中，版本号 v1.0.0+ 中的 “+” 号表示依赖最大的版本号，优先正式版本。比如远程仓库中存在 v1.0.0，v1.0.0.1，v1.0.0.1-SNAPSHOT 三个类库，那么 v1.0.0+ 依赖的是其 v1.0.0.1。
+ 号和 -SNAPSHOT 的区别？
号影响类库版本的选择，而 -SNAPSHOT 影响是否向远程仓库更新最新版本。
完整代码和演示工程你可以直接下载查看： MavenPublish 下载路径。Demo 里配置的仓库都为本地仓库，在实际项目中，你需要替换为你公司内的私有仓库。
4.2 引用本地 aar 包有时候，我们直接依赖第三方或第二方提供的 aar 文件。例如：
- aarlib \ libs - lib-deBUG-aar - build.gradle // API(name: 'lib-deBUG', ext: 'aar')输出：Unable to resolve dependency for ':aarlib@deBUGUnitTest/compileClasspath': Could not resolve :lib-deBUG.但是，这样并不能成功依赖。你需要 build.gradle 文件中声明 aar 的 Flat Directory 仓库地址。你可以放在 androID{} 节点内，或者直接放在根节点，效果是一样的。例如：
aarlib 模块 build.gradle
dependencIEs { ... API(name: 'lib-deBUG', ext: 'aar')}repositorIEs { flatDir { dirs "libs" }}现在你就可以成功依赖了。但如果存在另一个依赖 aarlib 的模块，而这个模块又需要依赖 lib-deBUG.aar，还是会出依赖不到的问题：
- app - build.gradle // implementation project(':aarlib')|- aarlib \ libs - lib-deBUG-aar - build.gradle // API(name: 'lib-deBUG', ext: 'aar')此时，你同样需要在 app 模块里声明 aar 的 Flat Directory 仓库地址。
app 模块 build.gradle
dependencIEs { ... implementation project(':aarlib')}repositorIEs { flatDir { dirs project(':aarlib').file('libs') }}如果项目组件结构比较简单，第 4.2 节的方法就足够应对本地引用 aar 的问题。否则还是会遇到一些麻烦的，你需要在每个模块的 build.gradle 中都声明 repositorIEs.flatDir{}，有办法优化吗？
方法 1：直接依赖改为间接依赖： 新建模块封装 aar，对外部提供外观 API
方法 2：统一将 aar 文件放置在一个文件夹，并在项目级 build.gradle 中声明仓库地址：
项目级 build.gradle
allprojects { repositorIEs { Google() mavenCentral() flatDir { dirs project(':aarlib').file('libs') } // 文件夹要放在某个 module 内 }}模块级 build.gradle
API(name: 'lib-deBUG', ext: 'aar') // 允许间接依赖 aarimplementation(name: 'lib-deBUG', ext: 'aar') // 不允许间接依赖 aar- aarpacker \ libs - lib.aar - lib2.aar - build.gradleaarpacker build.gradle
apply plugin: 'maven-publish'def libPath = project.getProjectDir().getabsolutePath()publishing { publications { lib1(MavenPublication) { groupID MAVEN_GROUP_ID artifactID "lib" version "v1.0.0" artifact(libPath + "/libs/lib.aar") } lib2(MavenPublication) { groupID MAVEN_GROUP_ID artifactID "lib2" version "v1.0.0" artifact(libPath + "/libs/lib2.aar") } } repositorIEs { maven { // 发布仓库路径 url MAVEN_RELEASE_URL // 本地仓库地址不适用账号密码 // > Failed to publish publication 'maven' to repository 'maven' // > Authentication scheme 'all'(Authentication) is not supported by protocol 'file' // credentials(PasswordCredentials) { // username = MAVEN_USERname // password = MAVEN_PASSWORD // } } }}增加开关字段：
dependencIEs { implementation filetree(dir: 'libs', include: ['*.jar']) if (useLocallib.toBoolean()) implementation project(":lib") else implementation 'com.pengxr.demo:maven:v1.0.0+'}以上是内存溢出为你收集整理的Android工程化实践：组件化发布全部内容，希望文章能够帮你解决Android工程化实践：组件化发布所遇到的程序开发问题。
如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。
欢迎分享，转载请注明来源：内存溢出
微信扫一扫
支付宝扫一扫
评论列表（0条）