java - [Gradle][Play]compilePlayBinaryScala 定义在哪里？

Question

我对 gradle 和 Play 还比较陌生。

我正在开发一个使用 gradle 作为构建系统的 play 项目。我正在尝试使用构建缓存来获得更好的性能。从构建扫描中，我观察到“compilePlayBinaryScala”不可缓存，并且大多数其他任务都依赖于“compilePlayBinaryScala”。启用“compilePlayBinaryScala”缓存将真正扩大构建规模。

Gradle 官方文档列出了 .*PlayBinary 任务 ( https://docs.gradle.org/current/userguide/play_plugin.html )

我找不到“compilePlayBinaryScala”或任何其他 .*PlayBinaryScala 任务的显式任务定义。这些任务在哪里定义的？

根据我的研究，我可以看到可以在其中创建任务的文件。但是，我不确定。 https://github.com/gradle/gradle/blob/de399b5015b19c07d94aa2eabec47709fc719a68/subprojects/platform-play/src/main/java/org/gradle/play/plugins/PlayApplicationPlugin.java#L160

由于我是新手，详细解释为什么这样做会非常有帮助。

Answer 1

任务是在该文件中创建的，而不是在您链接到的方法中创建的。这些任务是通过类似 createScalaCompileTask 的方法为每个二进制文件创建的。 , createJarTasks , createPlayRunTask 。 @Mutate , @BinaryTasks ，`@ComponentBinaries 是 Gradle 中称为基于规则的模型(也是软件模型)的一部分。 Play plugin documentation 中描述了用法。 。 Gradle 团队对这个模型进行了几年的实验，但最终决定不使用它，并且它并没有被正式弃用(请参阅博客文章 State and future of the Gradle Software Model 。

compilePlayBinaryScala 的类型是 PlatformScalaCompile 。这在文档中有所说明，也可以通过运行 ./gradlew model 来确定或添加类似的任务操作来记录类型。任务名称"compilePlayBinaryScala"是根据插件一部分的几个不同的东西计算出来的。组件名称为"play" ，因此二进制文件和任务是根据该二进制文件和目标平台生成的。如果插件支持超过 1 个平台，任务命名约定将会更加明显(在撰写本文时尚不支持)。 Gradle 的 native support 是另一个根据组件名称生成任务的插件的示例。 .

不值得深入讨论规则模型的结构，但高层是方法的第一个参数是主题，可以更改，而其余参数是输入且不可变。在上面链接的方法中，您会注意到第一个参数的类型为 ModelMap<Task> 。那就是 Task 的集合可以变异的物体。流程看起来像这样(我可能遗漏了一些东西):

• default component named "play" is created in a ModelMap<PlayApplicationSpec>
• only 1 Play component is supported in the ModelMap<PlayApplicationSpec>
• each PlayPlatformAwareComponentSpecInternal is validated that the number of target platforms is not more than 1
• source sets are created for the PlayApplicationSpec
• a binary is added to ModelMap<PlayApplicationBinarySpec> based on the PlayApplicationSpecInternal . The name of the generated binary comes from here somewhere
• compile tasks are generated by the ScalaLanguagePlugin
• PlatformScalaCompile tasks are mutated to use the compile classpath from the PlayApplicationBinarySpec
• 一些其他配置规则

这就是我可以为您提供的尽可能详细的信息，而无需进一步深入研究 ScalaLanguagePlugin 。 ./gradlew model会给你一份关于某些东西来自哪里的报告，可能会有所帮助，但也可能没有帮助，因为事情是在该模型和正常的 Gradle 配置模型之间进行管理的。