Class DefaultTask
- All Implemented Interfaces:
- Comparable<Task>,- org.gradle.api.internal.DynamicObjectAware,- org.gradle.api.internal.TaskInternal,- Named,- ExtensionAware,- Task,- Configurable<Task>
- Direct Known Subclasses:
- AbstractConfigurationReportTask,- AbstractLinkTask,- AbstractNativeCompileTask,- AbstractPublishToMaven,- ArtifactTransformsReportTask,- Assemble,- BuildEnvironmentReportTask,- ComponentReport,- org.gradle.api.internal.ConventionTask,- CreateStaticLibrary,- DependencyInsightReportTask,- DependentComponentsReport,- ExtractSymbols,- GenerateBuildDashboard,- GenerateCUnitLauncher,- GenerateIvyDescriptor,- GenerateMavenPom,- GenerateModuleMetadata,- GeneratePluginDescriptors,- GenerateSwiftPackageManagerManifest,- InitBuild,- InstallExecutable,- InstallXCTestBundle,- JacocoBase,- ModelReport,- PluginUnderTestMetadata,- PrefixHeaderFileGenerateTask,- PublishToIvyRepository,- Sign,- StripSymbols,- SwiftCompile,- TestReport,- UnexportMainSymbol,- UpdateDaemonJvm,- ValidatePlugins,- WindowsResourceCompile,- Wrapper,- WriteProperties
DefaultTask is the standard Task implementation. You can extend this to implement your own task types.- 
Nested Class SummaryNested classes/interfaces inherited from interface org.gradle.api.TaskTask.Namer
- 
Field SummaryFields inherited from interface org.gradle.api.TaskTASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionintApplies the statements of the closure against this task object.Adds the given dependencies to this task.Adds the given closure to the beginning of this task's action list.Adds the givenActionto the beginning of this task's action list.Adds the givenActionto the beginning of this task's action list.Adds the given closure to the end of this task's action list.Adds the givenActionto the end of this task's action list.Adds the givenActionto the end of this task's action list.finalizedBy(Object... paths) Adds the given finalizer tasks for this task.Returns the sequence ofActionobjects which will be executed by this task, in the order of execution.getAnt()Returns theAntBuilderfor this task.Returns the dependencies of this task.Returns the description of this task.Returns the destroyables of this task.booleanChecks if the task actually did any work.booleanReturns if this task is enabled or not.The container of extensions.Returns tasks that finalize this task.getGroup()Returns the task group which this task belongs to.org.gradle.api.internal.TaskInputsInternalReturns the inputs of this task.Returns the local state of this task.Returns the logger for this task.Returns theLoggingManagerwhich can be used to receive logging and to control the standard output/error capture for this task.Returns tasks that this task must run after.getName()Returns the name of this task.org.gradle.api.internal.TaskOutputsInternalReturns the outputs of this task.getPath()Returns the path of the task, which is a fully qualified name for the task.Returns theProjectwhich this task belongs to.Returns tasks that this task should run after.org.gradle.api.internal.tasks.TaskStateInternalgetState()Returns the execution state of this task.org.gradle.api.internal.tasks.TaskDependencyInternalReturns aTaskDependencywhich contains all the tasks that this task depends on.Returns a directory which this task can use to write temporary files to.The timeout of this task.booleanhasProperty(String propertyName) Determines if this task has the given property.mustRunAfter(Object... paths) Specifies that this task must run after all of the supplied tasks.voidExecute the task only if the given closure returns true.voidExecute the task only if the given spec is satisfied.voidExecute the task only if the given spec is satisfied.Returns the value of the given property of this task.voidsetActions(List<Action<? super Task>> replacements) Sets the sequence ofActionobjects which will be executed by this task.voidsetDependsOn(Iterable<?> dependsOn) Sets the dependencies of this task.voidsetDescription(String description) Sets a description for this task.voidsetDidWork(boolean didWork) Sets whether the task actually did any work.voidsetEnabled(boolean enabled) Set the enabled state of a task.voidsetFinalizedBy(Iterable<?> finalizedByTasks) Specifies the set of finalizer tasks for this task.voidSets the task group which this task belongs to.voidsetMustRunAfter(Iterable<?> mustRunAfterTasks) Specifies the set of tasks that this task must run after.voidExecute the task only if the given closure returns true.voidExecute the task only if the given spec is satisfied.voidExecute the task only if the given spec is satisfied.voidsetProperty(String name, Object value) Sets a property of this task.voidsetShouldRunAfter(Iterable<?> shouldRunAfterTasks) Specifies the set of tasks that this task should run after.shouldRunAfter(Object... paths) Specifies that this task should run after all of the supplied tasks.voidusesService(Provider<? extends BuildService<?>> service) Registers aBuildServicethat is used by this task soits constraint on parallel executioncan be honored.Methods inherited from class org.gradle.api.internal.AbstractTaskacceptServiceReferences, appendParallelSafeAction, doNotTrackState, getAsDynamicObject, getConvention, getIdentityPath, getImpliesSubProjects, getLifecycleDependencies, getOnlyIf, getReasonNotToTrackState, getReasonTaskIsIncompatibleWithConfigurationCache, getRequiredServices, getServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, hasTaskActions, injectIntoNewInstance, isCompatibleWithConfigurationCache, isEnabled, isHasCustomActions, notCompatibleWithConfigurationCache, prependParallelSafeAction, setImpliesSubProjectsMethods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.gradle.api.TaskdoNotTrackState, getConvention, notCompatibleWithConfigurationCache
- 
Constructor Details- 
DefaultTaskpublic DefaultTask()
 
- 
- 
Method Details- 
getAntDescription copied from interface:TaskReturns the AntBuilderfor this task. You can use this in your build file to execute ant tasks.
- 
getProjectDescription copied from interface:TaskReturns the Projectwhich this task belongs to.Calling this method from a task action is not supported when configuration caching is enabled. - Specified by:
- getProjectin interface- Task
- Overrides:
- getProjectin class- org.gradle.api.internal.AbstractTask
- Returns:
- The project this task belongs to. Never returns null.
 
- 
getNameDescription copied from interface:TaskReturns the name of this task. The name uniquely identifies the task within its Project.
- 
getActionsDescription copied from interface:TaskReturns the sequence of Actionobjects which will be executed by this task, in the order of execution.- Specified by:
- getActionsin interface- Task
- Overrides:
- getActionsin class- org.gradle.api.internal.AbstractTask
- Returns:
- The task actions in the order they are executed. Returns an empty list if this task has no actions.
 
- 
setActionsDescription copied from interface:TaskSets the sequence of Actionobjects which will be executed by this task.- Specified by:
- setActionsin interface- Task
- Overrides:
- setActionsin class- org.gradle.api.internal.AbstractTask
- Parameters:
- replacements- The actions.
 
- 
getDependsOnDescription copied from interface:TaskReturns the dependencies of this task. - Specified by:
- getDependsOnin interface- Task
- Overrides:
- getDependsOnin class- org.gradle.api.internal.AbstractTask
- Returns:
- The dependencies of this task. Returns an empty set if this task has no dependencies.
 
- 
setDependsOnDescription copied from interface:TaskSets the dependencies of this task. See here for a description of the types of objects which can be used as task dependencies. - Specified by:
- setDependsOnin interface- Task
- Overrides:
- setDependsOnin class- org.gradle.api.internal.AbstractTask
- Parameters:
- dependsOn- The set of task paths.
 
- 
onlyIfDescription copied from interface:TaskExecute the task only if the given spec is satisfied. The spec will be evaluated at task execution time, not during configuration. If the Spec is not satisfied, the task will be skipped. You may add multiple such predicates. The task is skipped if any of the predicates return false. Typical usage (from Java): myTask.onlyIf(new Spec<Task>() { boolean isSatisfiedBy(Task task) { return isProductionEnvironment(); } });
- 
onlyIfDescription copied from interface:TaskExecute the task only if the given spec is satisfied. The spec will be evaluated at task execution time, not during configuration. If the Spec is not satisfied, the task will be skipped. You may add multiple such predicates. The task is skipped if any of the predicates return false. Typical usage (from Java): myTask.onlyIf("run only in production environment", new Spec<Task>() { boolean isSatisfiedBy(Task task) { return isProductionEnvironment(); } });
- 
setOnlyIfDescription copied from interface:TaskExecute the task only if the given spec is satisfied. The spec will be evaluated at task execution time, not during configuration. If the Spec is not satisfied, the task will be skipped. The given predicate replaces all such predicates for this task. 
- 
setOnlyIfDescription copied from interface:TaskExecute the task only if the given spec is satisfied. The spec will be evaluated at task execution time, not during configuration. If the Spec is not satisfied, the task will be skipped. The given predicate replaces all such predicates for this task. 
- 
getDidWorkpublic boolean getDidWork()Description copied from interface:TaskChecks if the task actually did any work. Even if a Task executes, it may determine that it has nothing to do. For example, a compilation task may determine that source files have not changed since the last time a the task was run. - Specified by:
- getDidWorkin interface- Task
- Overrides:
- getDidWorkin class- org.gradle.api.internal.AbstractTask
- Returns:
- true if this task did any work
 
- 
setDidWorkpublic void setDidWork(boolean didWork) Description copied from interface:TaskSets whether the task actually did any work. Most built-in tasks will set this automatically, but it may be useful to manually indicate this for custom user tasks.- Specified by:
- setDidWorkin interface- Task
- Overrides:
- setDidWorkin class- org.gradle.api.internal.AbstractTask
- Parameters:
- didWork- indicates if the task did any work
 
- 
getEnabledpublic boolean getEnabled()Description copied from interface:TaskReturns if this task is enabled or not. - Specified by:
- getEnabledin interface- Task
- Overrides:
- getEnabledin class- org.gradle.api.internal.AbstractTask
- See Also:
 
- 
setEnabledpublic void setEnabled(boolean enabled) Description copied from interface:TaskSet the enabled state of a task. If a task is disabled none of the its actions are executed. Note that disabling a task does not prevent the execution of the tasks which this task depends on. - Specified by:
- setEnabledin interface- Task
- Overrides:
- setEnabledin class- org.gradle.api.internal.AbstractTask
- Parameters:
- enabled- The enabled state of this task (true or false)
 
- 
getPathDescription copied from interface:TaskReturns the path of the task, which is a fully qualified name for the task. The path of a task is the path of its Projectplus the name of the task, separated by:.
- 
dependsOnDescription copied from interface:TaskAdds the given dependencies to this task. See here for a description of the types of objects which can be used as task dependencies. 
- 
doFirstDescription copied from interface:TaskAdds the given Actionto the beginning of this task's action list.
- 
doFirstDescription copied from interface:TaskAdds the given Actionto the beginning of this task's action list.
- 
doLastDescription copied from interface:TaskAdds the given Actionto the end of this task's action list.
- 
doLastDescription copied from interface:TaskAdds the given Actionto the end of this task's action list.
- 
compareTo- Specified by:
- compareToin interface- Comparable<Task>
- Overrides:
- compareToin class- org.gradle.api.internal.AbstractTask
 
- 
getLoggerDescription copied from interface:TaskReturns the logger for this task. You can use this in your build file to write log messages. 
- 
propertyDescription copied from interface:TaskReturns the value of the given property of this task. This method locates a property as follows: - If this task object has a property with the given name, return the value of the property.
- If this task has an extension with the given name, return the extension.
- If this task's convention object has a property with the given name, return the value of the property.
- If this task has an extra property with the given name, return the value of the property.
- If not found, throw MissingPropertyException
 - Specified by:
- propertyin interface- Task
- Overrides:
- propertyin class- org.gradle.api.internal.AbstractTask
- Parameters:
- propertyName- The name of the property.
- Returns:
- The value of the property, possibly null.
- Throws:
- MissingPropertyException- When the given property is unknown.
 
- 
hasPropertyDescription copied from interface:TaskDetermines if this task has the given property. See here for details of the properties which are available for a task. - Specified by:
- hasPropertyin interface- Task
- Overrides:
- hasPropertyin class- org.gradle.api.internal.AbstractTask
- Parameters:
- propertyName- The name of the property to locate.
- Returns:
- True if this project has the given property, false otherwise.
 
- 
setPropertyDescription copied from interface:TaskSets a property of this task. This method searches for a property with the given name in the following locations, and sets the property on the first location where it finds the property. - The task object itself.  For example, the enabledproject property.
- The task's convention object.
- The task's extra properties.
 MissingPropertyExceptionis thrown.- Specified by:
- setPropertyin interface- Task
- Overrides:
- setPropertyin class- org.gradle.api.internal.AbstractTask
- Parameters:
- name- The name of the property
- value- The value of the property
 
- The task object itself.  For example, the 
- 
getDescriptionDescription copied from interface:TaskReturns the description of this task.- Specified by:
- getDescriptionin interface- Task
- Overrides:
- getDescriptionin class- org.gradle.api.internal.AbstractTask
- Returns:
- the description. May return null.
 
- 
setDescriptionDescription copied from interface:TaskSets a description for this task. This should describe what the task does to the user of the build. The description will be displayed whengradle tasksis called.- Specified by:
- setDescriptionin interface- Task
- Overrides:
- setDescriptionin class- org.gradle.api.internal.AbstractTask
- Parameters:
- description- The description of the task. Might be null.
 
- 
getGroupDescription copied from interface:TaskReturns the task group which this task belongs to. The task group is used in reports and user interfaces to group related tasks together when presenting a list of tasks to the user.
- 
setGroupDescription copied from interface:TaskSets the task group which this task belongs to. The task group is used in reports and user interfaces to group related tasks together when presenting a list of tasks to the user.
- 
getDestroyablesDescription copied from interface:TaskReturns the destroyables of this task. - Specified by:
- getDestroyablesin interface- Task
- Overrides:
- getDestroyablesin class- org.gradle.api.internal.AbstractTask
- Returns:
- The destroyables. Never returns null.
 
- 
getLocalStateDescription copied from interface:TaskReturns the local state of this task.- Specified by:
- getLocalStatein interface- Task
- Overrides:
- getLocalStatein class- org.gradle.api.internal.AbstractTask
 
- 
getTemporaryDirDescription copied from interface:TaskReturns a directory which this task can use to write temporary files to. Each task instance is provided with a separate temporary directory. There are no guarantees that the contents of this directory will be kept beyond the execution of the task. - Specified by:
- getTemporaryDirin interface- Task
- Overrides:
- getTemporaryDirin class- org.gradle.api.internal.AbstractTask
- Returns:
- The directory. Never returns null. The directory will already exist.
 
- 
setMustRunAfterDescription copied from interface:TaskSpecifies the set of tasks that this task must run after. task taskY { mustRunAfter = ["taskX1", "taskX2"] }For each supplied task, this action adds a task 'ordering', and does not specify a 'dependency' between the tasks. As such, it is still possible to execute 'taskY' without first executing the 'taskX' in the example. See here for a description of the types of objects which can be used to specify an ordering relationship. - Specified by:
- setMustRunAfterin interface- Task
- Overrides:
- setMustRunAfterin class- org.gradle.api.internal.AbstractTask
- Parameters:
- mustRunAfterTasks- The set of task paths this task must run after.
 
- 
mustRunAfterDescription copied from interface:TaskSpecifies that this task must run after all of the supplied tasks. task taskY { mustRunAfter "taskX" }For each supplied task, this action adds a task 'ordering', and does not specify a 'dependency' between the tasks. As such, it is still possible to execute 'taskY' without first executing the 'taskX' in the example. See here for a description of the types of objects which can be used to specify an ordering relationship. - Specified by:
- mustRunAfterin interface- Task
- Overrides:
- mustRunAfterin class- org.gradle.api.internal.AbstractTask
- Parameters:
- paths- The tasks this task must run after.
- Returns:
- the task object this method is applied to
 
- 
getMustRunAfterDescription copied from interface:TaskReturns tasks that this task must run after. - Specified by:
- getMustRunAfterin interface- Task
- Overrides:
- getMustRunAfterin class- org.gradle.api.internal.AbstractTask
- Returns:
- The tasks that this task must run after. Returns an empty set if this task has no tasks it must run after.
 
- 
setFinalizedByDescription copied from interface:TaskSpecifies the set of finalizer tasks for this task. task taskY { finalizedBy = ["taskX1", "taskX2"] }See here for a description of the types of objects which can be used to specify a finalizer task. - Specified by:
- setFinalizedByin interface- Task
- Overrides:
- setFinalizedByin class- org.gradle.api.internal.AbstractTask
- Parameters:
- finalizedByTasks- The tasks that finalize this task.
 
- 
finalizedByDescription copied from interface:TaskAdds the given finalizer tasks for this task. task taskY { finalizedBy "taskX" }See here for a description of the types of objects which can be used to specify a finalizer task. - Specified by:
- finalizedByin interface- Task
- Overrides:
- finalizedByin class- org.gradle.api.internal.AbstractTask
- Parameters:
- paths- The tasks that finalize this task.
- Returns:
- the task object this method is applied to
 
- 
getFinalizedByDescription copied from interface:TaskReturns tasks that finalize this task. - Specified by:
- getFinalizedByin interface- Task
- Overrides:
- getFinalizedByin class- org.gradle.api.internal.AbstractTask
- Returns:
- The tasks that finalize this task. Returns an empty set if there are no finalising tasks for this task.
 
- 
shouldRunAfterDescription copied from interface:TaskSpecifies that this task should run after all of the supplied tasks. task taskY { shouldRunAfter "taskX" }For each supplied task, this action adds a task 'ordering', and does not specify a 'dependency' between the tasks. As such, it is still possible to execute 'taskY' without first executing the 'taskX' in the example. See here for a description of the types of objects which can be used to specify an ordering relationship. - Specified by:
- shouldRunAfterin interface- Task
- Overrides:
- shouldRunAfterin class- org.gradle.api.internal.AbstractTask
- Parameters:
- paths- The tasks this task should run after.
- Returns:
- the task object this method is applied to
 
- 
setShouldRunAfterDescription copied from interface:TaskSpecifies the set of tasks that this task should run after. task taskY { shouldRunAfter = ["taskX1", "taskX2"] }For each supplied task, this action adds a task 'ordering', and does not specify a 'dependency' between the tasks. As such, it is still possible to execute 'taskY' without first executing the 'taskX' in the example. See here for a description of the types of objects which can be used to specify an ordering relationship. - Specified by:
- setShouldRunAfterin interface- Task
- Overrides:
- setShouldRunAfterin class- org.gradle.api.internal.AbstractTask
- Parameters:
- shouldRunAfterTasks- The set of task paths this task should run after.
 
- 
getShouldRunAfterDescription copied from interface:TaskReturns tasks that this task should run after. - Specified by:
- getShouldRunAfterin interface- Task
- Overrides:
- getShouldRunAfterin class- org.gradle.api.internal.AbstractTask
- Returns:
- The tasks that this task should run after. Returns an empty set if this task has no tasks it must run after.
 
- 
getTimeoutDescription copied from interface:TaskThe timeout of this task. task myTask { timeout = Duration.ofMinutes(10) }The Thread executing this task will be interrupted if the task takes longer than the specified amount of time to run. In order for a task to work properly with this feature, it needs to react to interrupts and must clean up any resources it opened. By default, tasks never time out. - Specified by:
- getTimeoutin interface- Task
- Overrides:
- getTimeoutin class- org.gradle.api.internal.AbstractTask
 
- 
usesServiceDescription copied from interface:TaskRegisters aBuildServicethat is used by this task soits constraint on parallel executioncan be honored.This is not necessary for task properties declared as ServiceReferences.- Specified by:
- usesServicein interface- Task
- Overrides:
- usesServicein class- org.gradle.api.internal.AbstractTask
- Parameters:
- service- The service provider.
- See Also:
 
- 
getStatepublic org.gradle.api.internal.tasks.TaskStateInternal getState()Description copied from interface:TaskReturns the execution state of this task. This provides information about the execution of this task, such as whether it has executed, been skipped, has failed, etc.
- 
getTaskDependenciespublic org.gradle.api.internal.tasks.TaskDependencyInternal getTaskDependencies()Description copied from interface:TaskReturns a TaskDependencywhich contains all the tasks that this task depends on.Calling this method from a task action is not supported when configuration caching is enabled. - Specified by:
- getTaskDependenciesin interface- Task
- Overrides:
- getTaskDependenciesin class- org.gradle.api.internal.AbstractTask
- Returns:
- The dependencies of this task. Never returns null.
 
- 
onlyIfDescription copied from interface:TaskExecute the task only if the given closure returns true. The closure will be evaluated at task execution time, not during configuration. The closure will be passed a single parameter, this task. If the closure returns false, the task will be skipped. You may add multiple such predicates. The task is skipped if any of the predicates return false. Typical usage: myTask.onlyIf { isProductionEnvironment() }
- 
setOnlyIfDescription copied from interface:TaskExecute the task only if the given closure returns true. The closure will be evaluated at task execution time, not during configuration. The closure will be passed a single parameter, this task. If the closure returns false, the task will be skipped. The given predicate replaces all such predicates for this task. 
- 
getLoggingDescription copied from interface:TaskReturns theLoggingManagerwhich can be used to receive logging and to control the standard output/error capture for this task. By default, System.out is redirected to the Gradle logging system at the QUIET log level, and System.err is redirected at the ERROR log level.- Specified by:
- getLoggingin interface- Task
- Overrides:
- getLoggingin class- org.gradle.api.internal.AbstractTask
- Returns:
- the LoggingManager. Never returns null.
 
- 
getInputspublic org.gradle.api.internal.TaskInputsInternal getInputs()Description copied from interface:TaskReturns the inputs of this task. 
- 
getOutputspublic org.gradle.api.internal.TaskOutputsInternal getOutputs()Description copied from interface:TaskReturns the outputs of this task. - Specified by:
- getOutputsin interface- Task
- Specified by:
- getOutputsin interface- org.gradle.api.internal.TaskInternal
- Overrides:
- getOutputsin class- org.gradle.api.internal.AbstractTask
- Returns:
- The outputs. Never returns null.
 
- 
doFirstDescription copied from interface:TaskAdds the given closure to the beginning of this task's action list. The closure is passed this task as a parameter when executed. 
- 
doLastDescription copied from interface:TaskAdds the given closure to the end of this task's action list. The closure is passed this task as a parameter when executed. 
- 
configureDescription copied from interface:TaskApplies the statements of the closure against this task object. The delegate object for the closure is set to this task. - Specified by:
- configurein interface- Configurable<Task>
- Specified by:
- configurein interface- Task
- Overrides:
- configurein class- org.gradle.api.internal.AbstractTask
- Parameters:
- closure- The closure to be applied (can be null).
- Returns:
- This task
 
- 
getExtensionsDescription copied from interface:ExtensionAwareThe container of extensions.- Specified by:
- getExtensionsin interface- ExtensionAware
- Overrides:
- getExtensionsin class- org.gradle.api.internal.AbstractTask
 
 
-