学习完毕 Gradle 的基础知识,不来点实战,感觉就像没有学习过啊。那我们就搞一搞实战,一共两个简单的操作。第一,写一个自定义 Plugin。第二,写一个自定义 Transform。
网上一般都会说三种方法是去创建,咱们就不来那么多虚的,来个一劳永逸的吧,我们直接新建一个工程来写,这个会了,新建 Library 工程 和在 build.gradle 中的这两种方式相信你也就会了。
注意:我用的是 IntelliJ IDEA,这个就和 Android 没有关系了。
选择 Gradle 项目,勾选中 Groovy。
groupId、artifactId、version 三者确定唯一库。
groupId:是项目组织唯一的标识符,实际对应JAVA的包的结构,是main目录里java的目录结构。
artifactId:是项目的唯一的标识,实际对应项目的名称,就是项目根目录的名称。
version:指的是版本号,注意:SNAPSHOT意为快照,说明该项目还处于开发中,是不稳定的版本。
最后点,点,点,finish。就ok了。
因为我们这个是 Gradle 项目,我们要配置一下一些第三方依赖。
plugins { id 'groovy' id 'maven' } group 'com.ssy.plugins' version '1.0.0' repositories { mavenCentral() google() jcenter() } dependencies { //Gradle Plugin 依赖 implementation gradleApi() //本地发布 Plugin implementation localGroovy() //因为我们需要在android 项目中使用,所以需要android的tool build库 implementation 'com.android.tools.build:gradle:3.3.2' } 复制代码
首先需要说明的是一个概念,就是比如我们平时使用的 apply plugin: 'com.android.application'这个 plugin的名字是需要我们进行配置的。
在 resources 文件夹下,新建一个 META-INF 文件夹,在 META-INF 里新建 gradle-plugins 文件夹,最后创建我们的 pluginName.properties,注意后缀哈。 比如我写的就是com.ssy.plugins.ssyplugin.properties。我的 plugin id 就是com.ssy.plugins.ssyplugin。最后在这个文件中写下我们自定义 plugin的路径。
创建 SsyPlugin.groovy 文件,注意:我们是在groovy中写的,不是java。
package com.ssy.plugins import org.gradle.api.Plugin import org.gradle.api.Project import com.android.build.gradle.AppExtension class SsyPlugin implements Plugin<Project> { @Override void apply(Project project) { project.task("hello"){ println('hellow~~~~~~~') } } } 复制代码
到此我们自定义的 plugin 就算是基本完成,简单吧,然后我们就要发布我们的 plugin。
在 build.gradle 文件中添加下面的代码
uploadArchives { repositories { mavenDeployer { //设置插件的GAV参数 pom.groupId = 'com.ssy.plugins' pom.version = '1.0.0' //文件发布到下面目录 repository(url: uri('../repo')) } } } 复制代码
点击右边 Gradle 中的uploadArchives,就可以生成我们jar包了。 当然我们也可以在 Terminal 中运行 ./gradlew uploadArchives 一个意思。
补充小知识:../repo,就是当前project 目录的外层目录。
1、./是当前目录
2、../是父级目录
3、/是根目录
最后你就可以找到 SsyPlugin-1.0.0.jar 了。
结束。手工~~
呸,还没说怎么用收你妹的工啊,额,好好,写完回家,回~~家。
我们新建一个 Android 项目,这个就不演示了。 首先,我们需要把 repo 项目,从复制到,我们android 项目的 父目录,也就是和我们这个项目平级。这样我们就可以使用它了。
首先我们需要在 项目的 gradle.build 中,不是 app 的 gradle.build,如图吧,这样明白一点。
// Top-level build file where you can add configuration options common to all sub-projects/modules. buildscript { repositories { //配置我们仓库地址 maven { url uri('../repo') } google() jcenter() } dependencies { classpath 'com.android.tools.build:gradle:3.2.1' //这个就是 仓库中指定我们需要的版本 classpath 'com.ssy.plugins:SsyPlugin:1.0.1' // NOTE: Do not place your application dependencies here; they belong // in the individual module build.gradle files } } allprojects { repositories { maven { url uri('../repo') } google() jcenter() } } task clean(type: Delete) { delete rootProject.buildDir } 复制代码
小知识:classpath 是用来配置 buildscript 的。
好配置完 project 的 gradle.build ,我们来配置 app 的 gradle.build。 直接使用就好了。
apply plugin:'com.ssy.plugins.ssyplugin' 复制代码
好了,配置完毕。 我们来检验一下我们是否搞成功了。 命令行敲起来 ./gradlew hello。
ok ,完工,下一篇 自定义 Transform。