徽章系列2:JitPack 的使用
2017-06-16 本文已影响66人
孤独狂饮
创建 Android Library
- 在 AS 中创建标准的 android 项目:
- 创建 Library:
- 创建 badge library 成功。
配置相关文件
进入 jitpack android 可以看到 jitpack 为我们提供的文档帮助。
- 在项目的根目录下的 build.gradle 文件中添加:
-
在 library 下的 build.gradle 中添加:
, 对应官网中说的 『group='com.github.YourUsername’』, 其实可以不写,写不写都会自动生成。 即使你写成了别的,最终还是以这样的格式输出。
AndroidBadge 中 的 build.gradle :
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5' // Add this line
AndroidBadge 里面的 badge (library) :
apply plugin: 'com.github.dcendents.android-maven'
发布到 Github (这里直接展示 AS 中的界面图形操作,会命令行的同学随意)
- 登录自己的 github 账号,然后创建一个 项目,在首页右边能看到:
-
点击 大绿色 按钮,并填写信息:
。 那个协议,你们随意,这里只是演示。
-
创建成功后:
,拷贝当前项目地址。
- 在 AS 的项目中创建 git 仓库: , 点击后,直接 选择 ok。将项目添加到 git 管理 。 项目中的文件都变成绿色后: ,耐心等待完成后, 本地项目已经被 git 管理起来了,然后把代码提交到 github 即可。可能会有冲突,自行解决即可。
-
现在我们给 library 的 badge 项目添加一个工具类:
, 并提交到 github。
Github 打 release or tag
创建第一个 release 分支:
发布成功以后就能看到:
一般用 release 就可以了, 在适当的时候 用 tag。
在 JitPack 上生成 aar
- 进入 https://jitpack.io/。
- 将 github 的项目地址: https://github.com/gdky005/AndroidBadge, 直接拷贝 到 jitpack 网页中的文本框中。
- 点击 Look Up 后: , 等里面的那个圈圈 转完 以后,出现 绿色的这个: 说明已经发布 aar 成功,那么我们 可以直接使用了。 如果点开这个东西,会看到编译的和发布的过程。
- 如果是红色的,说明有错误,点开查看,修改后重新构建。
在 app Demo 中测试是否生效
点击 get 后,能看到:- 给项目根目录下的 build.gradle 添加:
- 给app 项目里面的 build.gradle 添加:
AndroidBadge 中 的 build.gradle :
maven { url 'https://jitpack.io' }
AndroidBadge 里面的 app 的 build.gradle :
compile 'com.github.gdky005:AndroidBadge:v1.0.0'
好的,现在我们已经添加成功了,在 MainActivity 里面是是吧,看能否调到之前在 library 里面的写的 Utils.getVersion()。很高兴的是我们调出来了:
在项目的最底下也能看到: 。 运行 app 项目:
问题来了,我们修改library 后也能调用到吗?
让咱们一起试试吧:
-
修改 badge 项目中的 1.0.0 为 1.0.1 :
。
- 提交代码后,push 到 github。 提交成功以后,我们重复上面的打 release 步骤 , ,
- 然后再去 jitpack 上看看: 多了一个 v1.0.1, 点击 get 吧。
- 发布成功后,我们去 app 里面试试。
-
同步后,直接运行 app。非常好,我们的修改的东西已经变了:
。
至此, jitpack 基本也差不多了,但是貌似缺少了最重要的一点吧。
jitpack 的徽章怎么弄
还是在刚刚的 jitpack 界面,只是我们把 页面拉倒底部。 点击后: 是不是看到了熟悉的 md 文档的格式呢? 看不懂也没关系,下面会专门讲解。- 拷贝内容:
-
打开 github 的 AndroidBridge 项目:
,点击该文件。
- 让我们在线编辑下:
- 给 github 中的 这个 readme.md 文件添加点东西吧。
- 让我们 保存下。
- 然后回到项目首页看看: 棒棒的,添加成功。
相关链接:
完整版:
打造一个高逼格的android开源项目——小白全攻略
精简集合版:
徽章系列1: Top 30 android 开源项目徽章
徽章系列2:JitPack 的使用
徽章系列3: Travis CI 的使用
徽章系列4: Circle CI 的使用
徽章系列5: Codecov 的使用
徽章系列6: Api_Level 的使用
徽章系列7: codacy 的使用
徽章系列8:生成个性徽章
总分类:
徽章(shields )系列文章总分类
github 地址:
徽章项目 Demo github 地址:
https://github.com/gdky005/AndroidBadge