build-system/gradle-core/src/main/java/com/android/build/gradle/internal/scope/InternalArtifactType.java - platform/tools/base - Git at Google

 /*
  * Copyright (C) 2018 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */

 package com.android.build.gradle.internal.scope;

 import com.android.annotations.NonNull;
 import com.android.annotations.Nullable;
 import com.android.build.api.artifact.ArtifactType;
 import java.io.File;
 import java.util.Locale;

 /** A type of output generated by a task. */
 public enum InternalArtifactType implements ArtifactType {
     // --- classes ---
     // These are direct task outputs. If you are looking for all the classes of a
     // module, use AnchorOutputType.ALL_CLASSES
     // Javac task output.
     JAVAC,
     // Rewritten classes from non-namespaced dependencies put together into one JAR.
     NAMESPACED_CLASSES_JAR(Kind.FILE),
     // Tested code classes
     TESTED_CODE_CLASSES,
     // Classes with recalculated stack frames information (RecalculateStackFrames task)
     FIXED_STACK_FRAMES,

     // --- Published classes ---
     // Class-type task output for tasks that generate published classes.

     // Packaged classes for library intermediate publishing
     // This is for external usage. For usage inside a module use ALL_CLASSES
     RUNTIME_LIBRARY_CLASSES(Kind.FILE),

     // Packaged library classes published only to compile configuration. This is to allow other
     // projects to compile again classes that were not additionally processed e.g. classes with
     // Jacoco instrumentation (b/109771903).
     COMPILE_LIBRARY_CLASSES(Kind.FILE),

     // Jar generated by the code shrinker
     SHRUNK_CLASSES(Kind.FILE),

     // Dex archive artifacts for project.
     PROJECT_DEX_ARCHIVE,
     // Dex archive artifacts for sub projects.
     SUB_PROJECT_DEX_ARCHIVE,
     // Dex archive artifacts for external (Maven) libraries.
     EXTERNAL_LIBS_DEX_ARCHIVE,
     // Dex archive artifacts for dex'ed classes coming from mixed scopes (to support legacy
     // Transform API that can output classes belonging to multiple scopes).
     MIXED_SCOPE_DEX_ARCHIVE,
     // Artifact for supporting faster incremental dex archive building. This artifact contains
     // information about inputs and it should not be consumed by other tasks.
     DEX_ARCHIVE_INPUT_JAR_HASHES(Kind.FILE),

     // External libraries' dex files only.
     EXTERNAL_LIBS_DEX,
     // External file library dex archives (Desugared separately from module & project dependencies)
     EXTERNAL_FILE_LIB_DEX_ARCHIVES,
     // The final dex files (if the dex splitter does not run)
     // that will get packaged in the APK or bundle.
     DEX,
     // the packaged classes published by APK modules.
     // This is for external usage. For usage inside a module use ALL_CLASSES
     APP_CLASSES(Kind.FILE),

     // Outputs of Desugar tool for project classes.
     DESUGAR_PROJECT_CLASSES,
     // Outputs of Desugar tool for sub-project classes.
     DESUGAR_SUB_PROJECT_CLASSES,
     // Outputs of Desugar tool for external (Maven) library classes.
     DESUGAR_EXTERNAL_LIBS_CLASSES,
     // Local state output for desugar.
     DESUGAR_LOCAL_STATE_OUTPUT,

     // --- java res ---
     // java processing output
     JAVA_RES,
     // merged java resources
     MERGED_JAVA_RES(Kind.FILE),
     // packaged java res for aar intermediate publishing
     LIBRARY_JAVA_RES(Kind.FILE),
     // Resources generated by the code shrinker
     SHRUNK_JAVA_RES(Kind.FILE),

     // Full jar with both classes and java res.
     FULL_JAR(Kind.FILE),

     // A folder with classes instrumented with jacoco. Internal folder file structure reflects
     // the hierarchy of namespaces
     JACOCO_INSTRUMENTED_CLASSES,
     // A folder containing jars with classes instrumented with jacoco
     JACOCO_INSTRUMENTED_JARS,
     // The jacoco code coverage from the connected task
     CODE_COVERAGE(Category.OUTPUTS),
     // The jacoco code coverage from the device provider tasks.
     DEVICE_PROVIDER_CODE_COVERAGE(Category.OUTPUTS),
     // Additional test output data from the connected task
     CONNECTED_ANDROID_TEST_ADDITIONAL_OUTPUT(Category.OUTPUTS),
     // Additional test output data from the device provider tasks.
     DEVICE_PROVIDER_ANDROID_TEST_ADDITIONAL_OUTPUT(Category.OUTPUTS),

     // --- android res ---
     // output of the resource merger ready for aapt.
     MERGED_RES,
     // The R.java file/files as generated by AAPT or by the new resource processing in libraries.
     NOT_NAMESPACED_R_CLASS_SOURCES(Category.GENERATED),
     // The R class jar as compiled from the R.java generated by AAPT or directly generated by
     // the new resource processing in libraries.
     COMPILE_ONLY_NOT_NAMESPACED_R_CLASS_JAR(Kind.FILE),
     // output of the resource merger for unit tests and the resource shrinker.
     MERGED_NOT_COMPILED_RES,
     // Directory containing config file for unit testing with resources
     UNIT_TEST_CONFIG_DIRECTORY,
     // compiled resources (output of aapt)
     PROCESSED_RES,
     // package resources for aar publishing.
     PACKAGED_RES,
     // R.txt output for libraries - contains mock resource IDs used only at compile time.
     COMPILE_SYMBOL_LIST(Kind.FILE),
     // R.txt output for applications and android tests - contains real resource IDs used at runtime.
     RUNTIME_SYMBOL_LIST(Kind.FILE),
     // Synthetic artifacts
     SYMBOL_LIST_WITH_PACKAGE_NAME(Kind.FILE),
     // Resources defined within the AAR.
     DEFINED_ONLY_SYMBOL_LIST,
     //Resources defined within the current module.
     LOCAL_ONLY_SYMBOL_LIST(Kind.FILE),
     // public.txt output
     PUBLIC_RES(Kind.FILE),
     SHRUNK_PROCESSED_RES,
     DENSITY_OR_LANGUAGE_SPLIT_PROCESSED_RES,
     ABI_PROCESSED_SPLIT_RES,
     DENSITY_OR_LANGUAGE_PACKAGED_SPLIT,
     INSTANT_RUN_MAIN_APK_RESOURCES,
     INSTANT_RUN_PACKAGED_RESOURCES,
     INSTANT_RUN_SPLIT_APK_RESOURCES,
     // linked res for the unified bundle
     LINKED_RES_FOR_BUNDLE(Kind.FILE),
     SHRUNK_LINKED_RES_FOR_BUNDLE(Kind.FILE),
     COMPILED_LOCAL_RESOURCES(Kind.DIRECTORY),

     // Artifacts for legacy multidex
     LEGACY_MULTIDEX_AAPT_DERIVED_PROGUARD_RULES(Kind.FILE),
     LEGACY_MULTIDEX_MAIN_DEX_LIST(Kind.FILE),

     // The R class jar generated from R.txt for application and tests
     COMPILE_AND_RUNTIME_NOT_NAMESPACED_R_CLASS_JAR(Kind.FILE),

     // Information neeeded to resolve included navigation graphs into intent filters
     NAVIGATION_JSON(Kind.FILE),

     // --- Namespaced android res ---
     // Compiled resources (directory of .flat files) for the local library
     RES_COMPILED_FLAT_FILES,
     // An AAPT2 static library, containing only the current sub-project's resources.
     RES_STATIC_LIBRARY(Kind.FILE),
     // A directory of AAPT2 static libraries generated from all non-namepaced remote dependencies.
     RES_CONVERTED_NON_NAMESPACED_REMOTE_DEPENDENCIES,
     // Compiled R class jar (for compilation only, packaged in AAR)
     COMPILE_ONLY_NAMESPACED_R_CLASS_JAR(Kind.FILE),
     // JAR file containing all of the auto-namespaced classes from dependencies.
     COMPILE_ONLY_NAMESPACED_DEPENDENCIES_R_JAR(Kind.FILE),
     // Classes JAR files from dependencies that need to be auto-namespaced.
     NON_NAMESPACED_CLASSES,
     // Final R class sources (to package)
     RUNTIME_R_CLASS_SOURCES(Category.GENERATED),
     // Final R class classes (for packaging)
     RUNTIME_R_CLASS_CLASSES,
     // Partial R.txt files generated by AAPT2 at compile time.
     PARTIAL_R_FILES,

     // --- JNI libs ---
     // packaged JNI for inter-project intermediate publishing
     LIBRARY_JNI,
     // packaged JNI for AAR publishing
     LIBRARY_AND_LOCAL_JARS_JNI,
     // source folder jni libs merged into a single folder
     MERGED_JNI_LIBS,
     // source folder shaders merged into a single folder
     MERGED_SHADERS,
     // folder for NDK *.so libraries
     NDK_LIBS,
     // native libs merged from module(s)
     MERGED_NATIVE_LIBS,
     // native libs stripped of debug symbols
     STRIPPED_NATIVE_LIBS,

     // Assets created by compiling shader
     SHADER_ASSETS,

     LIBRARY_ASSETS,
     MERGED_ASSETS,

     // AIDL headers "packaged" by libraries for consumers.
     AIDL_PARCELABLE,
     AIDL_SOURCE_OUTPUT_DIR(Category.GENERATED),
     // renderscript headers "packaged" by libraries for consumers.
     RENDERSCRIPT_HEADERS,
     // source output for rs
     RENDERSCRIPT_SOURCE_OUTPUT_DIR(Category.GENERATED),
     // renderscript library
     RENDERSCRIPT_LIB,

     // An output of AndroidManifest.xml check
     CHECK_MANIFEST_RESULT,

     COMPATIBLE_SCREEN_MANIFEST,
     MERGED_MANIFESTS,
     LIBRARY_MANIFEST(Kind.FILE),
     // Same as above, but the resource references have stripped namespaces.
     NON_NAMESPACED_LIBRARY_MANIFEST(Kind.FILE),
     // A directory of AAR manifests that have been auto-namespaced and are fully resource namespace aware.
     NAMESPACED_MANIFESTS,
     AAPT_FRIENDLY_MERGED_MANIFESTS,
     INSTANT_APP_MANIFEST,
     MANIFEST_METADATA,
     MANIFEST_MERGE_REPORT(Kind.FILE),
     MANIFEST_MERGE_BLAME_FILE(Kind.FILE),
     // Simplified android manifest with original package name.
     // It's used to create namespaced res.apk static library.
     STATIC_LIBRARY_MANIFEST(Kind.FILE),

     // List of annotation processors for metrics.
     ANNOTATION_PROCESSOR_LIST(Kind.FILE),
     // The sources generated by annotation processors.
     AP_GENERATED_SOURCES(Category.GENERATED, Kind.DIRECTORY),

     // merged generated + consumer shrinker configs to be used when packaging rules into an AAR
     MERGED_CONSUMER_PROGUARD_FILE(Kind.FILE),
     // the directory that consumers of an AAR or feature module can use for additional proguard rules.
     CONSUMER_PROGUARD_DIR(Kind.DIRECTORY),
     // the proguard rules produced by aapt.
     AAPT_PROGUARD_FILE(Kind.FILE),
     // the merger of a module's AAPT_PROGUARD_FILE and those of its feature(s)
     MERGED_AAPT_PROGUARD_FILE(Kind.FILE),

     // the data binding artifact for a library that gets published with the aar
     DATA_BINDING_ARTIFACT,
     // the merged data binding artifacts from all the dependencies
     DATA_BINDING_DEPENDENCY_ARTIFACTS,
     // directory containing layout info files for data binding when merge-resources type == MERGE
     DATA_BINDING_LAYOUT_INFO_TYPE_MERGE,
     // directory containing layout info files for data binding when merge-resources type == PACKAGE
     // see https://issuetracker.google.com/110412851
     DATA_BINDING_LAYOUT_INFO_TYPE_PACKAGE,
     // the generated base classes artifacts from all dependencies
     DATA_BINDING_BASE_CLASS_LOGS_DEPENDENCY_ARTIFACTS,
     // the data binding class log generated after compilation, includes merged
     // class info file
     DATA_BINDING_BASE_CLASS_LOG_ARTIFACT,
     // source code generated by data binding tasks.
     DATA_BINDING_BASE_CLASS_SOURCE_OUT(Category.GENERATED),

     // The lint JAR to be used for the current module.
     LINT_JAR(Kind.FILE),
     // The lint JAR to be published in the AAR.
     LINT_PUBLISH_JAR(Kind.FILE),

     // the zip file output of the extract annotation class.
     ANNOTATIONS_ZIP(Kind.FILE),
     // Optional recipe file (only used for libraries) which describes typedefs defined in the
     // library, and how to process them (typically which typedefs to omit during packaging).
     ANNOTATIONS_TYPEDEF_FILE(Kind.FILE),
     // the associated proguard file
     ANNOTATIONS_PROGUARD,
     // The classes.jar for the AAR
     AAR_MAIN_JAR(Kind.FILE),
     // The libs/ directory for the AAR, containing secondary jars
     AAR_LIBS_DIRECTORY,

     ABI_PACKAGED_SPLIT,
     FULL_APK,
     APK,
     APK_FOR_LOCAL_TEST(Kind.FILE),
     APK_MAPPING(Category.OUTPUTS, Kind.FILE, "mapping"),
     // zip of APK + mapping files used when publishing the APKs to a repo
     APK_ZIP(Category.OUTPUTS, Kind.FILE, "apk-zips"),
     AAR(Kind.FILE),
     INSTANTAPP_BUNDLE,
     SPLIT_LIST,
     APK_LIST(Kind.FILE),

     // an intermediate bundle that contains only the current module
     MODULE_BUNDLE,
     // The main dex list for the bundle, unlike the main dex list for a monolithic application, this
     // analyzes all of the dynamic feature classes too.
     MAIN_DEX_LIST_FOR_BUNDLE(Kind.FILE),
     // The final Bundle, including feature module, ready for consumption at Play Store.
     // This is only valid for the base module.
     BUNDLE(Category.OUTPUTS, Kind.FILE),
     // The bundle artifact, including feature module, used as the base for further processing,
     // like extracting APKs. It's cheaper to produce but not suitable as a final artifact to send
     // to the Play Store.
     // This is only valid for the base module.
     INTERMEDIARY_BUNDLE(Category.INTERMEDIATES, Kind.FILE),
     // APK Set archive with APKs generated from a bundle.
     APKS_FROM_BUNDLE(Kind.FILE),
     // output of ExtractApks applied to APKS_FROM_BUNDLE and a device config.
     EXTRACTED_APKS,
     // Universal APK from the bundle
     UNIVERSAL_APK(Category.OUTPUTS, Kind.FILE),
     // The manifest meant to be consumed by the bundle.
     BUNDLE_MANIFEST,

     // file containing the metadata for the full feature set. This contains the feature names,
     // the res ID offset, both tied to the feature module path. Published by the base for the
     // other features to consume and find their own metadata.
     FEATURE_SET_METADATA(Kind.FILE),
     // file containing the module information (like its application ID) to synchronize all base
     // and dynamic feature. This is published by the base feature and installed application module.
     METADATA_BASE_MODULE_DECLARATION(Kind.FILE),
     // file containing only the application ID. It is used to synchronize all feature plugins
     // with the application module's application ID.
     METADATA_APPLICATION_ID(Kind.FILE),
     FEATURE_RESOURCE_PKG,
     // File containing the list of packaged dependencies of a given APK. This is consumed
     // by other APKs to avoid repackaging the same thing.
     PACKAGED_DEPENDENCIES(Kind.FILE),
     // The information about the features in the app that is necessary for the data binding
     // annotation processor (for base feature compilation). Created by the
     // DataBindingExportFeatureApplicationIdsTask and passed down to the annotation processor via
     // processor args.
     FEATURE_DATA_BINDING_BASE_FEATURE_INFO,
     // The information about the feature that is necessary for the data binding annotation
     // processor (for feature compilation). Created by DataBindingExportFeatureInfoTask and passed
     // into the annotation processor via processor args.
     FEATURE_DATA_BINDING_FEATURE_INFO,
     // The base dex files output by the DexSplitter.
     BASE_DEX,
     // The feature dex files output by the DexSplitter from the base. The base produces and
     // publishes these files when there's multi-apk code shrinking.
     FEATURE_DEX,
     // The class files for a module and all of its runtime dependencies.
     MODULE_AND_RUNTIME_DEPS_CLASSES(Kind.FILE),

     // The signing configuration the feature module should be using, which is taken from the
     // application module. Also used for androidTest variants (bug 118611693). This has already
     // been validated
     SIGNING_CONFIG,
     // The validated signing config output, to allow the task to be up to date, and for allowing
     // other tasks to depend on the output.
     VALIDATE_SIGNING_CONFIG,

     // Project metadata
     METADATA_FEATURE_DECLARATION,
     METADATA_FEATURE_MANIFEST,
     METADATA_INSTALLED_BASE_DECLARATION(Kind.FILE),
     // The metadata for the library dependencies, direct and indirect, published for each module.
     METADATA_LIBRARY_DEPENDENCIES_REPORT(Kind.FILE),

     // The library dependencies report, direct and indirect, published for the entire app to
     // package in the bundle.
     BUNDLE_DEPENDENCY_REPORT(Kind.FILE),

     INSTANT_RUN_APP_INFO_OUTPUT_FILE,

     // A dummy output (folder) result of CheckDuplicateClassesTask execution
     DUPLICATE_CLASSES_CHECK,

     // File containing all generated proguard rules from Javac (by e.g. dagger) merged together
     GENERATED_PROGUARD_FILE(Kind.FILE),

     // File containing unused dependencies and dependencies that can be configured as
     // implementation in the current variant
     ANALYZE_DEPENDENCIES_REPORT(Kind.DIRECTORY);

     /**
      * Defines the kind of artifact type. this will be used to determine the output file location
      * for instance.
      */
     enum Category {
         /* Generated files that are meant to be visible to users from the IDE */
         GENERATED,
         /* Intermediates files produced by tasks. */
         INTERMEDIATES,
         /* output files going into the outputs folder. This is the result of the build. */
         OUTPUTS;

         /**
          * Return the file location for this kind of artifact type.
          *
          * @param parentDir the parent build directory
          * @return a file location which is task and variant independent.
          */
         @NonNull
         File getOutputDir(File parentDir) {
             return new File(parentDir, name().toLowerCase(Locale.US));
         }

         @NonNull
         String getOutputPath() {
             return name().toLowerCase(Locale.US);
         }
     }

     final Category category;
     final Kind kind;
     @Nullable final String folderName;

     @Override
     @NonNull
     public Kind kind() {
         return kind;
     }

     InternalArtifactType() {
         this(Category.INTERMEDIATES, Kind.DIRECTORY, null);
     }

     InternalArtifactType(Category category) {
         this(category, Kind.DIRECTORY, null);
     }

     InternalArtifactType(Kind kind) {
         this(Category.INTERMEDIATES, kind, null);
     }

     InternalArtifactType(Category category, Kind kind) {
         this(category, kind, null);
     }

     InternalArtifactType(Category category, Kind kind, @Nullable String folderName) {
         this.category = category;
         this.kind = kind;
         this.folderName = folderName;
     }

     @NonNull
     @Override
     public String getFolderName() {
         return folderName != null ? folderName : name().toLowerCase(Locale.US);
     }
 }
	/*
	* Copyright (C) 2018 The Android Open Source Project
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/

	package com.android.build.gradle.internal.scope;

	import com.android.annotations.NonNull;
	import com.android.annotations.Nullable;
	import com.android.build.api.artifact.ArtifactType;
	import java.io.File;
	import java.util.Locale;

	/** A type of output generated by a task. */
	public enum InternalArtifactType implements ArtifactType {
	// --- classes ---
	// These are direct task outputs. If you are looking for all the classes of a
	// module, use AnchorOutputType.ALL_CLASSES
	// Javac task output.
	JAVAC,
	// Rewritten classes from non-namespaced dependencies put together into one JAR.
	NAMESPACED_CLASSES_JAR(Kind.FILE),
	// Tested code classes
	TESTED_CODE_CLASSES,
	// Classes with recalculated stack frames information (RecalculateStackFrames task)
	FIXED_STACK_FRAMES,

	// --- Published classes ---
	// Class-type task output for tasks that generate published classes.

	// Packaged classes for library intermediate publishing
	// This is for external usage. For usage inside a module use ALL_CLASSES
	RUNTIME_LIBRARY_CLASSES(Kind.FILE),

	// Packaged library classes published only to compile configuration. This is to allow other
	// projects to compile again classes that were not additionally processed e.g. classes with
	// Jacoco instrumentation (b/109771903).
	COMPILE_LIBRARY_CLASSES(Kind.FILE),

	// Jar generated by the code shrinker
	SHRUNK_CLASSES(Kind.FILE),

	// Dex archive artifacts for project.
	PROJECT_DEX_ARCHIVE,
	// Dex archive artifacts for sub projects.
	SUB_PROJECT_DEX_ARCHIVE,
	// Dex archive artifacts for external (Maven) libraries.
	EXTERNAL_LIBS_DEX_ARCHIVE,
	// Dex archive artifacts for dex'ed classes coming from mixed scopes (to support legacy
	// Transform API that can output classes belonging to multiple scopes).
	MIXED_SCOPE_DEX_ARCHIVE,
	// Artifact for supporting faster incremental dex archive building. This artifact contains
	// information about inputs and it should not be consumed by other tasks.
	DEX_ARCHIVE_INPUT_JAR_HASHES(Kind.FILE),

	// External libraries' dex files only.
	EXTERNAL_LIBS_DEX,
	// External file library dex archives (Desugared separately from module & project dependencies)
	EXTERNAL_FILE_LIB_DEX_ARCHIVES,
	// The final dex files (if the dex splitter does not run)
	// that will get packaged in the APK or bundle.
	DEX,
	// the packaged classes published by APK modules.
	// This is for external usage. For usage inside a module use ALL_CLASSES
	APP_CLASSES(Kind.FILE),

	// Outputs of Desugar tool for project classes.
	DESUGAR_PROJECT_CLASSES,
	// Outputs of Desugar tool for sub-project classes.
	DESUGAR_SUB_PROJECT_CLASSES,
	// Outputs of Desugar tool for external (Maven) library classes.
	DESUGAR_EXTERNAL_LIBS_CLASSES,
	// Local state output for desugar.
	DESUGAR_LOCAL_STATE_OUTPUT,

	// --- java res ---
	// java processing output
	JAVA_RES,
	// merged java resources
	MERGED_JAVA_RES(Kind.FILE),
	// packaged java res for aar intermediate publishing
	LIBRARY_JAVA_RES(Kind.FILE),
	// Resources generated by the code shrinker
	SHRUNK_JAVA_RES(Kind.FILE),

	// Full jar with both classes and java res.
	FULL_JAR(Kind.FILE),

	// A folder with classes instrumented with jacoco. Internal folder file structure reflects
	// the hierarchy of namespaces
	JACOCO_INSTRUMENTED_CLASSES,
	// A folder containing jars with classes instrumented with jacoco
	JACOCO_INSTRUMENTED_JARS,
	// The jacoco code coverage from the connected task
	CODE_COVERAGE(Category.OUTPUTS),
	// The jacoco code coverage from the device provider tasks.
	DEVICE_PROVIDER_CODE_COVERAGE(Category.OUTPUTS),
	// Additional test output data from the connected task
	CONNECTED_ANDROID_TEST_ADDITIONAL_OUTPUT(Category.OUTPUTS),
	// Additional test output data from the device provider tasks.
	DEVICE_PROVIDER_ANDROID_TEST_ADDITIONAL_OUTPUT(Category.OUTPUTS),

	// --- android res ---
	// output of the resource merger ready for aapt.
	MERGED_RES,
	// The R.java file/files as generated by AAPT or by the new resource processing in libraries.
	NOT_NAMESPACED_R_CLASS_SOURCES(Category.GENERATED),
	// The R class jar as compiled from the R.java generated by AAPT or directly generated by
	// the new resource processing in libraries.
	COMPILE_ONLY_NOT_NAMESPACED_R_CLASS_JAR(Kind.FILE),
	// output of the resource merger for unit tests and the resource shrinker.
	MERGED_NOT_COMPILED_RES,
	// Directory containing config file for unit testing with resources
	UNIT_TEST_CONFIG_DIRECTORY,
	// compiled resources (output of aapt)
	PROCESSED_RES,
	// package resources for aar publishing.
	PACKAGED_RES,
	// R.txt output for libraries - contains mock resource IDs used only at compile time.
	COMPILE_SYMBOL_LIST(Kind.FILE),
	// R.txt output for applications and android tests - contains real resource IDs used at runtime.
	RUNTIME_SYMBOL_LIST(Kind.FILE),
	// Synthetic artifacts
	SYMBOL_LIST_WITH_PACKAGE_NAME(Kind.FILE),
	// Resources defined within the AAR.
	DEFINED_ONLY_SYMBOL_LIST,
	//Resources defined within the current module.
	LOCAL_ONLY_SYMBOL_LIST(Kind.FILE),
	// public.txt output
	PUBLIC_RES(Kind.FILE),
	SHRUNK_PROCESSED_RES,
	DENSITY_OR_LANGUAGE_SPLIT_PROCESSED_RES,
	ABI_PROCESSED_SPLIT_RES,
	DENSITY_OR_LANGUAGE_PACKAGED_SPLIT,
	INSTANT_RUN_MAIN_APK_RESOURCES,
	INSTANT_RUN_PACKAGED_RESOURCES,
	INSTANT_RUN_SPLIT_APK_RESOURCES,
	// linked res for the unified bundle
	LINKED_RES_FOR_BUNDLE(Kind.FILE),
	SHRUNK_LINKED_RES_FOR_BUNDLE(Kind.FILE),
	COMPILED_LOCAL_RESOURCES(Kind.DIRECTORY),

	// Artifacts for legacy multidex
	LEGACY_MULTIDEX_AAPT_DERIVED_PROGUARD_RULES(Kind.FILE),
	LEGACY_MULTIDEX_MAIN_DEX_LIST(Kind.FILE),

	// The R class jar generated from R.txt for application and tests
	COMPILE_AND_RUNTIME_NOT_NAMESPACED_R_CLASS_JAR(Kind.FILE),

	// Information neeeded to resolve included navigation graphs into intent filters
	NAVIGATION_JSON(Kind.FILE),

	// --- Namespaced android res ---
	// Compiled resources (directory of .flat files) for the local library
	RES_COMPILED_FLAT_FILES,
	// An AAPT2 static library, containing only the current sub-project's resources.
	RES_STATIC_LIBRARY(Kind.FILE),
	// A directory of AAPT2 static libraries generated from all non-namepaced remote dependencies.
	RES_CONVERTED_NON_NAMESPACED_REMOTE_DEPENDENCIES,
	// Compiled R class jar (for compilation only, packaged in AAR)
	COMPILE_ONLY_NAMESPACED_R_CLASS_JAR(Kind.FILE),
	// JAR file containing all of the auto-namespaced classes from dependencies.
	COMPILE_ONLY_NAMESPACED_DEPENDENCIES_R_JAR(Kind.FILE),
	// Classes JAR files from dependencies that need to be auto-namespaced.
	NON_NAMESPACED_CLASSES,
	// Final R class sources (to package)
	RUNTIME_R_CLASS_SOURCES(Category.GENERATED),
	// Final R class classes (for packaging)
	RUNTIME_R_CLASS_CLASSES,
	// Partial R.txt files generated by AAPT2 at compile time.
	PARTIAL_R_FILES,

	// --- JNI libs ---
	// packaged JNI for inter-project intermediate publishing
	LIBRARY_JNI,
	// packaged JNI for AAR publishing
	LIBRARY_AND_LOCAL_JARS_JNI,
	// source folder jni libs merged into a single folder
	MERGED_JNI_LIBS,
	// source folder shaders merged into a single folder
	MERGED_SHADERS,
	// folder for NDK *.so libraries
	NDK_LIBS,
	// native libs merged from module(s)
	MERGED_NATIVE_LIBS,
	// native libs stripped of debug symbols
	STRIPPED_NATIVE_LIBS,

	// Assets created by compiling shader
	SHADER_ASSETS,

	LIBRARY_ASSETS,
	MERGED_ASSETS,

	// AIDL headers "packaged" by libraries for consumers.
	AIDL_PARCELABLE,
	AIDL_SOURCE_OUTPUT_DIR(Category.GENERATED),
	// renderscript headers "packaged" by libraries for consumers.
	RENDERSCRIPT_HEADERS,
	// source output for rs
	RENDERSCRIPT_SOURCE_OUTPUT_DIR(Category.GENERATED),
	// renderscript library
	RENDERSCRIPT_LIB,

	// An output of AndroidManifest.xml check
	CHECK_MANIFEST_RESULT,

	COMPATIBLE_SCREEN_MANIFEST,
	MERGED_MANIFESTS,
	LIBRARY_MANIFEST(Kind.FILE),
	// Same as above, but the resource references have stripped namespaces.
	NON_NAMESPACED_LIBRARY_MANIFEST(Kind.FILE),
	// A directory of AAR manifests that have been auto-namespaced and are fully resource namespace aware.
	NAMESPACED_MANIFESTS,
	AAPT_FRIENDLY_MERGED_MANIFESTS,
	INSTANT_APP_MANIFEST,
	MANIFEST_METADATA,
	MANIFEST_MERGE_REPORT(Kind.FILE),
	MANIFEST_MERGE_BLAME_FILE(Kind.FILE),
	// Simplified android manifest with original package name.
	// It's used to create namespaced res.apk static library.
	STATIC_LIBRARY_MANIFEST(Kind.FILE),

	// List of annotation processors for metrics.
	ANNOTATION_PROCESSOR_LIST(Kind.FILE),
	// The sources generated by annotation processors.
	AP_GENERATED_SOURCES(Category.GENERATED, Kind.DIRECTORY),

	// merged generated + consumer shrinker configs to be used when packaging rules into an AAR
	MERGED_CONSUMER_PROGUARD_FILE(Kind.FILE),
	// the directory that consumers of an AAR or feature module can use for additional proguard rules.
	CONSUMER_PROGUARD_DIR(Kind.DIRECTORY),
	// the proguard rules produced by aapt.
	AAPT_PROGUARD_FILE(Kind.FILE),
	// the merger of a module's AAPT_PROGUARD_FILE and those of its feature(s)
	MERGED_AAPT_PROGUARD_FILE(Kind.FILE),

	// the data binding artifact for a library that gets published with the aar
	DATA_BINDING_ARTIFACT,
	// the merged data binding artifacts from all the dependencies
	DATA_BINDING_DEPENDENCY_ARTIFACTS,
	// directory containing layout info files for data binding when merge-resources type == MERGE
	DATA_BINDING_LAYOUT_INFO_TYPE_MERGE,
	// directory containing layout info files for data binding when merge-resources type == PACKAGE
	// see https://issuetracker.google.com/110412851
	DATA_BINDING_LAYOUT_INFO_TYPE_PACKAGE,
	// the generated base classes artifacts from all dependencies
	DATA_BINDING_BASE_CLASS_LOGS_DEPENDENCY_ARTIFACTS,
	// the data binding class log generated after compilation, includes merged
	// class info file
	DATA_BINDING_BASE_CLASS_LOG_ARTIFACT,
	// source code generated by data binding tasks.
	DATA_BINDING_BASE_CLASS_SOURCE_OUT(Category.GENERATED),

	// The lint JAR to be used for the current module.
	LINT_JAR(Kind.FILE),
	// The lint JAR to be published in the AAR.
	LINT_PUBLISH_JAR(Kind.FILE),

	// the zip file output of the extract annotation class.
	ANNOTATIONS_ZIP(Kind.FILE),
	// Optional recipe file (only used for libraries) which describes typedefs defined in the
	// library, and how to process them (typically which typedefs to omit during packaging).
	ANNOTATIONS_TYPEDEF_FILE(Kind.FILE),
	// the associated proguard file
	ANNOTATIONS_PROGUARD,
	// The classes.jar for the AAR
	AAR_MAIN_JAR(Kind.FILE),
	// The libs/ directory for the AAR, containing secondary jars
	AAR_LIBS_DIRECTORY,

	ABI_PACKAGED_SPLIT,
	FULL_APK,
	APK,
	APK_FOR_LOCAL_TEST(Kind.FILE),
	APK_MAPPING(Category.OUTPUTS, Kind.FILE, "mapping"),
	// zip of APK + mapping files used when publishing the APKs to a repo
	APK_ZIP(Category.OUTPUTS, Kind.FILE, "apk-zips"),
	AAR(Kind.FILE),
	INSTANTAPP_BUNDLE,
	SPLIT_LIST,
	APK_LIST(Kind.FILE),

	// an intermediate bundle that contains only the current module
	MODULE_BUNDLE,
	// The main dex list for the bundle, unlike the main dex list for a monolithic application, this
	// analyzes all of the dynamic feature classes too.
	MAIN_DEX_LIST_FOR_BUNDLE(Kind.FILE),
	// The final Bundle, including feature module, ready for consumption at Play Store.
	// This is only valid for the base module.
	BUNDLE(Category.OUTPUTS, Kind.FILE),
	// The bundle artifact, including feature module, used as the base for further processing,
	// like extracting APKs. It's cheaper to produce but not suitable as a final artifact to send
	// to the Play Store.
	// This is only valid for the base module.
	INTERMEDIARY_BUNDLE(Category.INTERMEDIATES, Kind.FILE),
	// APK Set archive with APKs generated from a bundle.
	APKS_FROM_BUNDLE(Kind.FILE),
	// output of ExtractApks applied to APKS_FROM_BUNDLE and a device config.
	EXTRACTED_APKS,
	// Universal APK from the bundle
	UNIVERSAL_APK(Category.OUTPUTS, Kind.FILE),
	// The manifest meant to be consumed by the bundle.
	BUNDLE_MANIFEST,

	// file containing the metadata for the full feature set. This contains the feature names,
	// the res ID offset, both tied to the feature module path. Published by the base for the
	// other features to consume and find their own metadata.
	FEATURE_SET_METADATA(Kind.FILE),
	// file containing the module information (like its application ID) to synchronize all base
	// and dynamic feature. This is published by the base feature and installed application module.
	METADATA_BASE_MODULE_DECLARATION(Kind.FILE),
	// file containing only the application ID. It is used to synchronize all feature plugins
	// with the application module's application ID.
	METADATA_APPLICATION_ID(Kind.FILE),
	FEATURE_RESOURCE_PKG,
	// File containing the list of packaged dependencies of a given APK. This is consumed
	// by other APKs to avoid repackaging the same thing.
	PACKAGED_DEPENDENCIES(Kind.FILE),
	// The information about the features in the app that is necessary for the data binding
	// annotation processor (for base feature compilation). Created by the
	// DataBindingExportFeatureApplicationIdsTask and passed down to the annotation processor via
	// processor args.
	FEATURE_DATA_BINDING_BASE_FEATURE_INFO,
	// The information about the feature that is necessary for the data binding annotation
	// processor (for feature compilation). Created by DataBindingExportFeatureInfoTask and passed
	// into the annotation processor via processor args.
	FEATURE_DATA_BINDING_FEATURE_INFO,
	// The base dex files output by the DexSplitter.
	BASE_DEX,
	// The feature dex files output by the DexSplitter from the base. The base produces and
	// publishes these files when there's multi-apk code shrinking.
	FEATURE_DEX,
	// The class files for a module and all of its runtime dependencies.
	MODULE_AND_RUNTIME_DEPS_CLASSES(Kind.FILE),

	// The signing configuration the feature module should be using, which is taken from the
	// application module. Also used for androidTest variants (bug 118611693). This has already
	// been validated
	SIGNING_CONFIG,
	// The validated signing config output, to allow the task to be up to date, and for allowing
	// other tasks to depend on the output.
	VALIDATE_SIGNING_CONFIG,

	// Project metadata
	METADATA_FEATURE_DECLARATION,
	METADATA_FEATURE_MANIFEST,
	METADATA_INSTALLED_BASE_DECLARATION(Kind.FILE),
	// The metadata for the library dependencies, direct and indirect, published for each module.
	METADATA_LIBRARY_DEPENDENCIES_REPORT(Kind.FILE),

	// The library dependencies report, direct and indirect, published for the entire app to
	// package in the bundle.
	BUNDLE_DEPENDENCY_REPORT(Kind.FILE),

	INSTANT_RUN_APP_INFO_OUTPUT_FILE,

	// A dummy output (folder) result of CheckDuplicateClassesTask execution
	DUPLICATE_CLASSES_CHECK,

	// File containing all generated proguard rules from Javac (by e.g. dagger) merged together
	GENERATED_PROGUARD_FILE(Kind.FILE),

	// File containing unused dependencies and dependencies that can be configured as
	// implementation in the current variant
	ANALYZE_DEPENDENCIES_REPORT(Kind.DIRECTORY);

	/**
	* Defines the kind of artifact type. this will be used to determine the output file location
	* for instance.
	*/
	enum Category {
	/* Generated files that are meant to be visible to users from the IDE */
	GENERATED,
	/* Intermediates files produced by tasks. */
	INTERMEDIATES,
	/* output files going into the outputs folder. This is the result of the build. */
	OUTPUTS;

	/**
	* Return the file location for this kind of artifact type.
	*
	* @param parentDir the parent build directory
	* @return a file location which is task and variant independent.
	*/
	@NonNull
	File getOutputDir(File parentDir) {
	return new File(parentDir, name().toLowerCase(Locale.US));
	}

	@NonNull
	String getOutputPath() {
	return name().toLowerCase(Locale.US);
	}
	}

	final Category category;
	final Kind kind;
	@Nullable final String folderName;

	@Override
	@NonNull
	public Kind kind() {
	return kind;
	}

	InternalArtifactType() {
	this(Category.INTERMEDIATES, Kind.DIRECTORY, null);
	}

	InternalArtifactType(Category category) {
	this(category, Kind.DIRECTORY, null);
	}

	InternalArtifactType(Kind kind) {
	this(Category.INTERMEDIATES, kind, null);
	}

	InternalArtifactType(Category category, Kind kind) {
	this(category, kind, null);
	}

	InternalArtifactType(Category category, Kind kind, @Nullable String folderName) {
	this.category = category;
	this.kind = kind;
	this.folderName = folderName;
	}

	@NonNull
	@Override
	public String getFolderName() {
	return folderName != null ? folderName : name().toLowerCase(Locale.US);
	}
	}