【Gradle-9】Gradle插件发布指南

1、前言

不管是在公司内部,还是开源,Gradle插件发布都是一项必备的技能,本文主要介绍本地发布和远端发布两种方式。
【Gradle-9】Gradle插件发布指南_第1张图片

2、本地发布

2.1、添加依赖

在plugin>build.gradle文件中(插件的项目)先依赖一个maven发布的插件'maven-publish'

plugins {
    id 'maven-publish'
}

dependencies {
    implementation 'com.android.tools.build:gradle:7.3.0'
}

2.2、发布配置

maven的发布配置是在publishing { }闭包中设置的。
本地发布主要为两部分:

  • GAV坐标
  • 仓库地址
group 'com.yechaoa.plugin'
version '1.0.0'

publishing {
    // 配置Plugin GAV
    publications {
        maven(MavenPublication) {
            groupId = group
            artifactId = 'dependencies'
            version = version

            from components.java
        }
    }
    // 配置仓库地址
    repositories {
        maven {
            url layout.buildDirectory.dir("maven-repo")
        }
    }
}

2.3、执行发布

以上配置完成即可执行发布操作:

./gradlew publish

或者在Android Studio右边Gradle可视化的面板点击运行publish
【Gradle-9】Gradle插件发布指南_第2张图片

2.4、生成产物

【Gradle-9】Gradle插件发布指南_第3张图片
ok,这时候build文件夹下已经有本地发布配置的maven-repo文件夹了。
主要确认jar/aar文件、pom文件、metadata等正确即可。

2.5、使用

ok,本地发布完了,要想使用这个插件,跟我们正常依赖插件是一样的流程。
三步走:

  1. 在settings.gradle文件中配置插件仓库地址
pluginManagement {
    repositories {
        // ...
        maven {
            url './maven-repo'
        }
    }
}
  1. 在project>build.gradle文件中添加插件依赖
buildscript {
    dependencies {
        classpath('com.yechaoa.plugin:dependencies:1.0.0')
    }
}
  1. 在app:build.gradle文件中依赖我们的plugin
plugins {
    id 'com.yechaoa.plugin.dependencies'
}

以上配置都是在app模块中添加的,即需要使用的模块。

注意:本地依赖使用的时候,要先发布,再依赖插件,否则就会出现cannot found找不到依赖的情况。

3、Maven远端发布

Maven是一个软件项目管理工具,基于项目对象模型 (POM) 的概念,Maven 可以通过中央信息来管理项目的构建、报告和文档,也是最常用的存储库。

上面我们已经完成了本地发布,Maven远端发布主要是需要各种配置。
基于本地发布,远端发布有几个差异点:

  • 注册仓库账号;
  • 配置POM;
  • 签名;
  • 远端仓库地址;
  • 准备域名;

比较繁琐,就。。不全流程陪跑了

一个示例:

plugins {
    id 'java-library'
    id 'maven-publish'
    id 'signing'
}

group = 'com.example'
version = '1.0'

java {
    withJavadocJar()
    withSourcesJar()
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            artifactId = 'my-library'
            from components.java
            versionMapping {
                usage('java-api') {
                    fromResolutionOf('runtimeClasspath')
                }
                usage('java-runtime') {
                    fromResolutionResult()
                }
            }
            pom {
                name = 'My Library'
                description = 'A concise description of my library'
                url = 'http://www.example.com/library'
                properties = [
                    myProp: "value",
                    "prop.with.dots": "anotherValue"
                ]
                licenses {
                    license {
                        name = 'The Apache License, Version 2.0'
                        url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id = 'johnd'
                        name = 'John Doe'
                        email = '[email protected]'
                    }
                }
                scm {
                    connection = 'scm:git:git://example.com/my-library.git'
                    developerConnection = 'scm:git:ssh://example.com/my-library.git'
                    url = 'http://example.com/my-library/'
                }
            }
        }
    }
    repositories {
        maven {
            // change URLs to point to your repos, e.g. http://my.org/repo
            def releasesRepoUrl = layout.buildDirectory.dir('repos/releases')
            def snapshotsRepoUrl = layout.buildDirectory.dir('repos/snapshots')
            url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
        }
    }
}

signing {
    sign publishing.publications.mavenJava
}


javadoc {
    if(JavaVersion.current().isJava9Compatible()) {
        options.addBooleanOption('html5', true)
    }
}

全流程的大家可以参考:

  • 再见JCenter,将你的开源库发布到MavenCentral上吧
  • Gradle 构建工具 #4 来开源吧!发布开源组件到 MavenCentral 仓库超详细攻略

4、JitPack

如果你的项目是使用GitHub托管的,那么最常用的发布方式就是使用JitPack了,它是一个简单易用的Git包存储库,使用、发布也非常简单,不需要注册网站账号,搞一堆验证什么的,而且对项目也是无侵入式的,也不需要服务器、域名什么的。

4.1、使用GitHub托管

最基本的就是项目使用GitHub来进行托管了,就是把项目上传到GitHub,Public或者Private都行。
比如我这个GradleX项目:
【Gradle-9】Gradle插件发布指南_第4张图片

4.2、发布

你甚至什么都没干,就传了一个项目,就可以直接走发布流程了。
【Gradle-9】Gradle插件发布指南_第5张图片

在项目仓库主页的右边菜单列表,找到Releases,点击「Create a new release」。
如果已经发布过了,这里就是发布记录,点进去可以「Draft a new release」。
【Gradle-9】Gradle插件发布指南_第6张图片

  • 设置tag,即版本号,如果不是正式版,可以在后面加上alpha,比如1.0-alpha;
  • 选择发布的分支;
  • 发布标题;
  • 发布描述;
  • 点击「Publish release」进行发布;

发布完成会有产物和记录
【Gradle-9】Gradle插件发布指南_第7张图片

4.3、使用

上面就发布完成了,那么如何使用呢?
打开Jitpack官网:https://www.jitpack.io/,在输入框里输入yechaoa/GradleX,即username+project。
然后点击Look up开始查找和构建。
【Gradle-9】Gradle插件发布指南_第8张图片
构建完成有了Log日志之后,即可以点击Get it获取使用方式。
使用方式:

  1. 首先要添加jitpack的仓库地址;
  2. 然后添加项目依赖,因为是基于GitHub发布的,域名前缀会com.github,自定义需要添加映射;

在添加依赖这里,因为我们是整个项目发布的,包含多个模块,所以我们也可以选择子模块来进行单独依赖。
比如我这个项目中有:
【Gradle-9】Gradle插件发布指南_第9张图片
我的项目是GradleX,插件模块是plugin,插件是dependencies。根据最小原则,我们可以直接选择依赖插件dependencies,后面有多个插件的时候,我们可以选择依赖plugin模块。

4.4、验证

发布完了,我们来验证一把试试。

首先在settings.gradle中添加仓库:

	repositories {
        maven { url 'https://jitpack.io' }
    }

然后再添加依赖:

	dependencies {
        classpath('com.github.yechaoa.GradleX:dependencies:1.0')
    }

因为我们是依赖插件,所以implementation要换成classpath。

最后是依赖插件和打开插件配置:

plugins {
    id 'com.yechaoa.plugin.dependencies'
}

printDependencies {
    enable = true
}

然后我们sync一下看看。

> Configure project :app
DependenciesPlugin >>>>> com.yechaoa.plugin.DependenciesPlugin
---hasProperty isTest no
DependenciesPlugin >>>>> 已开启依赖打印
DependenciesPlugin >>>>> applicationVariant.getName() = debug
Run with --info for a stacktrace.
--------------官方库 start--------------
com.google.android.material:material:1.8.0
androidx.appcompat:appcompat:1.5.0
org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.10
androidx.core:core-ktx:1.8.0
......

可以看到,已经有预期的输出结果了。
因为sync会触发Gradle构建,从而我们在编译期打印依赖的插件就会生效,并打印项目中的依赖。

ok,jitpack的发布方式就这些了,是不是非常简单~

5、Gradle Plugin Portal

Gradle插件门户网站是一个专用于Gradle插件的集中式、可搜索的存储库,发布的流程和配置也都比Maven要简单多了。

5.1、注册账号

首先要注册一个Gradle插件门户网站的账号,https://plugins.gradle.org/user/login,我们直接使用Github账号登录即可。
【Gradle-9】Gradle插件发布指南_第10张图片
GitHub执行2FA双重校验之后,使用GitHub登录时需要再校验一次,按照流程走就行,不复杂。

5.2、获取秘钥

在API Keys选项下面生成秘钥。
【Gradle-9】Gradle插件发布指南_第11张图片

5.3、配置秘钥

秘钥用来发布用,通常是放在HOME_DIR/.gradle/gradle.properties (~/.gradle/gradle.properties)文件中,如果没有,就新建一个。当然也可以放在其他有效的地方,但我还是建议放在这,可以全局用。
如果这一步你没有配置,也可以手动执行发布命令,然后通过传参的方式把秘钥给带上去:

$ ./gradlew publishPlugins -Pgradle.publish.key= -Pgradle.publish.secret=

5.4、发布配置

5.4.1、依赖发布插件

gradle插件门户发布的话有自己的发布插件

plugins {
    id 'com.gradle.plugin-publish' version '1.1.0'
}

发布插件1.0.0版本及以上的用法,需要Gradle 7.6及以上。
不过1.0.0版本及以上版本也带来了诸多便利,比如:

  • 它包含’java-gradle-plugin’和’maven-publish’插件;
  • 自动生成并发布源码和文档;
  • 签名也是自动的;

5.4.2、配置发布信息

因为我们前面本地发布的时候依赖过id 'java-gradle-plugin'插件了,这里就省事了,直接在gradlePlugin { } 里面继续配置就行。

gradlePlugin {
    // 项目地址
    website = 'https://github.com/yechaoa/GradleX'
    // 项目仓库URI
    vcsUrl = 'https://github.com/yechaoa/GradleX.git'

    // 可以有多个plugin配置
    plugins {
        // register 这个名字可以随便填
        register {
            // 插件id
            id = 'com.yechaoa.plugin.dependencies'
            // 插件全路径
            implementationClass = "com.yechaoa.plugin.DependenciesPlugin"
            // 插件名称
            displayName = 'DependenciesPlugin'
            // 描述、简介
            description = 'Show Dependencies Plugin'
            // 插件类别,即标签、关键词的意思
            tags.addAll('Dependencies', 'yechaoa', 'plugin')
        }
    }
}

以上配置需要Gradle7.6版本及以上,老的版本用的是pluginBundle,而不是gradlePlugin
@since 7.6:

    /**
     * Returns the property holding the URL for the plugin's website.
     *
     * @since 7.6
     */
    @Incubating
    public Property getWebsite() {
        return website;
    }

发布后的示例:
【Gradle-9】Gradle插件发布指南_第12张图片

5.5、执行发布

以上配置完成之后,sync一下。
发布命令:

./gradlew publishPlugins

没配秘钥的话:

./gradlew publishPlugins -Pgradle.publish.key= -Pgradle.publish.secret=

或者在Gradle面板中双击publishPlugins执行:
【Gradle-9】Gradle插件发布指南_第13张图片
接下来就是等待审核了。审核是有一些要求的,比如太简单且没有意义的helle wordSNAPSHOT版本等。
审核通过就可以在Gradle插件门户网站搜到了。

5.6、引用方式

7.0之后:

plugins {
  id "com.yechaoa.plugin.dependencies" version "1.0.0"
}

7.0之前:

buildscript {
  repositories {
    maven {
      url "https://plugins.gradle.org/m2/"
    }
  }
  dependencies {
    classpath "com.yechaoa.plugin:dependencies:1.0.0"
  }
}

apply plugin: "com.yechaoa.plugin.dependencies"

7.0之后因为在pluginManagement{ }中默认加了gradlePluginPortal()地址,所以配置更简单了。

7、总结

Gradle插件发布就介绍到这里了,虽然maven的发布方式很繁琐,但也只是第一次这样,配置完成后就可以抽成一个脚本,每次发布执行一下就ok了,不过还是首推JitPack,毕竟真的太方便了。

8、最后

写作不易,感谢支持~

9、GitHub

https://github.com/yechaoa/GradleX

10、相关文档

  • Apache Maven
  • Publishing a project as module
  • Maven Publish Plugin
  • POM Reference
  • MavenPom
  • jitpack.io
  • Publishing Plugins to the Gradle Plugin Portal
  • How do I publish my plugin to the Plugin Portal using version 1.0+?

你可能感兴趣的:(Gradle基础到进阶,gradle,android)