为什么写
看见标题有人可能会轻蔑一笑,多简单个事?还至于专门写一篇文章吗?
我之前也以为挺简单的,因为之前自己也上传过,但是前几天的经历告诉我没有那么简单,特别是现在安卓 Gradle 升级到 7.0 之后。。。
还可能有人问为什么要在 JitPack 上创建呢?JCenter 、Maven 不香嘛?
因为我之前就在 JitPack 上创建过依赖,有点经验,所以选择这个,至于JCenter ,可能大家也知道,直接看官网吧:
懂了吧。。。
为啥没选 Maven 呢。。。因为我没想到 JitPack 变得这么麻烦,本来是奔着简单才选的,如果再给我一次机会我一定不上传 JitPack 了。。。好了,废话不多说,直接进入文章主题吧:
流程
上传依赖到 JitPack 流程很简单,网上搜博客一搜一大堆,这里就不详细说了,我简单过一下吧:
创建 Android Library
首先要创建一个 Android Library ,这其实是废话,你要上传的就是依赖不创建 Android Library 创建啥?对不。。。然后在里面写好你需要作为依赖的代码,比如写一些工具类啊啥的,这个看自己的需要吧,就不做演示了。。。
上传到 Github
代码写完了就该上传到 Github 了。什么?你没有 Github 仓库?码云的也可以。什么?都没有?玩蛋去。。
这里就假设你有 Github 了,然后在 as 中登录一下,按照图片下面的操作直接添加你的账号就行了:
添加完了之后按照下面图片中那样点击:
点击完之后会弹出下面的对话框:
注意不要勾选 Private ,勾选了的话你上传的就成了私有的了。
打 Release 包
上传成功之后打开 Github 网页点击下面图片中箭头所指的地方开始打包:
点击完之后按照下面的格式填写信息:
第一个框是版本号,第二个框是标题,第三个框是描述,根据个人情况填写就行,填写完之后点击绿色按钮进行发布就行了。
JitPack 发布
这里就很简单了,打开 JitPack 官网:https://jitpack.io/
这块有两个选择,通过右上角登录你的 Github 账号或者在搜索框搜索你刚才上传库的地址,都可以,自己选择,选择之后点击 Look up 会出现如下:
点击 Get it 静静等待即可。
使用依赖
上面完成之后直接就可以使用了,现在工程级目录下的 build.gradle 中添加如下代码:
allprojects { repositories { ... maven { url 'https://jitpack.io' } } }
然后在你的 module 级目录下的 build.gradle 中添加如下代码:
dependencies { implementation 'com.github.zhujiang521:Banner:Tag' }
其实这块网页中都写的有:
问题
本来不想写上面这一堆,但是感觉不写也不对,大家理解起来可能有困难,所以就写了下。
如果是在去年,上面的一套流程完全没有问题,但是在现在,上面的流程。。。不对。
AndroidMavenPlugin 的问题
为什么说不对呢?如果你现在按照上面的流程走的话,在 JitPack 发布那一块你肯定会失败,就是 Get it 失败,就像下面这样:
错了不要紧,看看日志错在哪了,点击那个小书的标签,进入日志,发现报错信息如下:
FAILURE: Build failed with an exception. * Where: Script '/script/maven-plugin.gradle' line: 2 * What went wrong: A problem occurred evaluating script. > Failed to apply plugin 'com.github.dcendents.android-maven'. > Could not create plugin of type 'AndroidMavenPlugin'. > Could not generate a decorated class for type AndroidMavenPlugin. > org/gradle/api/publication/maven/internal/MavenPomMetaInfoProvider
呃呃,这是啥?AndroidMavenPlugin ?Google 了之后才知道 JitPack 使用的就是 AndroidMavenPlugin 来发布依赖的,OK,既然这个东西有问题,那就来看看怎么加上吧:
classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1'
OK,再次提交代码,打 release 包,然后去 JiaPack 网站点 Get it ,发现依然报这个错。。。
什么鬼。。。
又去 Github 搜索了下 android-maven-gradle-plugin ,发现人家这个库已经废弃了。。。
上面废弃库指向的是安卓官方文档。。。这又是什么鬼。。。也没人告诉我啊!!!
过程有多艰难这里就不进行描述了,在下面我会简单说下。经过一番搜索,发现。。。发现我就是个憨批。。。使用 JitPack 不跟着人家官方文档来,跟什么别人的博客?其实大家以后也是,能看官方文档就别看三方写的东西,出错了都不知道为啥。。。来看下吧:
官方文档中清清楚楚、明明白白地写着需要配置Gradle插件我不配置偏偏要去百度上面出现的错误!!!真的是。。。憨批!
来吧,看下安卓的文档吧:https://developer.android.com/studio/build/maven-publish-plugin
详细内容大家去官网看吧,这里直接写下解决问题的代码吧:
plugins { id 'com.android.library' id 'kotlin-android' id 'maven-publish' } afterEvaluate { publishing { publications { release(MavenPublication) { from components.release groupId = 'com.zj.banner' artifactId = 'banner' version = '1.0.0' } } } }
OK,提交代码,打 release 包,然后再去 JiaPack 网站点 Get it ,大部分人应该就可以成功了,但是。。。我的还是不行的。。。
Java 11 的问题
为啥还是不行呢?不要紧,看看日志错在哪了,点击那个小书的标签,进入日志,发现报错信息如下:
FAILURE: Build failed with an exception. * Where: Build file '/home/jitpack/build/app/build.gradle' line: 2 * What went wrong: An exception occurred applying plugin request [id: 'com.android.application'] > Failed to apply plugin 'com.android.internal.application'. > Android Gradle plugin requires Java 11 to run. You are currently using Java 1.8. You can try some of the following options: - changing the IDE settings. - changing the JAVA_HOME environment variable. - changing `org.gradle.java.home` in `gradle.properties`.
嗯。。。这是什么情况?
其实上面也提到过,Android Gradle 在升级到 7.0 之后就必须使用 Java 11 以及之后的版本才可以,而我目前使用的是 Java 1.8。
嗯,既然需要 Java 11 那就升级下,改下 module 级 build.gradle 中的代码:
android { ... compileOptions { sourceCompatibility = JavaVersion.VERSION_11 targetCompatibility = JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = '11' useIR = true } }
大家要注意,每次修改完代码都需要先把代码 push 到 Github 中,然后重新按照上面的步骤打一个 release 包,再去 JitPack 网页中点击你打的包的那个版本的 Git it 才行。
提交完了之后执行,发现。。。竟然还在报错,报的还是这个错!这是什么玩意?
其实我在这块卡了很久,一直以为是我本地的代码问题,但后来想明白应该是 JitPack 的问题,因为本地运行是没有任何问题的。
想清楚这一点,我来到了 JitPack 的 Github 仓库,点开了仓库的 Issues ,直接搜索 Java 11,果然,找到了这个问题:
上面的图片中有个 JitPack 的帮助文档,点击打开:
但之前其实还有个疑问,我在代码中国呢已经设置了 Java 的版本,为什么还是报错呢?看上面的图片大家应该也已经知道了,JitPack 默认使用的是 OpenJDK Java 8 编译项目,但是咱们需要 Java 11 ,你必须按照上面那样在根目录添加一个 jitpack.yml 文件才可以,OK,那就添加吧:
before_install: - sdk install java 11.0.10-open - sdk use java 11.0.10-open jdk: - openjdk11
再次提交代码,打 release 包,然后去 JiaPack 网站点 Get it ,发现依然报这个错。。。
我的天,我当时真的不知道该怎么搞,以为我 jitpack.yml 这个文件格式写的有问题 JitPack 识别不出来?还是别的什么问题?然后改来改去改了几十遍。。。为什么我知道是几十遍呢?下面是我的提交记录:
这只是其中一部分,下面是我 Github 的一部分提交记录:
看到上面的提交记录,你就应该能明白当时我的无助。。。。
索性不管了,明天再说吧。。。
然而,奇怪的事情发生了,第二天我再次使用相同版本进行 Get it 的时候,虽然还是失败,但是问题竟然变了!!!什么鬼?看下日志:
Kotlin: 1.4.31 Groovy: 3.0.7 Ant: Apache Ant(TM) version 1.10.9 compiled on September 27 2020 JVM: 11.0.2 (Oracle Corporation 11.0.2+9) OS: Linux 4.14.63-xxxx-std-ipv6-64 amd64
通过日志可以看到 Java 已经设置为了 11 ,我的天,昨天搞了一天这玩意没成功,其实已经成功了,我估计是 JitPack 中有缓存。。。害死我了。。。
OK,再次提交代码,打 release 包,然后去 JiaPack 网站点 Get it ,然后就是漫长的等待。。。
终于, Git it 按钮变为了绿色,成功了。。。
总结
没什么好总结的,因为感觉自己脑子不够用,遇到问题首先想到的一直是复制错误去百度、去 Google ,从来没想着去最权威的东西——官方文档,老想着别人可能也遇到过这个问题,直接去拿现成的,这是个不好的习惯,得改。
希望大家能以此为戒,努力,共勉。