org.gradle.api.tasks

インタフェース SourceSetOutput

すべてのスーパーインタフェース:

org.gradle.api.tasks.AntBuilderAware, Buildable, FileCollection, Iterable<File>

public interface SourceSetOutput
extends FileCollection

A collection of all output directories (compiled classes, processed resources, etc.) - notice that SourceSetOutput extends FileCollection.

Provides output information of the source set. Allows configuring the default output dirs and specify additional output dirs.

 apply plugin: 'java'

 sourceSets {
   main {
     //if you truly want to override the defaults:
     output.resourcesDir = 'out/res'
     output.classesDir   = 'out/bin'
   }
 }
 

Working with generated resources.

In general, we recommend generating resources into folders different than the regular resourcesDir and classesDir. Usually, it makes the build easier to understand and maintain. Also it gives some additional benefits because other Gradle plugins can take advantage of the output dirs 'registered' in the SourceSet.output. For example: Java plugin will use those dirs in calculating class paths and for jarring the content; IDEA and Eclipse plugins will put those folders on relevant classpath.

An example how to work with generated resources:

 apply plugin: 'java'

 def generatedResources = "$buildDir/generated-resources/main"

 sourceSets {
   main {
     //let's register an output folder on the main SourceSet:
     output.dir(generatedResources, builtBy: 'generateMyResources')
     //it is now a part of the 'main' classpath and will be a part of the jar
   }
 }

 //a task that generates the resources:
 task generateMyResources {
   doLast {
     def generated = new File(generatedResources, "myGeneratedResource.properties")
     generated.text = "message=Stay happy!"
   }
 }

 //Java plugin task 'classes' and 'testClasses' will automatically depend on relevant tasks registered with 'builtBy'

 //Eclipse/IDEA plugins will automatically depend on 'generateMyResources'
 //because the output dir was registered with 'builtBy' information
 apply plugin: 'idea'; apply plugin: 'eclipse'
 

Find more information in dir(java.util.Map, Object) and getDirs()

ネストされたクラスの概要

インタフェースから継承されたネストされたクラス/インタフェース org.gradle.api.file.FileCollection

FileCollection.AntType

メソッドの概要

修飾子とタイプ	メソッドと説明
void	dir(Map<String,Object> options, Object dir) Registers an extra output dir and the builtBy information.
void	dir(Object dir) Registers an extra output dir.
File	getClassesDir() Returns the directory to assemble the compiled classes into.
FileCollection	getDirs() Returns all dirs registered with #dir method.
File	getResourcesDir() Returns the output directory for resources See example at SourceSetOutput
void	setClassesDir(Object classesDir) Sets the directory to assemble the compiled classes into.
void	setResourcesDir(Object resourcesDir) Sets the output directory for resources See example at SourceSetOutput

インタフェースから継承されたメソッド org.gradle.api.file.FileCollection

add, addToAntBuilder, addToAntBuilder, asType, contains, filter, filter, getAsFileTree, getAsPath, getFiles, getSingleFile, isEmpty, minus, plus, stopExecutionIfEmpty

インタフェースから継承されたメソッド java.lang.Iterable

forEach, iterator, spliterator

インタフェースから継承されたメソッド org.gradle.api.Buildable

getBuildDependencies

メソッドの詳細

getClassesDir

File getClassesDir()

Returns the directory to assemble the compiled classes into.

See example at SourceSetOutput

戻り値:

The classes dir. Never returns null.

setClassesDir

void setClassesDir(Object classesDir)

Sets the directory to assemble the compiled classes into.

See example at SourceSetOutput

パラメータ:

classesDir - the classes dir. Should not be null.

getResourcesDir

File getResourcesDir()

Returns the output directory for resources

See example at SourceSetOutput

戻り値:

The dir resources are copied to.

setResourcesDir

void setResourcesDir(Object resourcesDir)

Sets the output directory for resources

See example at SourceSetOutput

パラメータ:

resourcesDir - the classes dir. Should not be null.

dir

void dir(Map<String,Object> options,
         Object dir)

Registers an extra output dir and the builtBy information. Useful for generated resources.

See example at SourceSetOutput

パラメータ:

options - - use 'builtBy' key to configure the 'builtBy' task of the dir

dir - - will be resolved as Project.file(Object)

dir

void dir(Object dir)

Registers an extra output dir. Useful for generated resources.

See example at SourceSetOutput

パラメータ:

dir - - will be resolved as Project.file(Object)

getDirs

FileCollection getDirs()

Returns all dirs registered with #dir method. Each file is resolved as Project.file(Object)

See example at SourceSetOutput

戻り値:

a new instance of registered dirs with resolved files