Gradle 1.12用户指南翻译——第三十八章. Eclipse 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见:
http://blog.csdn.net/column/details/gradle-translation.html
翻译项目请关注Github上的地址:
https://github.com/msdx/gradledoc
本文翻译所在分支:
https://github.com/msdx/gradledoc/tree/1.12。
直接浏览双语版的文档请访问:
http://gradledoc.qiniudn.com/1.12/userguide/userguide.html。
另外,Android 手机用户可通过我写的一个程序浏览文档,带缓存功能的,目前0.2.1版本兼容 android 2.2以上系统,地址如下:
http://www.wandoujia.com/apps/com.githang.gradledoc
翻译不易,转载请注明本文在CSDN博客上的出处:
http://blog.csdn.net/maosidiaoxian/article/details/46963851
关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。如有发现翻译有误的地方,将首先在以上两个地方更新。因时间精力问题,博客中发表的译文基本不会同步修改。
第三十八章. Eclipse 插件
Eclipse 插件生成Eclipse
IDE所使用的文件,从而让项目能够导入 Eclipse (File - Import... - Existing
Projects into Workspace)。它考虑到了外部依赖项 (包括相关联的源文件和 javadoc 文件) 和项目依赖项。
从 1.0-里程碑-4 开始,WTP-generating 代码被重构为一个单独的插件,叫做eclipse-wtp
。所以如果你对
WTP 集成有兴趣,可以只应用eclipse-wtp
插件。否则应用eclipse
插件就足够了。这种变化是Eclipse用户要求的,他们想利用war
或ear
插件,但又不想用
Eclipse WTP。在内部,eclipse
也应用了
wtpeclipse
插件,所以你不需要同时应用这两个插件。
Eclipse 插件生成的内容完全取决于使用了哪些其他的插件:
表 38.1. Eclipse 插件行为
Eclipse 插件是开放的,以定制和提供一套标准化的钩,用于添加和删除生成的文件的内容。
38.1.
用法
要使用 Eclipse 插件,请在构建脚本中包含以下语句:
示例 38.1. 使用 Eclipse 插件
build.gradle
apply plugin: 'eclipse'
Eclipse 插件向你的projects 添加了大量的任务。您将使用的主要任务是eclipse
和cleanEclipse
任务。
38.2.
任务
Eclipse 插件向一个 project 添加了如下所示的任务。
表 38.2. Eclipse 插件 - 任务
任务名称 | 依赖于 | 类型 | 描述 |
eclipse |
eclipseProject , eclipseClasspath ,eclipseJdt , eclipseWtpComponent , cleanEclipseWtpFacet |
Task |
会生成所有的 Eclipse 配置文件 |
cleanEclipse |
cleanEclipseProject , cleanEclipseClasspath , cleanEclipseJdt , cleanEclipseWtpComponent ,
|
Delete |
删除所有的 Eclipse 配置文件 |
cleanEclipseProject |
- |
Delete |
删除.project 文件。 |
cleanEclipseClasspath |
- |
Delete |
删除.classpath 文件。 |
cleanEclipseJdt |
- |
Delete |
删除.settings/org.eclipse.jdt.core.prefs 文件。 |
cleanEclipseWtpComponent |
- |
Delete |
删除.settings/org.eclipse.wst.common.component 文件。 |
cleanEclipseWtpFacet |
- |
Delete |
删除.settings/org.eclipse.wst.common.component 文件。 |
eclipseProject |
- |
GenerateEclipseProject |
生成的.project 文件。 |
eclipseClasspath |
- |
GenerateEclipseClasspath |
生成.classpath 文件。 |
eclipseJdt |
- |
GenerateEclipseJdt |
生成.settings/org.eclipse.jdt.core.prefs 文件。 |
eclipseWtpComponent |
- |
GenerateEclipseWtpComponent |
只有当eclipse-wtp 插件应用的时候,生成 .settings/org.eclipse.wst.common.component 文件。 |
eclipseWtpFacet |
- |
GenerateEclipseWtpFacet |
只有当eclipse-wtp 插件应用的时候,生成 文件。 |
38.3.
配置
表 38.3. Eclipse 插件的配置
模型 | 引用名称 | 描述 |
EclipseModel |
eclipse |
顶级元素,以DSL友好的方式启用 Eclipse 插件的配置 |
EclipseProject |
eclipse.project |
允许配置项目信息 |
EclipseClasspath |
eclipse.classpath |
允许配置类路径信息 |
EclipseJdt |
eclipse.jdt |
允许配置 jdt 信息 (source/target java 兼容性) |
EclipseWtpComponent |
eclipse.wtp.component |
仅当eclipse-wtp 插件被应用时,允许配置wtp 组件信息。 |
EclipseWtpFacet |
eclipse.wtp.facet |
仅当eclipse-wtp 插件被应用时,允许配置wtp 方面信息。 |
38.4.
自定义生成的文件
Eclipse 插件允许您自定义生成的元数据文件。该插件提供一个 DSL,用于配置把该 project 的Eclipse 视图做成模型的模型对象。然后把这些模型对象与现有的 Eclipse XML 元数据进行合并,最终生成新的元数据。模型对象提供了低级别的hook,用于处理在合并模型配置前后表示文件内容的域对象。他们还提供了一个非常低级别的hook,用于直接处理原始 XML 持久化之前的调整,微调和配置使 Eclipse 插件不进行建模。
38.4.1.
合并
已存在的Eclipse 文件的部分,也是生成的目标内容,将会被修改或覆盖,具体取决于特定的部分。剩余的部分则不变。
38.4.1.1.
禁用完全覆盖的合并
若要完全覆盖现有 Eclipse 文件,请执行clean任务和其相应的生成任务,例如gradle
(按此顺序)。如果你想要让它成为默认行为,请将
cleanEclipse eclipsetasks.eclipse.dependsOn(cleanEclipse)
添加到构建脚本。这样一来,我们就没有必要显式执行
clean 任务。
完全覆盖同样可以用于个人文件,例如通过执行gradle
。
cleanEclipseClasspath eclipseClasspath
38.4.2. Hooking到生成的生命周期中
Eclipse 插件提供了一些对象,对由 Gradle 生成的 Eclipse 文件的段落进行建模。生成的生命周期如下:
- 读取文件;如果它不存在,则使用由 Gradle 提供的默认版本
beforeMerged
的
hook 会随着一个表示现有文件的域对象执行- 从 Gradle 构建推断出来或在 eclipse DSL 中显示定义的配置会与现有的内容合并在一起
whenMerged
的
hook 会随着一个表示持久化的域对象执行withXml
的 hook
会随着一个表示将被持久化的XML的 raw 执行- 最终的 XML 被持久化
下表列出了用于每个 Eclipse 模型类型的域对象:
表 38.4. 高级的配置hook
模型 |
beforeMerged 参数类型 |
whenMerged 参数类型 |
withXml 参数类型 |
EclipseProject |
Project |
Project |
XmlProvider |
EclipseClasspath |
Classpath |
Classpath |
XmlProvider |
EclipseJdt |
Jdt |
Jdt |
|
EclipseWtpComponent |
WtpComponent |
WtpComponent |
XmlProvider |
EclipseWtpFacet |
WtpFacet |
WtpFacet |
XmlProvider |
38.4.2.1.
部分重写现有内容
一个完全覆盖会导致现有的所有内容被丢弃,从而丢失在
IDE 中直接做的任何修改。另外, beforeMerged
hook
可以实现只覆盖现有的某些部分的内容。下面的示例从Classpath
域对象中删除现有的所有依赖关系:
示例 38.2. 部分覆盖 Classpath
build.gradle
eclipse.classpath.file { beforeMerged { classpath -> classpath.entries.removeAll { entry -> entry.kind == 'lib' || entry.kind == 'var' } } }
生成的.classpath
文件将只包含
Gradle 生成的依赖项,而没有其他可能存在于原始文件的依赖项。(对于依赖项,这也是默认行为。)其他部分的.classpath
文件将会被合并或者保留。对.project
文件中的natures的处理也是一样:
示例 38.3. 部分覆盖项目
build.gradle
eclipse.project.file.beforeMerged { project -> project.natures.clear() }
38.4.2.2.
修改完全填充的域对象
WhenMerged
hook
允许操作完全填充的域对象。通常,这是自定义 Eclipse 文件的首选的方法。下面的例子展示了如何导出一个 Eclipse 项目的所有依赖项:
示例 38.4. 导出依赖项
build.gradle
eclipse.classpath.file { whenMerged { classpath -> classpath.entries.findAll { entry -> entry.kind == 'lib' }*.exported = false } }
38.4.2.3.
修改 XML 的表示形式
WithXml
hook
允许在文件写入到磁盘之前,操纵内存中的 XML 的表示形式。尽管 Groovy 的 XML 支持对其有很大作用,但这种方法比起操纵域对象依然不大方便 。作为回报,你可以对生成的文件进行全面的控制,包括未由域对象建模的那些部分。
示例 38.5. 自定义 XML
build.gradle
apply plugin: 'eclipse-wtp' eclipse.wtp.facet.file.withXml { provider -> provider.asNode().fixed.find { it.@facet == 'jst.java' }.@facet = 'jst2.java' }
Gradle 1.12用户指南翻译——第三十八章. Eclipse 插件的更多相关文章
- Gradle 1.12用户指南翻译——第四十八章. Wrapper 插件
本文由CSDN博客貌似掉线翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
- Gradle 1.12用户指南翻译——第三十一章. FindBugs 插件
其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Github上的地址: https://g ...
- Gradle 1.12用户指南翻译——第三十九章. IDEA 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
- Gradle 1.12用户指南翻译——第三十七章. OSGi 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
- Gradle 1.12用户指南翻译——第三十六章. Sonar Runner 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
- Gradle 1.12用户指南翻译——第三十五章. Sonar 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
- Gradle 1.12用户指南翻译——第三十四章. JaCoCo 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
- Gradle 1.12用户指南翻译——第三十三章. PMD 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
- Gradle 1.12用户指南翻译——第三十二章. JDepend 插件
本文由CSDN博客万一博主翻译,其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Githu ...
随机推荐
- 重写方法的利器-super
重写方法的利器-super class ilist(list): def __init__(self,dft=None,r=list()): super(ilist, self).__init__(r ...
- android开发之this.finish()的使用
在一个Activity用完之后应该将之finish掉,但是,之前在学校里自己摸索着开发时并没有太注意这个问题,因为activity无论是否finish掉对功能的影响貌似都不是那么明显(这是读书时候的观 ...
- 调用MediaScannerConnection 发生内存泄露的解决方法
调用MediaScannerConnection发起扫描时经常会发生内存泄露,例如: E ActivityThread: Activity FolderListActivity has leaked ...
- python的subprocess:子程序调用(调用执行其他命令);获取子程序脚本当前路径问题
python当前进程可以调用子进程,子进程可以执行其他命令,如shell,python,java,c... 而调用子进程方法有 os模块 参见:http://blog.csdn.net/longshe ...
- Android初级教程获取手机系统联系人信息
在手机内部,对联系人信息存在对应的数据库.我们创建的而联系人信息都存在这张表中.如下是对数据库的截图,我已经对表和应该注意的地方做了红笔标注: 好了,现在可以根据数据库里面的数据来写代码了. 代码如下 ...
- CoordinatorLayout 自定义Behavior并不难,由简到难手把手带你撸三款!
先来看看最终的效果~~ 本文同步至博主的私人博客wing的地方酒馆 嗯..一个是头像上移的 另一个是模仿UC浏览器的. (PД`q.)你不是说!有三款的吗,怎么只有两款!!!! 不要急嘛... 说了从 ...
- 深入浅出Java MVC(Model View Controller) ---- (JSP + servlet + javabean实例)
在DRP中终于接触到了MVC,感触是确实这样的架构系统灵活性不少,现在感触最深的就是使用tomcat作为服务器发布比IIS好多了,起码发布很简单,使用起来方便. 首先来简单的学习一下MVC的基础知识, ...
- UNIX环境高级编程——线程属性之分离属性
说到线程的分离状态,我认为,之所以会有这个状态,是因为系统对某些线程的终止状态根本不感兴趣导致的. 我们知道,进程中的线程可以调用: int pthread_join(pthread_t tid, v ...
- Java中引用传递
//Java中的引用传递 class Ref1{ int temp = 10 ; String Str = "hello"; } public class HelloWorld { ...
- Cocos2D:塔防游戏制作之旅(十五)
Yes,貌似添加了好多的代码啊 ;] ,在你添加更多代码时,你可能注意到一些Xcode中的一些警告.首先你先忽略这些警告,我们先添加少量最终缺失的部分,然后再来解释上面代码做了什么! 在Enemy.m ...