什么?!Github也可以用来搭建个人Maven仓库?

我记得刚开始入门做程序员那会儿,很喜欢自己琢磨,所以项目中遇到了需要实现的功能,总是会先尝试着自己编码来实现(矮油,小五童鞋很牛逼啊,刚入门就是高起点呐,简直屌得不要不要的嘛!), 哈哈,说来惭愧,其实之所以这样做 ,恰恰是因为自己当时太嫩,还不太会利用GitHub找轮子, 也因为如此,自己经历了一段黑暗不堪回首滴重复造车轮子滴苦逼岁月, 哭泣T_T , 虽然话是这么说,但现在回想起来,当时自己也算是苦中作乐确有收获了。

​ 不好意思,好像说了一堆废话,哈哈,见谅见谅,我们现在就回归正题。

​ 之前在做公司的一个仓库项目管理的APP的时候,需要使用数据库在手机端保存数据,所以我就在项目中使用了大名鼎鼎的greenDAO3依赖来完成这一块的功能逻辑开发,然后问题出现了,greenDAO3本身的异步操作功能实现是通过引用旧版本的Rxjava来完成的,和当时这个项目中已经在使用的新版本Rxjava2就一下子不和谐了,虽然他们可以同时存在,不影响项目的构建,但无疑俩个功能高度雷同的俩代库会让项目变得臃肿,为此,我想着fork一下greenDAO的源码,然后将里面的Rxjava依赖更新到Rxjava2, 但在其项目的issue中发现,已经有一个叫AndroidClasses人这样做过了,于是自己就使用JitPack将这位童鞋的代码生成了一个maven依赖直接引入解决了这个问题。

使用JitPack 生成的依赖代码

PS: _此处建议比较好的做法是先将AndroidClasses的项目代码fork到自己的GitHub然后使用JitPack来生成对应的maven依赖,这样可以保证项目依赖的安全性,防止这位童鞋哪天失恋心情不好,直接删库带来一些不必要的麻烦

什么,说了这么多废话,原来就一JitPack完事啊,哈哈,的确,大多时候,我们只要将项目需要的第三方库在Github上的代码fork到自己的github库 然后将地址提交到JitPack即可获取对应的Maven依赖地址。但一般使用像greenDAOFresco等牛逼的大型开源项目我们常常不会使用到JitPack,因为他们一般都会有人维护所以还是很稳定的。就我个人来讲,通常会使用到JitPack来获取maven依赖的对象大都是自己发布在Github的项目以及一些存在不稳定因素的个人开源项目还有那些需要做一些定制化的修改优化和bug修复的第三方依赖库。


OL,完事了?NO!难道你就不想自己实现一个JitPack

​ 哈哈,别紧张,我说的不是让大家自己建一个JitPack网站,我的意思是我们能不能像JitPack一样利用Github来搭建一个属于自己的Maven仓库...因为如果万一...JitPack挂掉了(呃,我咋这么坏 哈哈 )我们也有个备份选择不是 。

虽然JitPack基本满足了我们的功能需求,但是它仍有不足之处:使用JitPack获取的Maven依赖其默认的GroupId格式为com.github.<username> ,如果要自定义groupId,则必须有个前提,这个前提就是你想自定义的 groupId是个已经注册的域名并且你自己能够进入该域名的管理页面做一些设置,详情请查看JitPack官方文档说明:使用JitPack自定义groupId好吧!看来装逼门槛有点高啊!!!

的确,先别说这个域名有没有被注册,就算没被注册了,咱穷苦大众也是没钱买啊T_T,再说了,我就不想用和域名有半毛钱关系的 groupId

那有没有不用花钱,还能逼格满满地实现我们这个自定义的groupId呢?

答案是肯定的,不然我干嘛来的?

Okay,Let's get it started ! 快上车!

1、准备在Github上创建俩仓库abstractlistadaptersmvn-repoabstractlistadapters是我们需要发布到Maven仓库的Android Library项目,mvn-repo用来存放abstractlistadapters的Maven部署文件。

ps:这个mvn-repo仓库还可以放其它项目的Maven部署文件,也就是说它可以专门用来存放各种项目对应的Maven部署文件,是一个Maven部署文件存放仓库)在本例中我会把abstractlistadapters项目的maven部署文件release版本放置在mvn-repo/Android/Lib/abstractlistadapters/ 下,snapshot版本放置在mvn-repo/Android/Lib/abstractlistadapters/snapshots/ 下。这个路径很重要,如果你看到本文章结尾,你就会发现maven对应的URL与此路径将保持一致。

2、打开AndroidStudio ,新建一个Android Library 项目,在项目根目录下找到 gradle.properties 文件,如果没有,请新建一个。在该文件下粘贴如下代码:

VERSION_NAME=0.0.1
VERSION_CODE=1
GROUP=com.walkermanx  //改成自己的

POM_DESCRIPTION="this is my first android aar mvn repo in github !"
#对应要发布项目,此处是 abstractlistadapters 的github地址
POM_URL=https://github.com/walkermanx/abstractlistadapters    
#对应要发布项目,此处是 abstractlistadapters 的github地址
POM_SCM_URL=https://github.com/walkermanx/abstractlistadapters
#abstractlistadapters 的git地址
POM_SCM_CONNECTION=scm:git@github.com:walkermanx/abstractlistadapters.git
POM_SCM_DEV_CONNECTION=scm:git@github.com:walkermanx/abstractlistadapters.git
POM_LICENCE_NAME=The Apache Software License, Version 2.0
POM_LICENCE_URL=http://www.apache.org/licenses/LICENSE-2.0.txt
POM_LICENCE_DIST=repo
POM_DEVELOPER_ID=5Mall  //发布者id
POM_DEVELOPER_NAME=5Mall <zhangwei-baba@163.com> //发布者名字

#项目的Maven本地部署路径,部署文件生成之后会存放在此,然后我们把这些文件提交到之前提前在githun上建好的mvn_repo仓库

RELEASE_REPOSITORY_URL=file:///D:/WorkSpace/AndroidStudioProject/personal_projects/mvn-repo/Android/Lib/abstractlistadapters/
SNAPSHOT_REPOSITORY_URL=file:///D:/WorkSpace/AndroidStudioProject/personal_projects/mvn-repo/Android/Lib/abstractlistadapters/snapshots/

#RELEASE_REPOSITORY_URL 和 SNAPSHOT_REPOSITORY_URL
#两个配置分别是正式版和快照版的本地路径。如果版本号后带有 -SNAPSHOT (大小写敏感  也就是-snapshot依然会发布到 RELEASE_REPOSITORY_URL 目录下 不会发布发到SNAPSHOT_REPOSITORY_URL )
#编译后会发布到 SNAPSHOT_REPOSITORY_URL 相应的目录下。

3、按照上面代码注释说明将对应字段修改为自己的,然后在项目对应要发布的Library Module下再次创建一个gradle.properties 文件(见下图说明)并粘贴如下代码:

POM_NAME=Library-abstractlistadapters  //
POM_ARTIFACT_ID=abstractlistadapters
POM_PACKAGING=aar 
代码截图说明

4 、在Library Module下的build.gradle文件中调用gradle-mvn-push 插件 ,如下图

apply from: 'https://raw.githubusercontent.com/walkermanx/gradle-mvn-push/master/gradle-mvn-push.gradle'
代码截图说明

5 、上图中脚本获取方式如下图:

代码截图说明

6、点击打开项目底部的Terminal栏,并执行gradlew clean build uploadArchives 命令后会在会在RELEASE_REPOSITORY_URL对应的路径创建相关的文件,然后在AS中将本地Android Library项目的代码提交到Github上的abstractlistadapters仓库,将Github新建的mvn-repo仓库clone到本地路径A,并将RELEASE_REPOSITORY_URL对应路径生成的文件拷贝到路径A下对应该项目的文件夹中然后执行git命令提交到远程mvn-repo仓库即可。
7 、OK,到此我们的个人Maven仓库就建好了,下面我们可以按照如下步骤在实际项目中引用啦! ,碉堡了有木有 _

  • 在项目的根目录中找到 build.gradle 文件 (不是module的build.gradle文件 ),加入如下代码:

    allprojects {
        repositories {
            maven {
                url 'https://raw.githubusercontent.com/walkermanx/mvn-repo/master/Android/Lib/abstractlistadapters/'
            }
        }
    }
    
  • 在你的项目module的build.gradle 文件中引入依赖:

     //建议AndroidStudio3.0以上版本 根据需要使用implementation或者api方式引入依赖
     implementation 'com.walkermanx:abstractlistadapters:0.0.1'
    //implementation 'com.walkermanx:abstractlistadapters:0.0.1@aar'
     //AndroidStudio3.0以下版本
     compile 'com.walkermanx:abstractlistadapters:0.0.1'
    

说明:
jar:仅仅包含class和清单文件,没有 资源文件。
aar:包含了class和清单文件以及资源文件
因为abstractlistadapters依赖目前没有引用的资源文件 所以我们没有加@aar后缀

如果这篇文章对您有所帮助,希望您能大方给个心,您小小的鼓励对我来说是大大的动力哦^_^

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,013评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,205评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,370评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,168评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,153评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,954评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,271评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,916评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,382评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,624评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,209评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2 345

推荐阅读更多精彩内容