利用 Gitlab搭建 maven仓库

前言

一直以来公司Android项目都互相依赖各种lib库。

初期--整个lib代码的拷贝。

中期--通过编译成aar包,或者jar包,然后在拷贝。

后期--现在,打算利用公司已有的Gitlab代码管理库。实现maven仓库的搭建。

PS:如果公司服务器资源充足,采用Nexus 搭建一个Maven库。这样整个Maven库的管理会更合理和有效一些。

目标

结束aar和jar文件乱发的历史,使用implementation 引用。

如果在Glilab将项目配置为公共public权限。那么外部其他客户也可以使用maven仓库了。

实现步骤

1.打包配置

Android Studio 环境版本

代码语言:javascript
复制
Android Studio 4.2.1
build:gradle:4.2.1

将需要打包成jar或者aar的项目配置maven 脚本。

新建一个:gitlab.gradle文件 和项目build.gradle同一级目录下创建。

并添加下面代码:

代码语言:javascript
复制
apply plugin: 'maven'

uploadArchives {
repositories.mavenDeployer {
def mavenDirPath = file('../maven') // 相对地址。编译后的代码将会存在父目录的maven文件夹下。
def mavenDirPath = file('D:\appmaven') //绝对路径,编译后的代码将会存在 D盘的appmaven文件夹下。
repository(url: "file://${mavenDirPath.absolutePath}")
pom.project {
groupId "cn.zinyan.demo" // 包名
artifactId "Key" // module的名字
version '1.1.1'// 版本号
//配置完毕后,包名决定地址中的 第一项,artifactId 决定了第二项,version 决定了第三项版本号
//implementation 'cn.zinyan.demo:Key:1.1.1'
}
}
}

// 如果不想生成 javadoc.jar 和 sources.jar 库以下代码可以省略
def sourceDirs
if (project.hasProperty("android")) {
sourceDirs = android.sourceSets.main.java.srcDirs
}else {
sourceDirs = sourceSets.main.java.srcDirs
}

task javadocs(type: Javadoc) {
source = sourceDirs
}
//生成doc
task javadocsJar(type: Jar) {

// classifier='javadoc' //老版本写法, 现在已经过期了。建议使用下面的
archiveClassifier.set('javadoc')
from javadocs.destinationDir
}
//生成sources
task sourcesJar(type: Jar) {
// classifier='sources'//老版本写法, 现在已经过期了。建议使用下面的
archiveClassifier.set('sources')
from sourceDirs
}

artifacts {
archives javadocsJar
archives sourcesJar
}

build.gradle 文件中引用gitlab.gradle 文件。

添加方式:apply from: 'gitlab.gradle'

然后我们可以在右侧的Gradle面板的Tasks->upload->uploadArchives 指令

点击执行该指令,就可以在本地生成相应编译后的代码了。

上面的指令直接支持:aar库和jar库的编译。系统会根据你的lib的类型。自动打相应的文件。

2.上传代码

直接通过gi将执行编译后的全部aar,和jar等数据上传就可以了。

包括aven-metadata.xml等文件,pom等文件,javadoc等文件,sources等文件。

3.使用gitlab库的maven

3.1.maven是公共的

如果你的GitLab上的maven仓库项目是公共的。那么maven 就是公共的

其他人调用,只需要该maven库的地址即可

代码语言:javascript
复制
allprojects {
repositories {
maven {
url "https://你的仓库的地址https://你的仓库的地址+直接到项目名/分支/"
}
}

这个url链接:gitlab 上通常情况下 。

公共项目的路径是这样的 https://域名地址https://域名地址/Group名称/项目名/-/raw/分支名/

如果该项目是你自己的。而不是组里面的。那么Group名称就得换成你的用户名了。

有一个很简单的方法。

访问你的gitLab库,打开我们提交的一个xml文件。例如pop.xml文件。

在浏览器中,从https开始一直到你的包名称截止,这一段地址就是我们需要配置到maven上的url地址。后面的包名路径,IDEA会自动帮我们补上并更新了

3.2.maven是私有的

如果你的GitLab 是私有的。只想部分人可以使用。

需要在maven 地址导入的位置,添加相应的访问账号和Token了。

可以参考文章 利用Gitlab仓库搭建私有Maven仓库 - 知乎 (zhihu.com)

4.使用gitee库的样例

例如我在gitee上搭建的一个简单的maven仓库。

代码语言:javascript
复制
allprojects {
repositories {
maven{
url 'https://gitee.com/zinyan/maven/raw/master/'
}

implementation 'com.zinyan.util:general:1.0.0'