com.android.build.gradle.tasks

Class ExtractAnnotations

java.lang.Object

org.gradle.api.internal.AbstractTask

org.gradle.api.DefaultTask

com.android.build.gradle.internal.tasks.AndroidVariantTask

com.android.build.gradle.internal.tasks.NonIncrementalTask

com.android.build.gradle.tasks.ExtractAnnotations

All Implemented Interfaces:

com.android.build.gradle.internal.tasks.VariantAwareTask, java.lang.Comparable<org.gradle.api.Task>, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.TaskInternal, org.gradle.api.plugins.ExtensionAware, org.gradle.api.Task, org.gradle.util.Configurable<org.gradle.api.Task>

@CacheableTask
public abstract class ExtractAnnotations
extends com.android.build.gradle.internal.tasks.NonIncrementalTask

Task which extracts annotations from the source files, and writes them to one of two possible destinations:

• A "external annotations" file (pointed to by getOutput()) which records the annotations in a zipped XML format for use by the IDE and by lint to associate the (source retention) annotations back with the compiled code

We typically only extract external annotations when building libraries; ProGuard annotations are extracted when building libraries (to record in the AAR), or when building an app module where ProGuarding is enabled.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ExtractAnnotations.CreationAction

Nested classes/interfaces inherited from interface org.gradle.api.Task

org.gradle.api.Task.Namer

Field Summary

Fields inherited from class com.android.build.gradle.internal.tasks.AndroidVariantTask

variantName

Fields inherited from interface org.gradle.api.Task

TASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE

Constructor Summary

Constructors

Constructor and Description
ExtractAnnotations()

Method Summary

Modifier and Type	Method and Description
protected void	doTaskAction()
org.gradle.api.file.FileCollection	getBootClasspath() Boot classpath: typically android.jar
org.gradle.api.file.FileCollection	getClassDir() Location of class files.
org.gradle.api.file.FileCollection	getClasspath()
java.lang.String	getEncoding() The encoding to use when reading source files.
org.gradle.api.file.FileCollection	getLibraries()
org.gradle.api.file.FileCollection	getLintClassPath() Lint classpath
abstract org.gradle.api.file.RegularFileProperty	getOutput() The output .zip file to write the annotations database to, if any
org.gradle.api.file.FileTree	getSource()
abstract org.gradle.api.file.RegularFileProperty	getTypedefFile() The output .txt file to write the typedef recipe file to.
boolean	hasAndroidAnnotations()
void	setBootClasspath(org.gradle.api.file.FileCollection bootClasspath)
void	setClassDir(org.gradle.api.file.FileCollection classDir)
void	setEncoding(java.lang.String encoding)
void	source(java.lang.Object source) Used by the variant API

Methods inherited from class com.android.build.gradle.internal.tasks.NonIncrementalTask

taskAction

Methods inherited from class com.android.build.gradle.internal.tasks.AndroidVariantTask

getProjectName, getVariantName, getWorkerExecutor, getWorkerFacadeWithThreads, getWorkerFacadeWithWorkers, recordTaskAction, setVariantName

Methods inherited from class org.gradle.api.DefaultTask

newInputDirectory, newInputFile, newOutputDirectory, newOutputFile

Methods inherited from class org.gradle.api.internal.AbstractTask

appendParallelSafeAction, compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getAsDynamicObject, getConvention, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getIdentityPath, getImpliesSubProjects, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOnlyIf, getOutputs, getPath, getProject, getServices, getShouldRunAfter, getStandardOutputCapture, getState, getTaskActions, getTaskDependencies, getTaskIdentity, getTemporaryDir, getTemporaryDirFactory, getTimeout, hasProperty, hasTaskActions, injectIntoNewInstance, isEnabled, isHasCustomActions, mustRunAfter, onlyIf, onlyIf, prependParallelSafeAction, property, replaceLogger, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setImpliesSubProjects, setMustRunAfter, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ExtractAnnotations

public ExtractAnnotations()

Method Detail

getLintClassPath

@InputFiles
 @Nullable
 @PathSensitive(value=RELATIVE)
public org.gradle.api.file.FileCollection getLintClassPath()

Lint classpath

getSource

@NonNull
 @PathSensitive(value=NAME_ONLY)
 @InputFiles
public org.gradle.api.file.FileTree getSource()

getClasspath

@CompileClasspath
 @PathSensitive(value=NONE)
public org.gradle.api.file.FileCollection getClasspath()

source

public void source(java.lang.Object source)

Used by the variant API

getBootClasspath

@CompileClasspath
 @PathSensitive(value=NONE)
public org.gradle.api.file.FileCollection getBootClasspath()

Boot classpath: typically android.jar

setBootClasspath

public void setBootClasspath(org.gradle.api.file.FileCollection bootClasspath)

getLibraries

@CompileClasspath
public org.gradle.api.file.FileCollection getLibraries()

getOutput

@OutputFile
public abstract org.gradle.api.file.RegularFileProperty getOutput()

The output .zip file to write the annotations database to, if any

getTypedefFile

@OutputFile
public abstract org.gradle.api.file.RegularFileProperty getTypedefFile()

The output .txt file to write the typedef recipe file to. A "recipe" file is a file which describes typedef classes, typically ones that should be deleted. It is generated by this ExtractAnnotations task and consumed by the TypedefRemover.

getEncoding

@NonNull
 @Input
public java.lang.String getEncoding()

The encoding to use when reading source files. The output file will ignore this and will always be a UTF-8 encoded .xml file inside the annotations zip file.

setEncoding

public void setEncoding(java.lang.String encoding)

getClassDir

@Optional
 @InputFiles
 @PathSensitive(value=RELATIVE)
public org.gradle.api.file.FileCollection getClassDir()

Location of class files. If set, any non-public typedef source retention annotations will be removed prior to .jar packaging.

setClassDir

public void setClassDir(org.gradle.api.file.FileCollection classDir)

doTaskAction

protected void doTaskAction()

Specified by:

doTaskAction in class com.android.build.gradle.internal.tasks.NonIncrementalTask

hasAndroidAnnotations

@Input
public boolean hasAndroidAnnotations()