我对Gradle非常陌生。我昨天开始阅读它。我发现了一个构建节点应用程序的示例build.gradle。我对文件的内容有点困惑。我不确定哪些是保留字或预定义字。其中一个字符串是node
。它没有在其他地方使用,但我发现节点插件需要它。
buildscript {
repositories {
mavenCentral()
maven {
url 'https://plugins.gradle.org/m2/'
}
}
dependencies {
classpath 'com.moowork.gradle:gradle-node-plugin:1.2.0'
}
}
apply plugin: 'base'
apply plugin: 'com.moowork.node' // gradle-node-plugin
node {
/* gradle-node-plugin configuration
https://github.com/srs/gradle-node-plugin/blob/master/docs/node.md
Task name pattern:
./gradlew npm_<command> Executes an NPM command.
*/
// Version of node to use.
version = '10.14.1'
// Version of npm to use.
npmVersion = '6.4.1'
// If true, it will download node using above parameters.
// If false, it will try to use globally installed node.
download = true
}
npm_run_build {
// make sure the build task is executed only when appropriate files change
inputs.files fileTree('public')
inputs.files fileTree('src')
// 'node_modules' appeared not reliable for dependency change detection (the task was rerun without changes)
// though 'package.json' and 'package-lock.json' should be enough anyway
inputs.file 'package.json'
inputs.file 'package-lock.json'
outputs.dir 'build'
}
// pack output of the build into JAR file
task packageNpmApp(type: Zip) {
dependsOn npm_run_build
baseName 'npm-app'
extension 'jar'
destinationDir file("${projectDir}/build_packageNpmApp")
from('build') {
// optional path under which output will be visible in Java classpath, e.g. static resources path
into 'static'
}
}
// declare a dedicated scope for publishing the packaged JAR
configurations {
npmResources
}
configurations.default.extendsFrom(configurations.npmResources)
// expose the artifact created by the packaging task
artifacts {
npmResources(packageNpmApp.archivePath) {
builtBy packageNpmApp
type 'jar'
}
}
assemble.dependsOn packageNpmApp
String testsExecutedMarkerName = "${projectDir}/.tests.executed"
task test(type: NpmTask) {
dependsOn assemble
// force Jest test runner to execute tests once and finish the process instead of starting watch mode
environment CI: 'true'
args = ['run', 'test']
inputs.files fileTree('src')
inputs.file 'package.json'
inputs.file 'package-lock.json'
// allows easy triggering re-tests
doLast {
new File(testsExecutedMarkerName).text = 'delete this file to force re-execution JavaScript tests'
}
outputs.file testsExecutedMarkerName
}
check.dependsOn test
clean {
delete packageNpmApp.archivePath
delete testsExecutedMarkerName
}
另外,build.gradle是如何解析的?我还想知道它是如何神奇地下载node和npm工具的。
2条答案
按热度按时间j8ag8udp1#
这是一个非常概括的概要:
*.gradle
文件包含配置块(closures
),用于指定逻辑应该如何运行。com.moowork.node
插件通过node
扩展块配置。download = true
配置告诉插件下载项目根目录中的node(version = '10.14.1'
)和nmp(npmVersion = '6.4.1'
)(除非您也覆盖了其默认值)。希望这个有用。
wfypjpf42#
在您的代码片段中,只有
true
是关键字,其他内容是来自Gradle或Node JS插件的方法或getter:apply plugin: ...
是来自org.gradle.api.Project.apply(java.util.Map<String, ?>)
的方法node
是Gradle自动生成的方法,签名为void node(Closure<com.moowork.gradle.node.NodeExtension>)
(接受代码块的方法),请参见https://github.com/srs/gradle-node-plugin/blob/master/src/main/groovy/com/moowork/gradle/node/NodeExtension.groovynode { version = ... }
-version
、npmVersion
是NodeExtension
类中的字段