如何将安卓 Gradle 模块打包发布到本地 Maven 仓库

文章目录

笔者的运行环境:

  • Android Studio Flamingo | 2022.2.1

  • Android SDK 33

  • Gradle 8.0.1

  • JDK 17

Android 的 Gradle 项目与一般的 Gradle 项目是不同的,因此对将 Gradle 模块打包发布到本地 Maven 仓库来说,对普通 Gradle 项目适用的方法,对 Android 项目是不适用的。

因为普通 Gradle 项目打包生成的是 JAR 包,而 Android 项目打包生成的是 AAR 包。不过说到底,AAR 包和 JAR 包一样,也就是一种压缩包。只不过,AAR 包是在 JAR 包的基础之上的二次压缩。具体来说,AAR 包是将源码编译生成的 JAR 包再和安卓的清单文件放在一起又制成了一个新的压缩包。

不过,也就是这点区别导致了它们关于发布到 Maven 仓库的流程有些不同。

具体流程

  1. 首先,需要先安装 Maven,否则 Gradle 将无法感知本地 Maven 仓库的位置。关于这方面的内容,可见笔者的另一篇博客:

    Maven 的下载安装教程:
    https://blog.csdn.net/wangpaiblog/article/details/112689500

  2. 这里以安卓打包发布到本地 Maven 仓库的流程为例,并假设读者使用的是一种 Gradle 多模块项目。这里演示的是将其中的一个模块打包发布到本地的 Maven 仓库。

  3. 在需要打包发布到本地 Maven 仓库的那个模块的 build.gradle 中,添加如下代码。

    gradle 复制代码
    plugins {
        id 'maven-publish'
    }
    
    task sourceJar(type: Jar) {
        from android.sourceSets.main.java.srcDirs
        archiveClassifier = "sources"
    }
    
    publishing {
        publications {
            maven(MavenPublication) {
                groupId = 'Maven 模块的 groupId'
                artifactId = 'Maven 模块的 artifactId'
                version = 'Maven 模块的 version'
    
                // 上传 AAR 包
                afterEvaluate { artifact(tasks.getByName("bundleReleaseAar")) }
                // 向 Maven 仓库中上传源码
                artifact sourceJar
            }
        }
    }

    其中,读者需要将上述代码中的 groupId、artifactId、version 改成实际的值。


    【提示】

    有人可能会使用如下额外的配置:

    gradle 复制代码
    publishing {
        // ...省略其它内容...
        repositories {
            maven {
                url = "http://my.org/repo"
            }
        }
    }

    此配置是将 Gradle 模块发送到 Maven 网络仓库上时才需要设置的。对本文来说,这是不必要的。


  4. 在 Android 上的 Gradle 面板中点击 publishToMavenLocal 即可完成发布。


    【踩坑提醒】

    有的读者可能会遇到 Gradle 面板没有 publishToMavenLocal 这一选项的问题。关于这方面的内容,可见笔者的另一篇博客:

    解决 Android Studio 的 Gradle 面板上只有关于测试的 task 的问题:
    https://blog.csdn.net/wangpaiblog/article/details/132124402


  5. 发布到本地 Maven 仓库成功之后,Gradle 会在 Maven 仓库在相应位置创建三个文件:

    • artifactId-version.aar

    • artifactId-version.pom

    • artifactId-version-sources.jar

  6. 然后,在 Gradle 项目中的根模块中的 settings.gradle 添加如下代码来引入本地 Maven 仓库。这样 Gradle 在解析依赖时就会额外去本地 Maven 仓库中寻找。

    gradle 复制代码
    dependencyResolutionManagement {
        repositories {
            mavenLocal()
        }
    }
  7. 现在,在 Gradle 项目中就可以像其它依赖一样使用 implementation 来引用刚发布到本地 Maven 仓库的依赖了。

相关推荐
C4rpeDime1 小时前
自建MD5解密平台-续
android
鲤籽鲲3 小时前
C# Random 随机数 全面解析
android·java·c#
w_31234544 小时前
自定义一个maven骨架 | 最佳实践
java·maven·intellij-idea
m0_548514776 小时前
2024.12.10——攻防世界Web_php_include
android·前端·php
凤邪摩羯7 小时前
Android-性能优化-03-启动优化-启动耗时
android
凤邪摩羯7 小时前
Android-性能优化-02-内存优化-LeakCanary原理解析
android
喀什酱豆腐7 小时前
Handle
android
m0_748232929 小时前
Android Https和WebView
android·网络协议·https
m0_748251729 小时前
Android webview 打开本地H5项目(Cocos游戏以及Unity游戏)
android·游戏·unity
哆啦 AI 梦9 小时前
【Maven】Maven的classpath
maven·classpath