从 Gradle 4.x 升级到 5.0

<< 对于任务定义不再有效。换句话说，您不能使用语法 task myTask << { …​ }。

task myTask {
    doLast {
        ...
    }
}

您不能再在域对象名称（例如项目和任务名称）中使用以下任何字符：<space> / \ : < > " ? * | 。您也不应将 . 用作开头或结尾字符。

如前所述，Gradle 不再支持在 Java 7 上运行。但是，您仍然可以使用分叉编译和测试来构建和测试 Java 6 及更高版本的软件。

-Dtest.single 命令行选项已移除 — 请改为使用测试筛选。

-Dtest.debug 命令行选项已移除 — 请改为使用--debug-jvm 选项。

-u/--no-search-upward 命令行选项已移除 — 请确保所有构建都包含 settings.gradle 文件。

--recompile-scripts 命令行选项已移除。

您不能再将 Gradle 构建嵌套在另一个 Gradle 构建的子目录中，除非嵌套构建包含 settings.gradle 文件。

DirectoryBuildCache.setTargetSizeInMB(long) 方法已移除 — 请改为使用DirectoryBuildCache.removeUnusedEntriesAfterDays。

org.gradle.readLoggingConfigFile 系统属性不再起作用 — 请更新受影响的测试以适应您的 java.util.logging 设置。

您不能再使用 as 关键字或 asType() 方法将 FileCollection 对象转换为其他类型。

您不能再将 null 作为 CopySpec.from(Object, Action) 的配置操作传递。

为了更好地与 Kotlin DSL 兼容，CopySpec.duplicatesStrategy 不再可空。属性 setter 不再接受 null 作为将属性重置为其默认值的方式。请改用 DuplicatesStrategy.INHERIT。

FileCollection.stopExecutionIfEmpty() 方法已移除 — 请改为在 FileCollection 任务属性上使用 @SkipWhenEmpty 注解。

FileCollection.add() 方法已移除 — 请改为使用 Project.files() 和 Project.fileTree() 创建可配置的文件集合/文件树，并通过 ConfigurableFileCollection.from() 将文件添加到其中。

SimpleFileCollection 已移除 — 请改为使用 Project.files(Object…​)。

不要让您自己的类扩展 AbstractFileCollection — 请改为使用 Project.files() 方法。此问题可能表现为缺少 getBuildDependencies() 方法。

CompileOptions.bootClasspath 属性已移除 — 请改为使用 CompileOptions.bootstrapClasspath。

您不能再将 -source-path 用作通用编译器参数 — 请改为使用 CompileOptions.sourcepath。

您不能再将 -processorpath 用作通用编译器参数 — 请改为使用 CompileOptions.annotationProcessorPath。

Gradle 不再自动应用编译类路径中的注解处理器 — 请改为使用 CompileOptions.annotationProcessorPath。

testClassesDir 属性已从 Test 任务中移除 — 请改为使用 testClassesDirs。

classesDir 属性已从 JDepend 任务和 SourceSetOutput 中移除。请改为使用 JDepend.classesDirs 和 SourceSetOutput.classesDirs 属性。

JavaLibrary(PublishArtifact, DependencySet) 构造函数已移除 — 此构造函数由 Shadow 插件使用，因此请确保您将该插件升级到至少 2.x 版本。

JavaBasePlugin.configureForSourceSet() 方法已移除。

您不能再创建自己的 JavaPluginConvention、ApplicationPluginConvention、WarPluginConvention、EarPluginConvention、BasePluginConvention 和 ProjectReportsPluginConvention 实例。

Maven 插件以前发布高度过时的 Maven 2 元数据格式。现在已更改，它将发布 Maven 3 元数据，就像 Maven Publish 插件一样。

以下与惰性属性相关的遗留类和方法已移除 — 使用 ObjectFactory.property() 创建 Property 实例

使用任务配置避免 API 配置和注册的任务对可以从配置操作调用的其他方法有更多限制。

内部的 @Option 和 @OptionValues 注解 — 包 org.gradle.api.internal.tasks.options — 已移除。请改用公共的 @Option 和 @OptionValues 注解。

Task.deleteAllActions() 方法已移除，没有替代方法。

Task.dependsOnTaskDidWork() 方法已移除 — 请改为使用声明的输入和输出。

TaskInternal 的以下属性和方法已移除 — 请改为使用任务依赖项、任务规则、可重用实用方法或 Worker API 来替代直接执行任务。

TaskInputs.file(Object) 方法不能再使用解析为单个常规文件以外的任何内容的参数调用。

TaskInputs.dir(Object) 方法不能再使用解析为单个目录以外的任何内容的参数调用。

您不能再通过 TaskInputs 和 TaskOutputs 注册无效的输入和输出。

TaskDestroyables.file() 和 TaskDestroyables.files() 方法已移除 — 请改为使用 TaskDestroyables.register()。

SimpleWorkResult 已移除 — 请改为使用 WorkResult.didWork。

覆盖在4.8 中已弃用的内置任务现在会产生错误。

> Cannot add task 'wrapper' as a task with that name already exists.

不再支持 Play 2.2 — 请升级您正在使用的 Play 版本。

ScalaDocOptions.styleSheet 属性已移除 — Scala 2.11.8 及更高版本中的 Scaladoc Ant 任务不再支持此属性。

Artifact 配置访问器现在具有 NamedDomainObjectProvider<Configuration> 类型，而不是 Configuration

PluginAware.apply<T>(to) 已重命名为 PluginAware.applyTo<T>(target)。

ConfigurableReport.setDestination(Object) 方法已移除 — 请改为使用 ConfigurableReport.setDestination(File)。

Signature.setFile(File) 方法已移除 — Gradle 不支持更改生成签名的输出文件。

只读的 Signature.toSignArtifact 属性已移除 — 它不应成为公共 API 的一部分。

@DeferredConfigurable 注解已移除。

方法 isDeferredConfigurable() 已从 ExtensionSchema 中移除。

IdeaPlugin.performPostEvaluationActions() 和 EclipsePlugin.performPostEvaluationActions() 已移除。

BroadcastingCollectionEventRegister.getAddAction() 方法已移除，没有替代方法。

内部的 org.gradle.util 包不再默认导入。

gradlePluginPortal() 仓库默认情况下不再查找没有 POM 的 JAR。

Tooling API 不再能连接到使用低于 Gradle 2.6 版本的 Gradle 构建。这同样适用于通过 TestKit 运行的构建。

Gradle 5.0 需要最低 Tooling API 客户端版本为 3.0。旧版客户端库不能再使用 Gradle 5.0 运行构建。

IdeaModule Tooling API 模型元素包含用于检索资源和测试资源的方法，因此这些元素已从 IdeaModule.getSourceDirs() 和 IdeaModule.getTestSourceDirs() 的结果中移除。

在以前的 Gradle 版本中，SourceTask 中的 source 字段可从子类访问。现在不是这种情况，因为 source 字段现在被声明为 private。

在 Worker API 中，Worker 的工作目录不能再设置。

与依赖项和版本约束相关的行为更改可能会影响少数用户。

DefaultTask 上的属性工厂方法有几处更改，可能会影响自定义任务的创建。

getDestinationDir() 已替换为 getDestinationDirectory()。

getBinaryFile()、getOutputFile() 已替换为 getLinkedFile()。

setOutputFile(File) 已移除。请改为使用 Property.set()。

setOutputFile(Provider) 已移除。请改为使用 Property.set()。

getTargetPlatform() 已更改为返回 Property。

setTargetPlatform(NativePlatform) 已移除。请改为使用 Property.set()。

getToolChain() 已更改为返回 Property。

setToolChain(NativeToolChain) 已移除。请改为使用 Property.set()。

getOutputFile() 已更改为返回 Property。

setOutputFile(File) 已移除。请改为使用 Property.set()。

setOutputFile(Provider) 已移除。请改为使用 Property.set()。

getTargetPlatform() 已更改为返回 Property。

setTargetPlatform(NativePlatform) 已移除。请改为使用 Property.set()。

getToolChain() 已更改为返回 Property。

setToolChain(NativeToolChain) 已移除。请改为使用 Property.set()。

getStaticLibArgs() 已更改为返回 ListProperty。

setStaticLibArgs(List) 已移除。请改为使用 ListProperty.set()。

getSourceFile() 已替换为 getExecutableFile()。

getPlatform() 已替换为 getTargetPlatform()。

setTargetPlatform(NativePlatform) 已移除。请改为使用 Property.set()。

getToolChain() 已更改为返回 Property。

setToolChain(NativeToolChain) 已移除。请改为使用 Property.set()。