你会在 JitPack 上创建依赖库吗？

系统管理员 2022-11-15 14:29 481阅读 0赞

## 为什么写 ##

看见标题有人可能会轻蔑一笑，多简单个事？还至于专门写一篇文章吗？

我之前也以为挺简单的，因为之前自己也上传过，但是前几天的经历告诉我没有那么简单，特别是现在安卓 `Gradle` 升级到 7.0 之后。。。

还可能有人问为什么要在 `JitPack` 上创建呢？`JCenter` 、`Maven` 不香嘛？

因为我之前就在 `JitPack` 上创建过依赖，有点经验，所以选择这个，至于`JCenter` ，可能大家也知道，直接看官网吧：  
![JCenter][]  
懂了吧。。。

为啥没选 `Maven` 呢。。。因为我没想到 `JitPack` 变得这么麻烦，本来是奔着简单才选的，如果再给我一次机会我一定不上传 `JitPack` 了。。。好了，废话不多说，直接进入文章主题吧：

## 流程 ##

上传依赖到 `JitPack` 流程很简单，网上搜博客一搜一大堆，这里就不详细说了，我简单过一下吧：

### 创建 `Android Library` ###

首先要创建一个 `Android Library` ，这其实是废话，你要上传的就是依赖不创建 `Android Library` 创建啥？对不。。。然后在里面写好你需要作为依赖的代码，比如写一些工具类啊啥的，这个看自己的需要吧，就不做演示了。。。

### 上传到 `Github` ###

代码写完了就该上传到 `Github` 了。什么？你没有 `Github` 仓库？码云的也可以。什么？都没有？玩蛋去。。

这里就假设你有 `Github` 了，然后在 as 中登录一下，按照图片下面的操作直接添加你的账号就行了：  
![as github][]  
添加完了之后按照下面图片中那样点击：  
![share github][]  
点击完之后会弹出下面的对话框：  
![share][]  
注意不要勾选 `Private` ，勾选了的话你上传的就成了私有的了。

### 打 `Release` 包 ###

上传成功之后打开 `Github` 网页点击下面图片中箭头所指的地方开始打包：  
![github][]  
点击完之后按照下面的格式填写信息：  
![release][]  
第一个框是版本号，第二个框是标题，第三个框是描述，根据个人情况填写就行，填写完之后点击绿色按钮进行发布就行了。

### JitPack 发布 ###

这里就很简单了，打开 `JitPack` 官网：[https://jitpack.io/][https_jitpack.io]  
![jitpack][]  
这块有两个选择，通过右上角登录你的 `Github` 账号或者在搜索框搜索你刚才上传库的地址，都可以，自己选择，选择之后点击 `Look up` 会出现如下：  
![get it][]  
点击 `Get it` 静静等待即可。

### 使用依赖 ###

上面完成之后直接就可以使用了，现在工程级目录下的 `build.gradle` 中添加如下代码：

allprojects { 
    		repositories { 
    			...
    			maven {  url 'https://jitpack.io' }
    		}
    	}

然后在你的 `module` 级目录下的 `build.gradle` 中添加如下代码：

dependencies { 
    	        implementation 'com.github.zhujiang521:Banner:Tag'
    	}

其实这块网页中都写的有：  
![white][]

## 问题 ##

本来不想写上面这一堆，但是感觉不写也不对，大家理解起来可能有困难，所以就写了下。

如果是在去年，上面的一套流程完全没有问题，但是在现在，上面的流程。。。不对。

### AndroidMavenPlugin 的问题 ###

为什么说不对呢？如果你现在按照上面的流程走的话，在 `JitPack` 发布那一块你肯定会失败，就是 `Get it` 失败，就像下面这样：  
![error][]  
错了不要紧，看看日志错在哪了，点击那个小书的标签，进入日志，发现报错信息如下：

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][]** ，发现人家这个库已经废弃了。。。  
![abandones][]  
上面废弃库指向的是安卓官方文档。。。这又是什么鬼。。。也没人告诉我啊！！！

过程有多艰难这里就不进行描述了，在下面我会简单说下。经过一番搜索，发现。。。发现我就是个憨批。。。使用 `JitPack` 不跟着人家官方文档来，跟什么别人的博客？其实大家以后也是，能看官方文档就别看三方写的东西，出错了都不知道为啥。。。来看下吧：  
![gradle][]  
官方文档中清清楚楚、明明白白地写着需要配置Gradle插件我不配置偏偏要去百度上面出现的错误！！！真的是。。。憨批！

来吧，看下安卓的文档吧：[https://developer.android.com/studio/build/maven-publish-plugin][https_developer.android.com_studio_build_maven-publish-plugin]  
![develoger][]  
详细内容大家去官网看吧，这里直接写下解决问题的代码吧：

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，果然，找到了这个问题：  
![issues][]  
上面的图片中有个 `JitPack` 的帮助文档，点击打开：  
![java][]  
但之前其实还有个疑问，我在代码中国呢已经设置了 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` 识别不出来？还是别的什么问题？然后改来改去改了几十遍。。。为什么我知道是几十遍呢？下面是我的提交记录：  
![tag][]  
这只是其中一部分，下面是我 `Github` 的一部分提交记录：  
![commit][]  
看到上面的提交记录，你就应该能明白当时我的无助。。。。

索性不管了，明天再说吧。。。

然而，奇怪的事情发生了，第二天我再次使用相同版本进行 `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 ，从来没想着去最权威的东西——官方文档，老想着别人可能也遇到过这个问题，直接去拿现成的，这是个不好的习惯，得改。

希望大家能以此为戒，努力，共勉。

[JCenter]: /images/20221022/1c0c0154d59347478be6b849332dcb85.png
[as github]: https://img-blog.csdnimg.cn/20210402100331975.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[share github]: https://img-blog.csdnimg.cn/20210402100404136.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[share]: https://img-blog.csdnimg.cn/20210402100426481.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[github]: https://img-blog.csdnimg.cn/20210402100449349.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[release]: https://img-blog.csdnimg.cn/20210402100509728.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[https_jitpack.io]: https://jitpack.io/
[jitpack]: https://img-blog.csdnimg.cn/20210402100540703.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[get it]: https://img-blog.csdnimg.cn/20210402100601240.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[white]: https://img-blog.csdnimg.cn/20210402100637718.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[error]: https://img-blog.csdnimg.cn/20210402100706816.png
[android-maven-gradle-plugin]: https://github.com/dcendents/android-maven-gradle-plugin
[abandones]: https://img-blog.csdnimg.cn/20210402100730921.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[gradle]: https://img-blog.csdnimg.cn/20210402100758415.png
[https_developer.android.com_studio_build_maven-publish-plugin]: https://developer.android.com/studio/build/maven-publish-plugin
[develoger]: https://img-blog.csdnimg.cn/20210402100820707.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[issues]: https://img-blog.csdnimg.cn/20210402100857236.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[java]: https://img-blog.csdnimg.cn/20210402100921250.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[tag]: https://img-blog.csdnimg.cn/20210402100945502.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70
[commit]: https://img-blog.csdnimg.cn/20210402101012388.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hhb2ppYWdvdQ==,size_16,color_FFFFFF,t_70