Spring 从分支构建时 XD dist 任务失败

Question

gradlew dist -xtest -xjavadoc -xsetupui

当dist from master时，构建成功。

当从分支 运行ning 时，它 fails.I 确实将分支推送到我的远程，但我不确定为什么 gradle 任务应该知道远程分支。我可以 运行 使用 -xpullDocs

成功

似乎与 "wikiBranch" 属性 有关。

失败：构建失败，出现异常。 10:34:14.670 [错误] [org.gradle.BuildExceptionReporter] 10:34:14.670 [错误] [org.gradle.BuildExceptionReporter] * 其中： 10:34:14.670 [错误] [org.gradle.BuildExceptionReporter] 脚本 '/Users/{$ID}/spring-xd/gradle/build-docs.gradle' 行：58 10:34:14.670 [错误] [org.gradle.BuildExceptionReporter] 10:34:14.670 [错误] [org.gradle.BuildExceptionReporter] * 出了什么问题： 10:34:14.671 [错误] [org.gradle.BuildExceptionReporter] 任务 ':pullDocs' 执行失败。 10:34:14.671 [错误] [org.gradle.BuildExceptionReporter] > 切换到分支时出错：origin/jms-transport。原因：无法解析 Ref origin/{branch} 10:34:14.672 [错误] [org.gradle.BuildExceptionReporter] 10:34:14.673 [错误] [org.gradle.BuildExceptionReporter] * 异常是： 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] org.gradle.api.tasks.TaskExecutionException：任务“:pullDocs”执行失败。 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.ExecuteActionsTaskExecuter.executeActions(ExecuteActionsTaskExecuter.java:69) 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.ExecuteActionsTaskExecuter.execute(ExecuteActionsTaskExecuter.java:46) 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.PostExecutionAnalysisTaskExecuter.execute(PostExecutionAnalysisTaskExecuter.java:35) 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.SkipUpToDateTaskExecuter.execute(SkipUpToDateTaskExecuter.java:64) 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.ValidatingTaskExecuter.execute(ValidatingTaskExecuter.java:58) 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.SkipEmptySourceFilesTaskExecuter.execute(SkipEmptySourceFilesTaskExecuter.java:42) 10:34:14.674 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.SkipTaskWithNoActionsExecuter.execute(SkipTaskWithNoActionsExecuter.java:52) 10:34:14.675 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.SkipOnlyIfTaskExecuter.execute(SkipOnlyIfTaskExecuter.java:53) 10:34:14.675 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.tasks.execution.ExecuteAtMostOnceTaskExecuter.execute(ExecuteAtMostOnceTaskExecuter.java:43) 10:34:14.675 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.api.internal.AbstractTask.executeWithoutThrowingTaskFailure(AbstractTask.java:289) 10:34:14.675 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.execution.taskgraph.AbstractTaskPlanExecutor$TaskExecutorWorker.executeTask(AbstractTaskPlanExecutor.java:79) 10:34:14.675 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.execution.taskgraph.AbstractTaskPlanExecutor$TaskExecutorWorker.processTask(AbstractTaskPlanExecutor.java:63) 10:34:14.675 [错误] [org.gradle.BuildExceptionReporter] 在 org.gradle.execution.taskgraph.AbstractTaskPlanExecutor$TaskExecutorWorker.run(AbstractTaskPlanExecutor.java:51)

Answer 1

使用-PwikiBranch=origin/master

Answer 2

目前，我们将文档与主要来源分开维护。我们发现最初使用 GitHub wiki（具有编辑功能）作为 Spring XD 文档的来源很有帮助。 Github 的 wiki 是一个单独的 Git 回购并导致 一些复杂性。

由于有多个活动的 XD 分支，我们还必须维护多个文档分支。

因此，如果您使用自定义分支，则必须使用Gradle传递-PwikiBranch参数，例如：

./gradlew dist -PwikiBranch=origin/master

有关更多详细信息，另请参阅： https://github.com/spring-projects/spring-xd/blob/master/gradle/build-docs.gradle#L37