使用jitpack发布开源库

827 阅读2分钟

众所周知jcenter仓库在今年的5月份已经停止服务,而到了22年2月则将彻底无法访问,所以眼下要考虑其他替代方案,笔者选择的是jitpack,因为其配置较为简单,下面就操作步骤,做下简单记录。

配置gradle

打开你要发布的模块的build.gradle文件,添加如下配置

官方文档

1.添加Maven Publish插件

plugins {
    ...
    id 'maven-publish'
}

2.配置Maven Publish插件

android {...}
dependencies {...}
afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                from components.release
                groupId = 'com.u2tzjtne'//你要发布的库的组ID  建议使用包名
                artifactId = 'expandabletextview'//你要发布的库的名字
                version = '1.0'//库的版本 可以在外部定义一个变量,保持整个配置文件中的版本一致性
            }
        }
    }
}

3.验证配置

上述配置完成后,sync一下配置文件,这时在Android studio的gradle面板中会自动生成一组publishing相关的任务,如下图:

image.png

我们双击publishReleasePublicationToMavenLocal这个任务,等待任务执行结束,如果没有报错则证明我们的配置没有问题,否则需要检查配置文件是否正确

创建release版本

上述配置完成后,push到你的github上面,然后点击下图所示的位置:

image.png

填入相应的信息点击下方的Publish release即可

image.png

发布到jitpack

打开jitpack官网,用你的github账号登陆后,在输入框中输入你的项目地址后,点击look up:

image.png

这个时候jitpack会自动构建项目,等待执行结束后,看下status那一栏,如果显示Get it 则代表编译通过了,否则如果显示Report则代表构建中发生了异常,这时点击对应的log文件,查看具体的报错信息,进行修改即可。

常见的报错:

AGP版本过高

image.png

目前jitpack依旧采用的java1.8进行编译,所以当你的AGP版本过高时(AGP7.0要求最低java11),就会出现这个错误,这时更改你的AGP版本即可

README文件编写

添加jitpack标识,比如:

[![](https://jitpack.io/v/xxx/xxx.svg)](https://jitpack.io/#xxx/xxx)

加入你的库的依赖配置,例如:

在你项目的build.gradle文件中添加jitpack的仓库

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

然后在你要使用的模块中添加如下依赖:

dependencies {
    implementation 'com.github.xxx:xxx:1.0'
}