前言
通过上两篇文章,我们大概知道了Groovy,Gradle在Android项目构建中的一些基本的配置和其作用,接下来就是我们真正实践的时刻,我们通过一个简单的插件的实现,来将前两篇中的点串起来,再次回顾熟悉Groovy语言,通过一个简单的demo跑通这个插件实现流程。创建一个插件,并发布到本地maven仓库。然后在我们的项目中运用我们的插件,调用相关的task。
Gradle插件Hello World
之前在自己学习gradle的时候,网上的资料本身相对较少,再就有些博主略过了一些细节,导致了很多博客中给出的例子,当我们自己实际去实践的时候,自己反倒无法跑起来,这里对于创建一个简单的gradle插件,进行了步骤的切分,对于每一个步骤进行较为详细的讲解。
- Task
在Gradle文件中,我们可以根据自己的需求写一些task,其后的参数为task指定相应的名称
task("Test") {
println("Hello world")
}
- Plugin
在Build文件中,我们可以实现一个简单的Gradle插件,通过实现Plugin
接口,并实现其apply方法,这里在apply方法中打印出一个Hello world
。
class MyPlugin implements Plugin<Project> {
@Override
void apply(Project target) {
println("Hello world")
}
}
在Build文件中写,显然无法让其复用,如果复用,我们就需要将其独立出来,如何来将其写成一个独立的插件呢?我们可以通过AndroidStudio来进行插件的开发,但是由于AndroidStudio没有给予很好的支持,因此,可能需要我们去手动的删除一些文件,然后按照正常的插件目录重新建立项目。
1. 创建一个Java Library Module
这里,我们新建一个Module,并取名firstplugin。
默认目录结构2. 删除部分文件目录
将Java文件名称改为groovy
(因为,我们的demo项目中不需要Java代码,因此,可以将其替换为groovy。)。删除libs目录
3. 构建配置
原build文件
apply plugin: 'java'
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
}
sourceCompatibility = "1.7"
targetCompatibility = "1.7"
因为我们要支持对于Groovy的编译支持,所以要添加一些Groovy相关的内容。
apply plugin: 'groovy'
apply plugin: 'maven'
dependencies {
compile gradleApi()
compile localGroovy()
}
repositories {
mavenCentral()
}
执行build文件后,我们在进行开发的时候,就可以进行自动提示帮助我们提升开发效率。
4. HelloWorld插件开发
建立Groovy文件,进行插件代码的开发。这里我们命名为FirstPlugin .
package com.example;
import org.gradle.api.Plugin
import org.gradle.api.Project
class FirstPlugin implements Plugin<Project> {
@Override
void apply(Project target) {
target.task("TestTask") {
println("Hello world")
}
}
}
当前目录状况
5. 配置插件信息
在Src目录下添加resources
文件夹,创建一级目录,META-INF
,在其下创建二级目录,grale-plugins
,然后创建一个文件。命名方式,插件名称+properties后缀。
这里我们的文件名是com.example.firstplugin.properties
implementation-class=com.example.FirstPlugin
里面用来指定我们的插件实现类。
当前目录结构6. 发布到本地仓库
在Build文件中添加传至本地mavenCentral的代码
//根据自己需求来配置
group = 'com.jensen.plugin'
//版本信息
version = '1.0.0'
uploadArchives {
repositories {
mavenDeployer {
//本地仓库地址
repository(url: uri('/Users/chenjensen/Desktop/repo'))
}
}
}
在Gradle task中执行uploadArchives
,即可看到在本地的repo中产生的依赖。
7. 应用到项目中
在Project的build文件中添加
repositories {
jcenter()
//配置maven地址
maven {
url uri('/Users/chenjensen/Desktop/repo')
}
}
dependencies {
//编译时依赖的插件
classpath 'com.android.tools.build:gradle:2.3.3'
//指定插件的路径
classpath 'com.jensen.plugin:firstplugin:1.0.0'
}
在我们的app的project中应用我们的插件
apply plugin: 'com.example.firstplugin'
TestTask
执行控制台打印出执行信息.
Hello world
总结
通过这一个流程,我们可以写出来一个简单的Gradle插件,对于具体更深入的功能,我们可以自己来根据自己的需求定制自己的插件,去写相应的task。通过本篇,主要是熟悉流程,接下来的第四篇,将会着重于如何写一个功能更丰富的插件,并发布到Jcenter中,应用到我们的项目之中。
网友评论