diff --git a/README.md b/README.md index a4ddd01..cb8aa10 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ * [Github托管地址](https://github.com/DONGChuan/GradleUserGuide) -* [原文地址](https://docs.gradle.org/current/userguide/userguide.html) 请注意 目前翻译版本是 **2.4** +* [原文地址](https://docs.gradle.org/current/userguide/userguide.html) * 我们会开放权限给每一个加入的伙伴 (翻译或者校对),请提前邮箱联系 dongchuan55@gmail.com ---- diff --git a/SUMMARY.md b/SUMMARY.md index 56c0565..c4e36de 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -111,31 +111,41 @@ * [File collections](working_with_files/file_collections.md) * [使用 Ant 插件](using_ant_from_gradle/using_ant_from_gradle.md) * [使用 Ant 任务和 Ant 类型的构建](using_ant_from_gradle/using_ant_tasks_and_types_in_your_build.md) - * [在构建中使用自定义Ant任务](using_ant_from_gradle/using_custom_ant_tasks_in_your_build.md) - * [导入一个Ant构建](using_ant_from_gradle/importing_an_ant_build.md) - * [Ant的属性与引用](using_ant_from_gradle/ant_properties_and_references.md) + * [在构建中使用自定义 Ant 任务](using_ant_from_gradle/using_custom_ant_tasks_in_your_build.md) + * [导入一个 Ant 构建](using_ant_from_gradle/importing_an_ant_build.md) + * [Ant 的属性与引用](using_ant_from_gradle/ant_properties_and_references.md) * [API](using_ant_from_gradle/API.md) * [Logging](logging/logging.md) * [选择日志等级](logging/choosing_a_log_level.md) * [编写自己的日志信息](logging/writing_your_own_log_messages.md) * [外部工具和库的log](logging/logging_from_external_tools_and_libraries.md) - * [改变Gradle记录的内容](logging/changing_what_gradle_logs.md) -* [Java插件](the_java_plugin/README.md) - * [使用](the_java_plugin/Useage.md) - * [资源集](the_java_plugin/Source sets.md) - * [任务](the_java_plugin/Test.md) - * [项目布局](the_java_plugin/project_layout.md) - * [依赖管理](the_java_plugin/Dependency management.md) - * [公共配置](the_java_plugin/Convention properties.md) - * [使用资源集工作](the_java_plugin/Working with source sets.md) - * [Javadoc](the_java_plugin/Javadoc.md) - * [清除](the_java_plugin/Clean.md) - * [资源](the_java_plugin/Resources.md) - * [编译Java](the_java_plugin/CompileJava.md) - * [增量Java编译](the_java_plugin/Incremental Java compilation.md) - * [测试](the_java_plugin/Test.md) - * [Jar](the_java_plugin/Jar.md) - * [上传](the_java_plugin/Uploading.md) + * [改变 Gradle 记录的内容](logging/changing_what_gradle_logs.md) +* [Java 插件](the_java_plugin/README.md) + * [使用](the_java_plugin/java_plugin_usage.md) + * [资源集](the_java_plugin/java_plugin_source_sets.md) + * [任务](the_java_plugin/java_plugin_tasks.md) + * [项目布局](the_java_plugin/java_plugin_project_layout.md) + * [依赖管理](the_java_plugin/java_plugin_dependency_management.md) + * [公共配置](the_java_plugin/java_plugin_convention_properties.md) + * [使用资源集工作](the_java_plugin/java_plugin_working_with_source_sets.md) + * [Javadoc](the_java_plugin/java_plugin_javadoc.md) + * [清除](the_java_plugin/java_plugin_clean.md) + * [资源](the_java_plugin/java_plugin_resources.md) + * [编译 Java](the_java_plugin/java_plugin_compile_java.md) + * [增量 Java 编译](the_java_plugin/Ijava_plugin_incremental_java_compilation.md) + * [测试](the_java_plugin/java_plugin_test.md) + * [测试执行](the_java_plugin/test_execution.md) + * [测试调试](the_java_plugin/test_debugging.md) + * [测试过滤](the_java_plugin/test_filtering.md) + * [通过系统属性执行单独测试](the_java_plugin/test_single_test_execution_via_system_properties.md) + * [测试检测](the_java_plugin/test_detection.md) + * [测试分组](the_java_plugin/test_grouping.md.md) + * [测试报告](the_java_plugin/test_reporting.md) + * [TestNG 的参数化方法和报告](the_java_plugin/test_testNG_parameterized_methods_and_reporting.md.md) + * [公共值](the_java_plugin/test_convention_values.md) + * [Jar](the_java_plugin/java_plugin_jar.md) + * [Manifest](the_java_plugin/java_plugin_manifest.md) + * [上传](the_java_plugin/java_plugin_uploading.md.md) * [War插件](the_war_plugin/the_war_plugin.md) * [使用](the_war_plugin/usage.md) * [任务](the_war_plugin/tasks.md) diff --git a/logging/logging.md b/logging/logging.md index 56571f3..5da0085 100644 --- a/logging/logging.md +++ b/logging/logging.md @@ -1,6 +1,6 @@ # Logging -Log是构建的主要"UI"工具.如果日志太过冗长,那么真正的警告和问题会隐藏其中,另一方面,如果你出错了,你又需要搞清楚相关错误信息.Gradle提供了6个等级的log,如[表17.1.Logs Level]()所示.出了那些你可能经常看到的,还有两个是Gradle特定级别的日志,被称为*QUIET*和*LIFECYCLE*.后者是默认的,并用于报告生成进度. +Log 是构建的主要"UI"工具. 如果日志太过冗长, 那么真正的警告和问题会隐藏其中, 另一方面, 如果你出错了,你又需要搞清楚相关错误信息. Gradle 提供了6个等级的 log, 如[表17.1.Logs Level]()所示.出了那些你可能经常看到的, 还有两个是 Gradle 特定级别的日志,被称为*QUIET*和*LIFECYCLE*.后者是默认的, 并用于报告生成进度. **表17.1.Logs Level** diff --git a/logging/logging_from_external_tools_and_libraries.md b/logging/logging_from_external_tools_and_libraries.md index 49a093c..165518e 100644 --- a/logging/logging_from_external_tools_and_libraries.md +++ b/logging/logging_from_external_tools_and_libraries.md @@ -1,6 +1,10 @@ # 从外部工具和库记录日志 -在内部,Gradle使用Ant和lvy,都有自己的log系统,Gradle重定向他们的日志输出到Gradle日志系统.除了Ant/lvy的`TRACE`级别的日志,映射到Gradle的`DEBUG`级别,其余的都会有一个1:1的映射从Ant/lvy的日志等级到Gradlede 的日志等级.这意味着默认的Gradle日志级别将不会显示任何的Ant /lvy的输出,除非它是一个错误或警告。 +在内部, Gradle 使用 Ant 和 lvy , +都有自己的 log 系统, +Gradle 重定向他们的日志输出到 Gradle 日志系统. +除了Ant/lvy的`TRACE`级别的日志, 映射到Gradle的`DEBUG`级别, 其余的都会有一个1:1的映射从 Ant/lvy 的日志等级到 Gradle 的日志等级. +这意味着默认的 Gradle 日志级别将不会显示任何的 Ant /lvy 的输出, 除非它是一个错误或警告. 有许多工具仍然使用标准输出记录,默认的,Gradle将标准输出重定向到`QUIET`的日志级别和标准错误的`ERROR`级别.该行为是可配置的.该项目对象提供了一个[LoggerManager](https://docs.gradle.org/current/javadoc/org/gradle/api/logging/LoggingManager.html),当你构建脚本进行评估的时候,允许你改变标准输出或错误重定向的日志级别。 diff --git a/the_java_plugin/Changing the project layout.md b/the_java_plugin/Changing the project layout.md deleted file mode 100644 index 0d5008b..0000000 --- a/the_java_plugin/Changing the project layout.md +++ /dev/null @@ -1,19 +0,0 @@ -### 22.4.1.改变项目布局 -可以通过配置适当的源组配置项目布局,更多细节会在后面的章节中讨论,下面是一个配置了 java 和 resource 的简单的例子 - -**例22.2.自定义 Java 源码布局** - -**build.gradle** - -``` -sourceSet{ - main{ - java{ - srcDir 'src/java' - } - resources{ - srcDir 'src/resources' - } - } -} -``` diff --git a/the_java_plugin/Convention properties.md b/the_java_plugin/Convention properties.md deleted file mode 100644 index 02ce165..0000000 --- a/the_java_plugin/Convention properties.md +++ /dev/null @@ -1,43 +0,0 @@ -## 22.7.使用sourceSet工作 -可以使用sourceSet属性进行sourceSet,这是一个[SourceSetContainer](https://docs.gradle.org/current/javadoc/org/gradle/api/tasks/SourceSetContainer.html)类型的项目的sourceSet容器.还可以通过sourceSet{}脚本块来配置sourceSet容器,sourceSet容器的工作方式基本与其他容器比如task的工作方式相同. - -**例22.3.访问sourceSet** - -**build.gradle** - -``` -//通过不同方式访问source set -println sourceSets.main.output.classesDir -println sourceSets['main'].output.classesDir -sourceSets{ - println main.output.classesDir -} -sourceSets{ - main{ - println output.classesDir - } -} -// 遍历sourceSets -sourceSets.all{ - println name -} -``` - -配置现有的source set,只需要用上述的一种方式访问并设置source set,source set的配置如下所示,下面的例子主要配置了Java的main与resources目录: - -**例22.4.配置一个source Set的资源路径** - -**build.gradle** - -``` -sourceSets { - main { - java { - srcDir 'src/java' - } - resources { - srcDir 'src/resources' - } - } -} -``` diff --git a/the_java_plugin/Dependency management.md b/the_java_plugin/Dependency management.md deleted file mode 100644 index bbc76de..0000000 --- a/the_java_plugin/Dependency management.md +++ /dev/null @@ -1,33 +0,0 @@ -## 22.6.公共配置 -Java插件会为project添加一些列的公共配置对象,如下所示,可以在构建脚本中使用这写属性,就像它们是该项目对象的属性(see [???](https://docs.gradle.org/current/userguide/java_plugin.html)). - -**表22.7.Java插件-目录属性** - -属性名称 | 类型 | 默认值 | 描述 ----------------------- | ---------------- | ------------------------------- | ---------------------------- -reportsDirName | String | reports | 在构建目录的生成报告的文件夹名 -reportsDir | File (read-only) | buildDir/reportsDirName | 该目录下会生成报告 -testResultsDirName | String | test-results | 在构建目录的测试结果的result.xml的存放目录名 -testResultsDir | File (read-only) | buildDir/testResultsDirName | 测试结果的 result.xml 文件会存放在该文件夹中 -testReportDirName | String | tests | 在构建目录的测试报告的文件夹名 -testReportDir | File (read-only) | reportsDir/testReportDirName | 测试的测试报告会存放在该目录下 -libsDirName | String | libs | 在构建目录下的类库文件夹名 -libsDir | File (read-only) | buildDir/libsDirName | 该目录下存放类库 -distsDirName | String | distributions | 在构建目录下的distributions文件夹名 -distsDir | File (read-only) | buildDir/distsDirName | 该目录下存放生成的distributions -docsDirName | String | 在构建目录下的doc文件夹名 | -docsDir | File (read-only) | buildDir/docsDirName | 该目录下存放生成的文档 -dependencyCacheDirName | String | dependency-cache | 在构建目录下的依赖缓存文件夹名 -dependencyCacheDir | File (read-only) | buildDir/dependencyCacheDirName | 该目录用来缓存源依赖信息。 - - **表22.8.Java插件-其他配置** - -属性名称 | 类型 | 默认值 | 描述 -------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------- | --------------------- -sourceSets | [SourceSetContainer](https://docs.gradle.org/current/javadoc/org/gradle/api/tasks/SourceSetContainer.html) | Not null | 包含项目的sourceSet -sourceCompatibility | [JavaVersion](https://docs.gradle.org/current/javadoc/org/gradle/api/JavaVersion.html).也可以使用String类型或Number类型,如'1.5' 或 1.5 | 当前使用的JVM版本 | 编译Java源码时所使用的Java兼容版本 -targetCompatibility | [JavaVersion](https://docs.gradle.org/current/javadoc/org/gradle/api/JavaVersion.html).也可以使用String类型或Number类型,如'1.5' 或 1.5 | sourceCompatibility | 生成class文件的Java版本 -archivesBaseName | String | projectName | 用于.jar文件或者.zip存档的基本名称 -manifest | [Mainfest](https://docs.gradle.org/current/javadoc/org/gradle/api/java/archives/Manifest.html) | an empty manifest | 该清单中包括所有的JAR文件 - - 按照[JavaPluginConvention](https://docs.gradle.org/current/dsl/org.gradle.api.plugins.JavaPluginConvention.html)和[BasePluginConvention](https://docs.gradle.org/current/dsl/org.gradle.api.plugins.BasePluginConvention.html)类型提供这些属性. diff --git a/the_java_plugin/Dependency_management.md b/the_java_plugin/Dependency_management.md deleted file mode 100644 index dd32590..0000000 --- a/the_java_plugin/Dependency_management.md +++ /dev/null @@ -1,24 +0,0 @@ -## 22.5.依赖管理 -Java插件给project增加了相关配置,如下所示,这些配置被分配成像compileJava和test等配置 - -**表22.5.Java插件-依赖配置** - -名称 | 扩展 | 运行任务 | 含义 ------------ | ------- | --------------- | ----------------------------- -compile | - | compileJava | 编译时的依赖 -runtime | compile | - | 运行时的依赖 -testCompile | compile | compileTestJava | 编译测试所需的额外依赖 -testRuntime | runtime | test | 仅供运行测试的额外依赖 -archives | - | uploadArchives | 项目产生的信息单元(如:jar包) -default | runtime | - | 使用其他项目的默认依赖项,包括该项目产生的信息单元以及依赖 - -**图22.2.Java插件-依赖配置** ![java plugin-dependency configurations](https://docs.gradle.org/current/userguide/img/javaPluginConfigurations.png) - -对于每个添加到该项目的sourceSet,java插件会添加一下的依赖配置 - -**表22.6.Java插件-sourceSet依赖关系配置** - -名称 | 扩展 | 被使用时运行的任务 | 含义 ----------------- | -- | -------------------- | ----------------- -sourceSetCompile | - | compileSourceSetJava | 编译时给定sourceSet的依赖 -sourceSetRuntime | - | - | 运行时给定sourceSet的依赖 diff --git a/the_java_plugin/Javadoc.md b/the_java_plugin/Javadoc.md deleted file mode 100644 index c925a0b..0000000 --- a/the_java_plugin/Javadoc.md +++ /dev/null @@ -1,11 +0,0 @@ -## 22.8.Javadoc -java任务是一个[Javadoc](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.javadoc.Javadoc.html)的实例.它支持Javadoc的核心选项和可执行的Javadoc的[reference documentation](http://download.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html#referenceguide)中描述的标准JavaTOC的选项。有关支持Javadoc选项的完整列表,请参阅以下类的API文档:[CoreJavadocOptions](https://docs.gradle.org/current/javadoc/org/gradle/external/javadoc/CoreJavadocOptions.html)和[StandardJavadocDocletOptions](https://docs.gradle.org/current/javadoc/org/gradle/external/javadoc/StandardJavadocDocletOptions.html). - -**表22.10.java插件-javadoc配置** - -任务属性 | 类型 | 默认值 --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- -classpath | [FileCollection](https://docs.gradle.org/current/javadoc/org/gradle/api/file/FileCollection.html) | sourceSets.main.output + sourceSets.main.compileClasspath -source | [FileTree](https://docs.gradle.org/current/javadoc/org/gradle/api/file/FileTree.html).可以设置为在[Section 15.5, “Specifying a set of input files”](https://docs.gradle.org/current/userguide/working_with_files.html#sec:specifying_multiple_files)中描述的任何值 | sourceSets.main.allJava -destinationDir | File | docsDir/javadoc -title | String | project的name和version diff --git a/the_java_plugin/Project_layout.md b/the_java_plugin/Project_layout.md deleted file mode 100644 index c18bbc6..0000000 --- a/the_java_plugin/Project_layout.md +++ /dev/null @@ -1,14 +0,0 @@ -# 22.4.项目布局 - -Java 插件的默认布局如下图所示,无论这些文件夹中有没有内容,Java插件都会编译里面的内容,并处理缺失的内容。 - -**表22.4.java 插件-默认布局** - -目录 | 含义 ------------------------ | -------------------- -src/main/java | 主要 Java 源码 -src/main/resources | 主要资源 -src/test/java | 测试 Java 源码 -src/test/resources | 测试资源 -src/sourceSet/java | 指定sourceSet的 Java 源码 -src/sourceSet/resources | 指定sourceSet的资源 diff --git a/the_java_plugin/Source sets.md b/the_java_plugin/Source sets.md deleted file mode 100644 index a229e3b..0000000 --- a/the_java_plugin/Source sets.md +++ /dev/null @@ -1,7 +0,0 @@ -# 22.2.资源集 - -Java 插件引入了__Source Set__的概念,sourceSet就是一组编译和执行的文件。 这些源文件可能包含 Java 的源文件以及一些资源文件。 其他的插件可能还会在 sourceSet 中包含 Groovy 和 Scala 的源文件,sourceSet有一个与之关联的编译classpath和运行classpath。 - -使用 sourceSet 的目的是为了将源文件根据它们的目的去归档到不同的逻辑组,举个例子,你可以使用一个sourceSet来定义一个集成测试套件 也可以使用另外的源组来定义你项目的 API 和实现类。 - -Java 插件定义了两个标准 sourceSet,分别为`main`和`test`,`main`sourceSet中包含了生产代码并且会编译并组装成 Jar 文件, `test`sourceSet包括了测试代码并且会使用JUnit或者TestNG编译和执行。它们可以是单元测试,集成测试,验收测试或者任何对你有用的测试集。 diff --git a/the_java_plugin/Uploading.md b/the_java_plugin/Uploading.md deleted file mode 100644 index 12f7ed7..0000000 --- a/the_java_plugin/Uploading.md +++ /dev/null @@ -1,7 +0,0 @@ -## 22.15.上传 - -如何上传archives在[Chapter 51, Publishing artifacts](https://docs.gradle.org/2.4/userguide/artifact_management.html) -------- -[[9](https://docs.gradle.org/2.4/userguide/java_plugin.html#N12A26)]JUnit的维基包含有关如何使用JUnit类工作的详细说明:https://github.com/junit-team/junit/wiki/Categories. - -[[10](https://docs.gradle.org/2.4/userguide/java_plugin.html#N12A26)]TestNG的文档包含关于测试组的更多详细信息:http://testng.org/doc/documentation-main.html#test-groups. diff --git a/the_java_plugin/Useage.md b/the_java_plugin/Useage.md deleted file mode 100644 index b4cf093..0000000 --- a/the_java_plugin/Useage.md +++ /dev/null @@ -1,11 +0,0 @@ -# 22.1.用法 - -要使用 Java 脚本, 需要在构建脚本中加入如下内容 - -**例子 22.1.使用 Java 插件** - -**bulid.gradle** - -``` -apply plugin: 'java' -``` diff --git a/the_java_plugin/Clean.md b/the_java_plugin/java_plugin_clean.md similarity index 100% rename from the_java_plugin/Clean.md rename to the_java_plugin/java_plugin_clean.md diff --git a/the_java_plugin/CompileJava.md b/the_java_plugin/java_plugin_compile_java.md similarity index 100% rename from the_java_plugin/CompileJava.md rename to the_java_plugin/java_plugin_compile_java.md diff --git a/the_java_plugin/Incremental Java compilation.md b/the_java_plugin/java_plugin_incremental_java_compilation.md similarity index 99% rename from the_java_plugin/Incremental Java compilation.md rename to the_java_plugin/java_plugin_incremental_java_compilation.md index e1939a5..3060619 100644 --- a/the_java_plugin/Incremental Java compilation.md +++ b/the_java_plugin/java_plugin_incremental_java_compilation.md @@ -1,4 +1,5 @@ ## 22.12.增量Java编译 + 从Gradle2.1开始,可以使用Java增量编译,此功能正在孵化,参见[JavaCompile](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.compile.JavaCompile.html)如何启用这个功能. 增量编译的主要目标如下: - 避免在没必要编译的java编译资源上浪费时间.这意味着更快构建,尤其是在改变一些class与jar的时候,不需要再次编译那些不依赖这些class与jar的文件. - 尽可能地少输出class.类不需要重新编译意味着保持输出目录不变。一个示例场景中,真正使用JRebel的真正有用的是 - 越少的输出类被改变,JVM可以使用越快刷新。 diff --git a/the_java_plugin/Jar.md b/the_java_plugin/java_plugin_jar.md similarity index 99% rename from the_java_plugin/Jar.md rename to the_java_plugin/java_plugin_jar.md index 51a931c..8f00a85 100644 --- a/the_java_plugin/Jar.md +++ b/the_java_plugin/java_plugin_jar.md @@ -1,2 +1,3 @@ ## 22.14.Jar + jar任务创建包含项目的类文件和资源的JAR文件.JAR文件在archives的依赖配置中是作为一个artifact的声明.这意味着,JAR是相关项目一个可用的classpath.如果您上传您的项目到存储库,这个JAR会被声明为依赖描述符的一部分.可以再[Section 15.8, “Creating archives”](https://docs.gradle.org/2.4/userguide/working_with_files.html#sec:archives)与[Chapter 51, Publishing artifacts](https://docs.gradle.org/2.4/userguide/artifact_management.html)中了解更多关于JAR与archives与artifact configurations协同工作的更多细节. diff --git a/the_java_plugin/java_plugin_javadoc.md b/the_java_plugin/java_plugin_javadoc.md index ffa7574..c925a0b 100644 --- a/the_java_plugin/java_plugin_javadoc.md +++ b/the_java_plugin/java_plugin_javadoc.md @@ -1 +1,11 @@ -# Java Plugin Javadoc +## 22.8.Javadoc +java任务是一个[Javadoc](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.javadoc.Javadoc.html)的实例.它支持Javadoc的核心选项和可执行的Javadoc的[reference documentation](http://download.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html#referenceguide)中描述的标准JavaTOC的选项。有关支持Javadoc选项的完整列表,请参阅以下类的API文档:[CoreJavadocOptions](https://docs.gradle.org/current/javadoc/org/gradle/external/javadoc/CoreJavadocOptions.html)和[StandardJavadocDocletOptions](https://docs.gradle.org/current/javadoc/org/gradle/external/javadoc/StandardJavadocDocletOptions.html). + +**表22.10.java插件-javadoc配置** + +任务属性 | 类型 | 默认值 +-------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- +classpath | [FileCollection](https://docs.gradle.org/current/javadoc/org/gradle/api/file/FileCollection.html) | sourceSets.main.output + sourceSets.main.compileClasspath +source | [FileTree](https://docs.gradle.org/current/javadoc/org/gradle/api/file/FileTree.html).可以设置为在[Section 15.5, “Specifying a set of input files”](https://docs.gradle.org/current/userguide/working_with_files.html#sec:specifying_multiple_files)中描述的任何值 | sourceSets.main.allJava +destinationDir | File | docsDir/javadoc +title | String | project的name和version diff --git a/the_java_plugin/Manifest.md b/the_java_plugin/java_plugin_manifest.md similarity index 100% rename from the_java_plugin/Manifest.md rename to the_java_plugin/java_plugin_manifest.md diff --git a/the_java_plugin/Resources.md b/the_java_plugin/java_plugin_resources.md similarity index 100% rename from the_java_plugin/Resources.md rename to the_java_plugin/java_plugin_resources.md diff --git a/the_java_plugin/Test.md b/the_java_plugin/java_plugin_test.md similarity index 99% rename from the_java_plugin/Test.md rename to the_java_plugin/java_plugin_test.md index 764925a..49daff0 100644 --- a/the_java_plugin/Test.md +++ b/the_java_plugin/java_plugin_test.md @@ -1,2 +1,3 @@ ## 22.13.测试 + test任务是[Test](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.testing.Test.html)的一个实例.它会在测试source set自动检测并执行所有的单元测试,并且在测试执行完成后会生成一份测试报告.task任务支持JUnit和TestNG.在[Test](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.testing.Test.html)查看完整地API. diff --git a/the_java_plugin/java_plugin_uploading.md b/the_java_plugin/java_plugin_uploading.md index 6402551..12f7ed7 100644 --- a/the_java_plugin/java_plugin_uploading.md +++ b/the_java_plugin/java_plugin_uploading.md @@ -1 +1,7 @@ -# Java Plugin Uploading +## 22.15.上传 + +如何上传archives在[Chapter 51, Publishing artifacts](https://docs.gradle.org/2.4/userguide/artifact_management.html) +------- +[[9](https://docs.gradle.org/2.4/userguide/java_plugin.html#N12A26)]JUnit的维基包含有关如何使用JUnit类工作的详细说明:https://github.com/junit-team/junit/wiki/Categories. + +[[10](https://docs.gradle.org/2.4/userguide/java_plugin.html#N12A26)]TestNG的文档包含关于测试组的更多详细信息:http://testng.org/doc/documentation-main.html#test-groups. diff --git a/the_java_plugin/Convention values.md b/the_java_plugin/test_convention_values.md similarity index 100% rename from the_java_plugin/Convention values.md rename to the_java_plugin/test_convention_values.md diff --git a/the_java_plugin/Debugging.md b/the_java_plugin/test_debugging.md similarity index 100% rename from the_java_plugin/Debugging.md rename to the_java_plugin/test_debugging.md diff --git a/the_java_plugin/Test detection.md b/the_java_plugin/test_detection.md similarity index 100% rename from the_java_plugin/Test detection.md rename to the_java_plugin/test_detection.md diff --git a/the_java_plugin/Test execution.md b/the_java_plugin/test_execution.md similarity index 100% rename from the_java_plugin/Test execution.md rename to the_java_plugin/test_execution.md diff --git a/the_java_plugin/Test filtering.md b/the_java_plugin/test_filtering.md similarity index 100% rename from the_java_plugin/Test filtering.md rename to the_java_plugin/test_filtering.md diff --git a/the_java_plugin/Test grouping.md b/the_java_plugin/test_grouping.md similarity index 100% rename from the_java_plugin/Test grouping.md rename to the_java_plugin/test_grouping.md diff --git a/the_java_plugin/Test reporting.md b/the_java_plugin/test_reporting.md similarity index 100% rename from the_java_plugin/Test reporting.md rename to the_java_plugin/test_reporting.md diff --git a/the_java_plugin/Single test execution via System Properties.md b/the_java_plugin/test_single_test_execution_via_system_properties.md similarity index 100% rename from the_java_plugin/Single test execution via System Properties.md rename to the_java_plugin/test_single_test_execution_via_system_properties.md diff --git a/the_java_plugin/TestNG parameterized methods and reporting.md b/the_java_plugin/test_testNG_parameterized_methods_and_reporting.md similarity index 89% rename from the_java_plugin/TestNG parameterized methods and reporting.md rename to the_java_plugin/test_testNG_parameterized_methods_and_reporting.md index bf218c7..5370fd0 100644 --- a/the_java_plugin/TestNG parameterized methods and reporting.md +++ b/the_java_plugin/test_testNG_parameterized_methods_and_reporting.md @@ -1,3 +1,3 @@ -#### 22.13.7.1.TestNG的参数化方法和报告 +#### 22.13.7.1.TestNG 的参数化方法和报告 TestNG支持[参数化方法](http://testng.org/doc/documentation-main.html#parameters),允许一个特定的测试方法使用不同的输入被执行多次。Gradle会在测试报告中包含该方法的参数值. 给出一个叫aTestMethod的测试方法,该方法有两个参数,在测试报告中会根据名字报告:aTestMethod(toStringValueOfParam1, toStringValueOfParam2). 这很容易识别的参数值的特定迭代. diff --git a/the_war_plugin/tasks.md b/the_war_plugin/tasks.md new file mode 100644 index 0000000..fb4ef6f --- /dev/null +++ b/the_war_plugin/tasks.md @@ -0,0 +1 @@ +# 任务 diff --git a/the_war_plugin/usage.md b/the_war_plugin/usage.md new file mode 100644 index 0000000..42589f2 --- /dev/null +++ b/the_war_plugin/usage.md @@ -0,0 +1 @@ +# 使用 diff --git a/using_ant_from_gradle/ant_properties_and_references.md b/using_ant_from_gradle/ant_properties_and_references.md index 21bb9cf..64e0b31 100644 --- a/using_ant_from_gradle/ant_properties_and_references.md +++ b/using_ant_from_gradle/ant_properties_and_references.md @@ -1,6 +1,6 @@ ## Ant的属性与引用 -有许多方法可以设定Ant属性,可以通过Ant任务使用属性.您可以直接在`AntBuilder`的实例设置属性。Ant的属性也可以作为一个可改变的`Map`.也可以使用Ant的任务属性,如下例所示: +有许多方法可以设定 Ant 属性,可以通过Ant任务使用属性.您可以直接在`AntBuilder`的实例设置属性。Ant的属性也可以作为一个可改变的`Map`.也可以使用Ant的任务属性,如下例所示: **例16.13.设置Ant属性** diff --git a/using_ant_from_gradle/importing_an_ant_build.md b/using_ant_from_gradle/importing_an_ant_build.md index c74b127..6991f5b 100644 --- a/using_ant_from_gradle/importing_an_ant_build.md +++ b/using_ant_from_gradle/importing_an_ant_build.md @@ -18,6 +18,8 @@ ant.importBuild 'build.xml' ``` `gradle hello`的输出 + +``` >\> gradle hello >:hello >[ant:echo] Hello, from Ant @@ -25,7 +27,7 @@ ant.importBuild 'build.xml' >BUILD SUCCESSFUL > >Total time: 1 secs - +``` 你可以添加一个依赖于`ant target`的任务: **例 16.9.依赖于ant target的任务** diff --git a/using_ant_from_gradle/using_custom_ant_tasks_in_your_build.md b/using_ant_from_gradle/using_custom_ant_tasks_in_your_build.md index 20f92a3..9aedf7c 100644 --- a/using_ant_from_gradle/using_custom_ant_tasks_in_your_build.md +++ b/using_ant_from_gradle/using_custom_ant_tasks_in_your_build.md @@ -1,8 +1,8 @@ ## 在构建中使用自定义Ant任务 -为了让你的构建可以自定义任务,你可以使用`taskdef(通常更容易)`或者`typedef`Ant任务,就像你在一个`build.xml`文件中一样.然后,您可以参考内置Ant任务去定制Ant任务. +为了让你的构建可以自定义任务, 你可以使用 `taskdef(通常更容易)` 或者 `typedef` Ant 任务, 就像你在一个`build.xml`文件中一样. 然后,你可以参考内置 Ant 任务去定制 Ant 任务. -**例 16.5.使用自定义Ant任务** +**例 16.5.使用自定义 Ant 任务** **build.gradle** ```gradle @@ -18,9 +18,9 @@ task check << { } ``` -你可以使用Gradle的依赖管理去组装你自定义任务所需要的classpath.要做到这一点,你需要定义一个自定义配置类路径,然后添加一些依赖配置.在[Section 51.4, “How to declare your dependencies”](https://docs.gradle.org/current/userguide/dependency_management.html#sec:how_to_declare_your_dependencies)部分有更详细的说明. +你可以使用 Gradle 的依赖管理去组装你自定义任务所需要的 classpath. 要做到这一点, 你需要定义一个自定义配置类路径, 然后添加一些依赖配置.在[Section 51.4, “How to declare your dependencies”](https://docs.gradle.org/current/userguide/dependency_management.html#sec:how_to_declare_your_dependencies)部分有更详细的说明. -**例 16.6.声明类路径的自定义Ant任务** +**例 16.6.声明类路径的自定义 Ant 任务** **build.gradle** ```gradle @@ -33,7 +33,7 @@ dependencies { } ``` -要使用classpath配置,使用自定义配置的`asPath`属性。 +要使用 classpath 配置, 使用自定义配置的`asPath`属性。 **例 16.7.一起使用自定义Ant任务和依赖管理**