为什么写
看见标题有人可能会轻蔑一笑,多简单个事?还至于专门写一篇文章吗?
我之前也以为挺简单的,因为之前自己也上传过,但是前几天的经历告诉我没有那么简单,特别是现在安卓 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
官网: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插件我不配置偏偏要去百度上面出现的错误!!!真的是。。。憨批!
来吧,看下安卓的文档吧:developer.android.com/studio/buil… 详细内容大家去官网看吧,这里直接写下解决问题的代码吧:
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 ,从来没想着去最权威的东西——官方文档,老想着别人可能也遇到过这个问题,直接去拿现成的,这是个不好的习惯,得改。
希望大家能以此为戒,努力,共勉。