前言
当你辛辛苦苦在 github 上写了一个库, 却会发现, 调用起来太麻烦了, 如果可以像这样:
implementation 'com.github.thiagooo0:GoogleMapView:v1.1.0'
一句话的依赖就能调用自己的库, 不说便捷性, 那成就感也是满满的.
为什么要用 jitpack
便捷, 快速. github 上的库, 只需要几分钟就可以发布出去. 当然, 我自己搞了大半天.. 所以希望我的经验可以帮到大家.
(嗯, bintray 我也搞了大半天, 最后还死活上传不上去, 气死了.)
使用方法
官方教程, 最为牛逼 https://jitpack.io/docs/ANDROID/
在 github 上传你的项目
这个应该不用过多叙述了, 新建一个项目, 然后上次到 github 即可.
配置
配置根目录的 build.gradle
- buildscript {
- dependencies {
- classpath 'com.github.dcendents:android-maven-gradle-plugin:2.0'
在想要做成库的 module 的 build.gradle 中添加
- apply plugin: 'com.github.dcendents.android-maven'
- group='com.github.YourUsername'
把 YourUsername 改成你自己 github 的用户名即可 (我没有加 group 这一句好像也没有啥问题)
检查
jitpack 不同于其他库, 并不是上传 aar 文件或者 jar 文件, 而且直接从你的 github 拉取代码在线编译. 为了避免我们不断的在线编译错误, 我们可以在根目录下执行指令:
gradlew install
如果显示 BUILD SUCCESSFUL, 那就恭喜你成功了. 上传代码吧.
发布版本
在 github 中打开你项目的首页, 根据如下路径:
releases -> Draft a new release
发布一个新版本.
jitpack 发布
打开 jitpack 的网站 https://jitpack.io/ , 用你的 github 账号登录, 你就会看到左边的列表中, 有你 github 上的所有项目, 选择你要发布的项目, 选择版本, 点击发布. 等到 log 对应的图标变绿, 那就成功啦.
如果 log 的图标是红的, 那就点进去看下 log, 根据错误修改下代码吧. 如果你用 gradlew install 命令检查过还报错的话, 那就是 github 中的文件不全, 比如我漏了上传 gradlew 文件, 导致了 gradle version 不对的问题.
使用你的库
在你想要使用的项目的根目录 build.gradle 中添加
- allprojects {
- repositories {
- ...
- maven { url 'https://jitpack.io' }
- }
- }
添加依赖
- dependencies {
- implementation 'com.github.User:Repo:Tag'
- }
其实在官网 https://jitpack.io/ , 对具体的项目版本点击发布后, 你就能看到下面有 how to 的教程了.
或者对照下我这个项目 https://github.com/thiagooo0/GoogleMapView .
好, 我这次的分享就告一段落了, 大家有什么意见可以留言哦.
来源: http://www.jianshu.com/p/ad6d8cfb4258