一文详解 jitpack 多渠道maven库发布

技术分享 3年前 (2023-02-22) 0 999+

先说一下，为什么会有这篇文章？
最初接触 JitPack 时，发现网络上大量涉及JitPack的教程不可用。通过两天的研究才搞明白：
1.不同的gradle版本，gradle api使用方式与 JitPack配置方式均有所差异：使用JitPack发布Maven依赖库，其配置脚本与开发者使用的 gradle 版本是强相关的，因此不同的gradle版本，其API使用方式与 JitPack配置需做对应调整；
2.官方案例不好使：JitPack的官方案例为 multi-flavor-lib-demo ，2018年最后一次更新，其使用的 gradle 版本相对较低，当前的gradle版本无法使用。
以上两点，可能是网络文章质量较低的主要原因，因此这里将我两天来的学习成果分享给朋友们，帮助大家节省一些时间。

Android应用开发过程中，开发者通常通过 gradle dependencies 导入第三方依赖库，那么当开发者的SDK或中间件被其他项目依赖时，该如何发布自己的maven依赖库呢？
这里推荐一个Github的构建工具 https://jitpack.io/ 。

JitPack 简介
JitPack 使用及案例举例
案例源码下载

一、JitPack简介

JitPack 是一个构建与发布 Git 存储库的便捷服务，可用于在 GitHub、GitLab 上打包、发布与部署依赖库，便于使用者通过maven依赖的形式引用开发者发布的依赖库。

JitPack 允许开发者将 GitHub、GitLab上的JVM 和 Android 项目发布到 Jitpack 的 Maven 仓库；
JitPack 通过搜索开发者输入的git仓库链接地址的形式，自动查找Git上的工程代码，并进行自动打包、构建依赖库（对于开发者来说，基本实现了一键发布依赖库）；
JitPack 允许开发者将 Git 存储库（包括存储库的任何一个分支或分支的某一次commit提交）以不同版本的形式进行构建、发布为maven依赖库，便于开发者进行版本发布与维护；
使用价格方面，对于开源项目 JitPack 是完全免费的。

二、JitPack 使用

配置jitpack需采用gradle API编写配置脚本，随着gradle版本的更新，相关API及使用方式也有了一定的变化。
这里分别基于 gradle 6.1 与 gradle 7.5 举例 jitpack 多渠道发布。

gradle 6.1 配置 JitPack
gradle 7.5 配置 JitPack

2.1 gradle6.1配置JitPack

举例代码中使用的 gradle版本与插件版本如下：
gradle版本： https://services.gradle.org/distributions/gradle-6.1.1-all.zip
插件版本：com.android.tools.build:gradle:3.6.1

举例代码中 jitpack 编译结果：
https://javadoc.jitpack.io/com/github/AndroidAppCodeDemo/jitpack_MultiFlavorLibDemo/gradle_6_1-SNAPSHOT/

下边通过以下两个方面进行详细说明：

gradle 6.1 使用 jitpack 进行多渠道 Maven 依赖库发布详细举例说明；
如何引用 jitpack Maven发布的多渠道依赖库？

2.1.1 jitpack多渠道配置

gradle 6.1 使用 jitpack 进行多渠道 Maven 依赖库发布详细举例说明：
假定要发布的库其渠道配置信息如下：

// 渠道举例 flavorDimensions "vendor" productFlavors { 	production { 		dimension "vendor" 		buildConfigField 'String', 'ENV', '"PRODUCTION"' 	} 	sandbox { 		dimension "vendor" 		buildConfigField 'String', 'ENV', '"SANDBOX"' 	} }

首先，需添加 android-maven-gradle-plugin插件：
在Android工程根目录build.gradle中，添加 android-maven-gradle-plugin插件。

buildscript {     dependencies {         // 1、添加 android-maven-gradle-plugin         classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'     } }

添加 发布渠道包配置：
按照如下代码举例，在对应Module工程build.gradle中添加如下4步配置：

// 2、应用插件 apply plugin: 'com.github.dcendents.android-maven' android { 	// ...     // 3、默认发布渠道     defaultPublishConfig "productionRelease"     // 4、true to publish all flavour artifacts     publishNonDefault true } // 5、添加“发布多渠道依赖包配置” if (android.productFlavors.size() > 0) {     android.libraryVariants.all { variant ->         if (variant.name.toLowerCase().contains("debug")) {             return         }         def bundleTask = tasks["bundle${variant.name.capitalize()}Aar"]         artifacts {             archives(bundleTask.archivePath) {                 classifier variant.flavorName                 builtBy bundleTask                 name = project.name             }         }     } }

以上的5个步骤参考了 jitpack-io官方 multi-flavor-lib-demo 样例工程

2.1.2 引用 jitpack 发布的多渠道依赖库

在上一步中，我们顺利发布了 maven 依赖库，这里记录一下如何使用我们发布的依赖库？

在Android工程根目录build.gradle添加 jitpack 仓库地址：

allprojects { 	repositories { 		// 1、添加 jitpack 仓库地址 		maven { url 'https://jitpack.io' } 	} }

在对应Android工程引用依赖包的Module中添加如下依赖：

dependencies { 	// 2、添加库文件依赖： 	// implementation "com.github.<USER>.<REPO>:<library-module>:<version>:<flavor-name>@aar" 	// production 渠道    	implementation 'com.github.AndroidAppCodeDemo:jitpack_MultiFlavorLibDemo:gradle_6_1-SNAPSHOT:production@aar'   	// sandbox 渠道    	implementation 'com.github.AndroidAppCodeDemo:jitpack_MultiFlavorLibDemo:gradle_6_1-SNAPSHOT:sandbox@aar'  }

2.2 gradle7.5配置JitPack

举例代码中使用的 gradle版本与插件版本如下：
gradle版本： https://services.gradle.org/distributions/gradle-7.5-bin.zip
插件版本：com.android.tools.build:gradle:7.4.1

举例代码中 jitpack 编译结果：
https://javadoc.jitpack.io/com/github/AndroidAppCodeDemo/jitpack_MultiFlavorLibDemo/gradle_7_5-SNAPSHOT/

下边通过以下两个方面进行详细说明：

gradle 7.5 使用 jitpack 进行多渠道 Maven 依赖库发布详细举例说明；
如何引用 jitpack Maven发布的多渠道依赖库？

2.2.1 jitpack多渠道配置

gradle 7.5 使用 jitpack 进行多渠道 Maven 依赖库发布详细举例说明（假定仍采用上一步案例中的渠道配置信息）：

应用 maven-publis 插件：
根据 android developer:Maven Publish 中介绍，Android gradle 插件3.6以上版本可以应用 Maven Publish插件：

因此，在对应工程要发布的依赖Module中添加如下配置：

要发布的依赖Module添加如下配置

plugins { 	// 1、添加 maven-publish     id 'maven-publish' }

添加 发布渠道包配置：
发布渠道依赖包的配置信息，主要是参考Android Developer Gradle-API-7.1 LibraryPublishing：

在对应工程要发布的依赖Module中添加如下配置：

要发布的依赖Module添加如下配置

android {     // 2、默认渠道     defaultPublishConfig "productionRelease"     // 3、发布渠道配置     publishing {         // Publishes all build variants with "vendor" component         multipleVariants("vendor") {         	// 只发布release包             includeBuildTypeValues("release")             includeFlavorDimensionAndValues("vendor", "production","sandbox")         }     } }  // 4、依赖包发布配置信息 afterEvaluate {     publishing {         publications {             allVariants(MavenPublication) {                 // 发布后的依赖包按如下配置进行引用：com.github.AndroidAppCodeDemo:jitpack_MultiFlavorLibDemo:1.0.2                 from components.vendor // 表示发布 release                 groupId = 'com.github.AndroidAppCodeDemo' // 这个是依赖库的组 id                 artifactId = 'jitpack_MultiFlavorLibDemo' // 依赖库的名称                 version = "1.0.2"     // 当前版本依赖库版本号             }         }         repositories {             maven {                 def baseUrl = buildDir.getParent()                 def releasesRepoUrl = "$baseUrl/repos/releases"                 def snapshotsRepoUrl = "$baseUrl/repos/snapshots"                 url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl             }         }     } } // 5、生成source jar task generateSourcesJar(type: Jar) {     from android.sourceSets.main.java.srcDirs     classifier 'sources' }

2.2.2 引用 jitpack 发布的多渠道依赖库

在上一步中，我们顺利发布了 maven 依赖库，这里记录一下如何使用我们发布的依赖库？

在Android工程根目录build.gradle添加 jitpack 仓库地址：

allprojects { 	repositories { 		// 1、添加 jitpack 仓库地址 		maven { url 'https://jitpack.io' } 	} }

在对应Android工程引用依赖包的Module中添加如下依赖：

dependencies { 	// 2、添加库文件依赖： 	// implementation "com.github.<USER>.<REPO>:<library-module>:<version>:<flavor-name>@aar" 	// production 渠道    	implementation 'com.github.AndroidAppCodeDemo:jitpack_MultiFlavorLibDemo:gradle_7_5-SNAPSHOT:production@aar'   	// sandbox 渠道    	implementation 'com.github.AndroidAppCodeDemo:jitpack_MultiFlavorLibDemo:gradle_7_5-SNAPSHOT:sandbox@aar'  }