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

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: 你会在 JitPack 上创建依赖库吗?

为什么写

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

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

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

因为我之前就在 JitPack 上创建过依赖,有点经验,所以选择这个,至于JCenter ,可能大家也知道,直接看官网吧:

20210402100249952.png

懂了吧。。。

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

流程

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

创建 Android Library

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

上传到 Github

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

这里就假设你有 Github 了,然后在 as 中登录一下,按照图片下面的操作直接添加你的账号就行了:

20210402100331975.png

添加完了之后按照下面图片中那样点击:

20210402100404136.png

点击完之后会弹出下面的对话框:

20210402100426481.png

注意不要勾选 Private ,勾选了的话你上传的就成了私有的了。

打 Release 包

上传成功之后打开 Github 网页点击下面图片中箭头所指的地方开始打包:

20210402100449349.png

点击完之后按照下面的格式填写信息:

20210402100509728.png

第一个框是版本号,第二个框是标题,第三个框是描述,根据个人情况填写就行,填写完之后点击绿色按钮进行发布就行了。

JitPack 发布

这里就很简单了,打开 JitPack 官网:https://jitpack.io/

20210402100540703.png

这块有两个选择,通过右上角登录你的 Github 账号或者在搜索框搜索你刚才上传库的地址,都可以,自己选择,选择之后点击 Look up 会出现如下:

20210402100601240.png

点击 Get it 静静等待即可。

使用依赖

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

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

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

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

其实这块网页中都写的有:

20210402100637718.png

问题

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

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

AndroidMavenPlugin 的问题

为什么说不对呢?如果你现在按照上面的流程走的话,在 JitPack 发布那一块你肯定会失败,就是 Get it 失败,就像下面这样:20210402100706816.png

错了不要紧,看看日志错在哪了,点击那个小书的标签,进入日志,发现报错信息如下:

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 ,发现人家这个库已经废弃了。。。

20210402100730921.png

上面废弃库指向的是安卓官方文档。。。这又是什么鬼。。。也没人告诉我啊!!!

过程有多艰难这里就不进行描述了,在下面我会简单说下。经过一番搜索,发现。。。发现我就是个憨批。。。使用 JitPack 不跟着人家官方文档来,跟什么别人的博客?其实大家以后也是,能看官方文档就别看三方写的东西,出错了都不知道为啥。。。来看下吧:

官方文档中清清楚楚、明明白白地写着需要配置Gradle插件我不配置偏偏要去百度上面出现的错误!!!真的是。。。憨批!

来吧,看下安卓的文档吧:https://developer.android.com/studio/build/maven-publish-plugin

20210402100820707.png

详细内容大家去官网看吧,这里直接写下解决问题的代码吧:

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,果然,找到了这个问题:

20210402100857236.png

上面的图片中有个 JitPack 的帮助文档,点击打开:

20210402100921250.png

但之前其实还有个疑问,我在代码中国呢已经设置了 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 识别不出来?还是别的什么问题?然后改来改去改了几十遍。。。为什么我知道是几十遍呢?下面是我的提交记录:

20210402100945502.png

这只是其中一部分,下面是我 Github 的一部分提交记录:

20210402101012388.png

看到上面的提交记录,你就应该能明白当时我的无助。。。。

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

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

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


相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
目录
相关文章
|
3月前
|
Ubuntu 持续交付 API
如何使用 dotnet pack 打包 .NET 跨平台程序集?
`dotnet pack` 是 .NET Core 的 NuGet 包打包工具,用于将代码打包成 NuGet 包。通过命令 `dotnet pack` 可生成 `.nupkg` 文件。使用 `--include-symbols` 和 `--include-source` 选项可分别创建包含调试符号和源文件的包。默认情况下,`dotnet pack` 会先构建项目,可通过 `--no-build` 跳过构建。此外,还可以使用 `--output` 指定输出目录、`-c` 设置配置等。示例展示了创建类库项目并打包的过程。更多详情及命令选项,请参考官方文档。
249 11
|
7月前
|
SQL 前端开发 Java
编译JSqlParser4.6-4.7最新源代码
编译JSqlParser4.6-4.7最新源代码
182 0
|
6月前
gRPC编译时,请注意使用make clean 清理后再重复编译
gRPC编译时,请注意使用make clean 清理后再重复编译
53 0
|
7月前
|
XML 移动开发 前端开发
C#HtmlAgilityPack类库再回顾
C#HtmlAgilityPack类库再回顾
68 0
JitPack让第三方依赖更简单(第二种方法)
JitPack让第三方依赖更简单(第二种方法)
|
开发工具 Android开发 git
JitPack让第三方依赖更简单(第一种方法)
JitPack让第三方依赖更简单(第一种方法)
|
存储 Linux 计算机视觉
CMake库打包以及支持find_package(二)
CMake库打包以及支持find_package(二)
315 0
|
测试技术 Linux
CMake库打包以及支持find_package(一)
CMake库打包以及支持find_package(一)
232 0
|
API 开发工具 Android开发
Android 发布开源库到 JitPack (详细步骤)
Android 发布开源库到 JitPack (详细步骤)
467 0
Android 发布开源库到 JitPack (详细步骤)
|
IDE Java API
小知识 - Gradle7.0之后JitPack发布组件需要注意的几个问题
最近在使用 JitPack 发布组件时候,遇到了这几个问题,着实找了好一会才解决,分享一下。🙃
718 0