摘要:我曾经在JCenter上面发布了一个GitHub开源项目,其过程怎一个复杂了得?在我想发布第二个项目到JCenter时,由于Java各类注释写得差强人意(还是建议规范自己的代码,即为自己,亦为乘凉者),导致无法生成依赖jar包,而且修改起来又十分麻烦,索性就改到JitPack仓库了,这过程又怎一个简洁了得?!请听我娓娓道来。
JitPack是什么
Easy to use package repository for GitPublish your JVM and Android libraries.
1.准备工作
1.注册GitHub账户(过程省略若干字)
2.在JitPack上使用GitHub账户进行登录
3.创建包含一个要发布的Library Module的Android Studio项目
2.项目配置
在项目的build.gradle中添加配置
buildscript {
dependencies {
classpath 'com.android.tools.build:gradle:3.1.4' // 认准这行,有gradle插件版本的这个地方,对,就是这行
classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1' // 添加本行,这个版本与gradle版本有关
}
在Library Module的build.gradle添加配置
apply plugin: 'com.android.library' // 认准这行
apply plugin: 'com.github.dcendents.android-maven' // 添加本行
group='com.github.YourGitHubUserName' // 添加本行
【注】添加以下配置,否则上传后的jar包看不到注释
// 指定编码
tasks.withType(JavaCompile) {
options.encoding = "UTF-8"
}
// 打包源码
task sourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs
classifier = 'sources'
}
task javadoc(type: Javadoc) {
failOnError false
source = android.sourceSets.main.java.sourceFiles
classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
classpath += configurations.compile
}
// 制作文档(Javadoc)
task javadocJar(type: Jar, dependsOn: javadoc) {
classifier = 'javadoc'
from javadoc.destinationDir
}
artifacts {
archives sourcesJar
archives javadocJar
}
3.Android Studio中的Git相关配置
在已安装Git客户端的情况下进行配置:
1.Git在Android Studio中的安装配置
2.GitHub在Android Studio中配置
4.分享项目到GitHub
1.分享项目到GitHub
2.Share Project On GitHub
注:根据实际情况将应该忽略的文件和目录添加到.gitignore文件中,点击【share】按钮
【温馨提示】看到如下:successfully字段,说明项目成功上传到GitHub了(由于我们这里没有选择任何上传文件,所以创建了一个GitHub为我们创建了一个empty repository空仓库Test),现在不妨打开GitHub看一看项目是不是已经上传成功了。
项目上传成功
5.上传项目到GitHub
1.找到release
2.创建一个新的release版本
3.填写release版本相关内容
4.发布成功
6.Library同步到JitPack
打开JitPack并使用GitHub账户登录
查找依赖
1.填写GitHub仓库地址
2.点击【Look up】按钮
3.点击【Get it】按钮
7.如何使用依赖
1.在项目的build.gradle中添加如下仓库配置:
allprojects {
repositories {
// 其他仓库配置
maven { url 'https://jitpack.io' }
}
}
2.在想使用依赖的Module中添加依赖:
dependencies {
// 其他依赖
implementation 'com.github.GitHubUserName:RepositoryName:TagName'
// 上面的例子 implementation 'com.github.chengqian0109:RecyclerViewAdapterHelper:1.0.0'
}
恭喜,至此您已完成JitPack依赖上传!