摘要：我曾经在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依赖上传！
