添加链接
link之家
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

在组件化项目架构中每个组件管理我们一般使用分仓库管理,每个组件分别打包成aar包引入项目依赖。老版本 gradle 我们一般使用 maven 插件来上传aar包,而 Gradle 6.x 版本更新了上传插件为 maven-publish

# 低版本使用
apply plugin: 'maven'
# 6.X 以上版本变化
apply plugin: 'maven-publish'

如何生成 aar 包

  • Android Gradle 插件有两种,一个Application,一个是library,Android 插件所创建的组件取决于模块是否使用应用或库插件,而library模块编译生成的产物就是 aar 包,如下官方文档描述
  • 可以在 library 组件下执行 assemble 来生成 aar 包,输出目录为 ++build/outputs/aar++,如下图所示
  • 可以先在官方文档了解maven-publish插件配置
  • aar 包上传本地仓库

    Gradle 6.0以下 maven 插件

  • 直接使用 maven 测试发布在本项目目录中创建本地仓库目录
  • // maven-upload.gradle
    apply plugin: 'maven'
    group='com.mao.testmavenpush'
    version='1.0.0'
    uploadArchives {
        repositories {
            mavenDeployer {
                //在本项目目录下创建的Maven仓库设置
                repository(url: uri('../local_test_repo'))
    

    Gradle 7.0 maven-publish 插件

  • 为了方便测试,我们可以吧 aar 包上传到本地创建的仓库文件夹,如下创建一个 gradle 上传本地脚本 maven-push.gradle,在本地 E 盘创建一个 maventestrepository 本地仓库文件夹
  • // maven-push.gradle
    apply plugin: 'maven-publish'
    afterEvaluate {
        publishing {
            //发布的 jar 包配置
            publications {
                release(MavenPublication) {
                    groupId = 'com.mao.testmavenpush'
                    artifactId = 'maven-push-test'
                    version = '1.0.0'
                    //aar 文件
                    def projectName = project.getName()
                    artifact "build/outputs/aar/${projectName}-release.aar"
                    pom.withXml{
                        def dependenciesNode = asNode().appendNode("dependencies")
                        configurations.implementation.allDependencies.forEach(){
                            Dependency dependency ->
                                if (dependency.version != "unspecified" && dependency.name != "unspecified"){
                                    def dependencyNode = dependenciesNode.appendNode('dependency')
                                    dependencyNode.appendNode('groupId', dependency.group)
                                    dependencyNode.appendNode('artifactId', dependency.name)
                                    dependencyNode.appendNode('version', dependency.version)
            //仓库地址配置
            repositories {
                maven {
                    // test, upload local maven repository
                    //url = "file:" + new File(project.rootProject.rootDir, "local_test_repo").path
                    url = "file://e:/maventestrepository"
    
  • 在组件Module的 build.gradle 使用这个脚本
  • apply from: 'maven-push.gradle'
    
  • 随后会有对应的Task自动生成
  • 执行Gradle Task publish 后等待任务执行完本地仓库aar发布成功
  • Nexus 私服发布 aar 包

  • 和本地仓库差不多,Nexus 私服也是本地仓库,只不过是部署在内部服务器上,同理,编写一个repo-maven-push.gradle 脚本,
  • apply plugin: 'maven-publish'
    def GroupId = 'com.mao.testmavenpush'
    def ArtifactId = 'maven-push-test'
    def Version = '1.0.1'
    def userName = "xxxx"
    def passWord = "xxxx"
    def releasesRepoUrl = "http://xxx.xxx.116.12:9190/repository/maven-releases/"
    task generateSourcesJar(type:Jar){
        from android.sourceSets.main.java.srcDirs
        classifier "sources"
    afterEvaluate {
        publishing {
            //发布的 arr 包配置
            publications{
                //名字可以自己指定,如果有多渠道,整段多复制一个
                release(MavenPublication){
                    groupId = GroupId//公司域名
                    artifactId = ArtifactId//该aar包的名称
                    version = Version//版本号
                    // 必须有这个 否则不会上传AAR包
                    afterEvaluate { artifact(tasks.getByName("bundleReleaseAar")) }
                    // 多渠道,可以自行指定aar路径
                    // def projectName = project.getName()
                    // artifact "build/outputs/aar/${projectName}-release.aar"
                    // 上传source,这样使用方可以看到方法注释
                    artifact generateSourcesJar
                    //依赖关系
                    pom.withXml{
                        def dependenciesNode = asNode().appendNode("dependencies")
                        configurations.implementation.allDependencies.forEach(){
                            Dependency dependency ->
                                if (dependency.version != "unspecified" && dependency.name != "unspecified"){
                                    def dependencyNode = dependenciesNode.appendNode('dependency')
                                    dependencyNode.appendNode('groupId', dependency.group)
                                    dependencyNode.appendNode('artifactId', dependency.name)
                                    dependencyNode.appendNode('version', dependency.version)
            //仓库地址配置
            repositories {
                maven {
                    //允许使用 http
                    allowInsecureProtocol = true
                    url = releasesRepoUrl
                    credentials {
                        username = userName
                        password = passWord
    

    由以上脚本,可以知道,和发布到本地仓库其实没什么区别,也就是改变上传地址罢了,但是这里会有一个,默认需要私服地址为 Https,想要使用 Http 则需要添加 allowInsecureProtocol 设置,官方文档描述

    同理执行 Gradle Task publish 发布到 Nexus 私服

    依赖使用发布Nexus私服aar包

    要发布到 Nexus私服,首先需要自己搭建一个Nexus私服,可看我以前文章Centos下 Nexus 3.x 搭建Maven 私服

    在Gradle设置私服maven地址,同理也需要配置允许使用http,否则 sync 同步报错

    allprojects {
        repositories {
            ......
            //本地 maven 私服
            maven {
                //允许使用 http
                allowInsecureProtocol = true
                url = "http://xxx.xxx.116.12:9190/repository/maven-public/" }
    
  • 工程中依赖使用,接下来就可以愉快的玩耍了
  • dependencies {
        .....
        //测试 aar 引入
        implementation 'com.mao.testmavenpush:maven-push-test:1.0.1'
    

    测试发布项目Demo地址

    分类:
    Android
    标签:
  •