Android + Gradle + Maven 私服

近期在推进项目工程的模块化及组件化，把一些公共的三方库和确定长期不做变动的垂直功能代码拆分为 modlule lib 的功能组件，以 aar 的形式打包上传到本地 maven 私服仓库里，项目工程中以远程依赖的形式来引入。一是为便于统筹归集控制各三方库的版本，一是为简化工程体积加速编译。由于公司有自建的内网 maven 私服仓库，所以很快就把这些库分类归集出来上传到内网的 maven 私服仓库了。做完后，对 maven 私服搭建有些兴趣就自己手动搭建了一个，从头捋了一遍，最后会附上 Android Demo 工程。

准备（我是 mac 机）

• JDK 版本 1.8+
• 下载 Sonatypec Nexus 我用的是 3.x 版本 [Nexus Repository Manager OSS 3.x - OS X] (https://www.sonatype.com/oss-thank-you-mac-tgz)

Nexus 号称 ‘世界上第一个也是唯一可以免费使用的通用储存库解决方案’

• 安装并启动 Nexus

1. 解压并运行 bin 目录下的 nexus 文件，安装 nexus

   
   image.png
   image.png
2. 启动 nexus； ./nexus start

image.png

3. 浏览器访问 http://localhost:8081 成功即表示 nexus 搭建成功 ，以默认的管理员账号登录 admin , admin123，可看到默认创建的 hosted type 的两个 maven 仓库（maven-release、maven-snapshots）

image.png

Gradle Task

• Nexus Maven 本地仓库搭建成功，这里我们用默认的仓库来进行 upload 测试，当然也可以自建专属仓库，注意新建的 maven 仓库 type 为 hosted

  
  image.png

【正式仓库】http://localhost:8081/repository/maven-releases/
【快照仓库】http://localhost:8081/repository/maven-snapshots/

• uploadArchives

# maven local config
#正式版本号
versionName=1.0
#快照版本号
snapshotVersionName=1.0-SNAPSHOT
#快照仓库地址
mavenSnapshotUrl=http://localhost:8081/repository/maven-snapshots/
#发布仓库地址
mavenReleasesUrl=http://localhost:8081/repository/maven-releases/
maven_local_username=admin
maven_local_password=admin123
#项目组 id
maven_pom_groupId=zyf.asos
#项目名称
maven_pom__artifactId=maventest
#打包类型
maven_pom__packaging=aar
maven_pom__description=test upload

uploadArchives {
    repositories.mavenDeployer {

        repository(url: mavenReleasesUrl) {
            authentication(userName: maven_local_username, password: maven_local_password)
        }

        snapshotRepository(url: mavenSnapshotUrl) {
            authentication(userName: maven_local_username, password: maven_local_password)
        }

        pom.project {
            // 注意：【这里通过切换 versionName 的赋值来区分上传快照包还是正式包（snapshot 版本必须以 -SNAPSHOT 结尾）】
            //version snapshotVersionName
            version versionName
            artifactId maven_pom__artifactId
            groupId maven_pom_groupId
            packaging maven_pom__packaging
            description maven_pom__description
        }
    }

• Javadoc（如果想要保留注释的话）

// type显示指定任务类型或任务, 这里指定要执行Javadoc这个task,这个task在gradle中已经定义
task androidJavadocs(type: Javadoc) {
    // 设置源码所在的位置
    source = android.sourceSets.main.java.sourceFiles
}

// 生成javadoc.jar
task androidJavadocsJar(type: Jar) {
    // 指定文档名称
    classifier = 'javadoc'
    from androidJavadocs.destinationDir
}

// 生成sources.jar
task androidSourcesJar(type: Jar) {
    classifier = 'sources'
    from android.sourceSets.main.java.sourceFiles
}

// 产生相关配置文件的任务
artifacts {
    archives androidSourcesJar
    archives androidJavadocsJar
}

• 执行 uploadArchives task，可看到代码已成功上传

  
  image.png

• 关于快照版本的上传问题
  snapshot 版本 的 version 必须以 -SNAPSHOT 结尾，上传 task 会自行判断 version 来决定上传到 release 仓库还是 snapshot 仓库。

引入本地库

allprojects {
    repositories {
        jcenter()
        mavenCentral()
        mavenLocal()

        maven {
            url mavenReleasesUrl
        }

        maven {
            url mavenSnapshotUrl
        }

        maven {
            url 'https://maven.google.com'
        }

        google()
    }
}

implementation 'zyf.asos:maventest:1.0'

Demo

https://github.com/zyfasos/Android-Maven-Local-Demo

参考博客

<<Android-Nexus 搭建自己的 Maven 仓库 & Gradle 上传依赖包>>