# Deprecated API

## Contents

- Deprecated Packages
- Deprecated Interfaces
- Deprecated Classes
- Deprecated Annotation Types
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

- Deprecated Packages
  Package | Description
  --- | ---
  org.gradle.api.dsl | This package will be removed in Gradle 5.0.

- Deprecated Interfaces
  Interface | Description
  --- | ---
  org.gradle.api.tasks.CompatibilityAdapterForTaskInputs | The interface is only here to allow plugins built against Gradle <4.3 to run and it will be removed in Gradle 6.0.
  org.gradle.api.tasks.compile.CompilerArgumentProvider | Use `CommandLineArgumentProvider` directly.
  org.gradle.api.plugins.quality.FindBugsReports | FindBugs is unmaintained and does not support bytecode compiled for Java 9 and above.
  org.gradle.api.plugins.quality.FindBugsXmlReport | FindBugs is unmaintained and does not support bytecode compiled for Java 9 and above.
  org.gradle.api.plugins.quality.JDependReports | JDepend is unmaintained and does not support bytecode compiled for Java 8 and above.
  org.gradle.api.plugins.osgi.OsgiManifest

- Deprecated Classes
  Class | Description
  --- | ---
  org.gradle.api.plugins.announce.AnnouncePlugin | This plugin will be removed in the next major version.
  org.gradle.api.plugins.announce.AnnouncePluginExtension
  org.gradle.api.plugins.announce.BuildAnnouncementsPlugin | This plugin will be removed in the next major version.
  org.gradle.api.dsl.ConventionProperty | This class will be removed in Gradle 5.0.
  org.gradle.api.plugins.quality.FindBugs | FindBugs is unmaintained and does not support bytecode compiled for Java 9 and above.
  org.gradle.api.plugins.quality.FindBugsExtension | FindBugs is unmaintained and does not support bytecode compiled for Java 9 and above.
  org.gradle.api.plugins.quality.FindBugsPlugin | FindBugs is unmaintained and does not support bytecode compiled for Java 9 and above.
  org.gradle.api.plugins.quality.JDepend | JDepend is unmaintained and does not support bytecode compiled for Java 8 and above.
  org.gradle.api.plugins.quality.JDependExtension | JDepend is unmaintained and does not support bytecode compiled for Java 8 and above.
  org.gradle.api.plugins.quality.JDependPlugin | JDepend is unmaintained and does not support bytecode compiled for Java 8 and above.
  org.gradle.api.plugins.osgi.OsgiPlugin
  org.gradle.api.plugins.osgi.OsgiPluginConvention

- Deprecated Annotation Types
  Annotation Type | Description
  --- | ---
  org.gradle.api.Nullable | Use `Nullable` instead.

- Deprecated Fields
  Field | Description
  --- | ---
  org.gradle.api.plugins.JavaPlugin.COMPILE_CONFIGURATION_NAME | Users should prefer `JavaPlugin.API_CONFIGURATION_NAME` or `JavaPlugin.IMPLEMENTATION_CONFIGURATION_NAME`.
  org.gradle.api.plugins.JavaPlugin.RUNTIME_CONFIGURATION_NAME | Consumers should use `JavaPlugin.RUNTIME_ELEMENTS_CONFIGURATION_NAME` instead.
  org.gradle.api.plugins.JavaPlugin.TEST_RUNTIME_CONFIGURATION_NAME | Use `JavaPlugin.TEST_RUNTIME_CLASSPATH_CONFIGURATION_NAME` instead.

- Deprecated Methods
  Method | Description
  --- | ---
  org.gradle.api.plugins.PluginCollection.add(T) | Use `PluginManager.apply(Class)` instead.
  org.gradle.api.plugins.PluginCollection.addAll(Collection<? extends T>) | Use `PluginManager.apply(Class)` instead.
  org.gradle.api.plugins.PluginCollection.clear() | plugins cannot be removed.
  org.gradle.testing.jacoco.plugins.JacocoPlugin.configureDefaultOutputPathForJacocoMerge() | This method will be made private in a future version of Gradle.
  org.gradle.api.file.ProjectLayout.directoryProperty() | Replaced by `ObjectFactory.directoryProperty()`
  org.gradle.api.file.ProjectLayout.directoryProperty(Provider<? extends Directory>) | Replaced by `ObjectFactory.directoryProperty()`
  org.gradle.api.file.ProjectLayout.fileProperty() | Replaced by `ObjectFactory.fileProperty()`
  org.gradle.api.file.ProjectLayout.fileProperty(Provider<? extends RegularFile>) | Replaced by `ObjectFactory.fileProperty()`
  org.gradle.api.artifacts.result.ComponentSelectionReason.getDescription() | Use `ComponentSelectionReason.getDescriptions()` instead
  org.gradle.api.tasks.compile.JavaCompile.getEffectiveAnnotationProcessorPath() | Use `CompileOptions.getAnnotationProcessorPath()` instead.
  org.gradle.language.scala.tasks.AbstractScalaCompile.getEffectiveAnnotationProcessorPath() | Use `CompileOptions.getAnnotationProcessorPath()` instead.
  org.gradle.tooling.model.idea.IdeaContentRoot.getGeneratedSourceDirectories() | Use `IdeaContentRoot.getSourceDirectories()` in combination with `IdeaSourceDirectory.isGenerated()` instead.
  org.gradle.tooling.model.idea.IdeaContentRoot.getGeneratedTestDirectories() | Use `IdeaContentRoot.getTestDirectories()` in combination with `IdeaSourceDirectory.isGenerated()` instead.
  org.gradle.api.plugins.ExtensionContainer.getSchema()
  org.gradle.testing.jacoco.plugins.JacocoTaskExtension.isAppend() | The Jacoco plugin now deletes the old coverage file before task execution, so the data will never be appended to an existing coverage file from another task. Use `JacocoMerge` to merge different execution files or use `JacocoReportBase.setExecutionData(FileCollection)` to generate a report from multiple execution files at once. Append is set to true for the agent since this allows multiple JVMs spawned by one task to write to the same `JacocoTaskExtension.destinationFile`.
  org.gradle.StartParameter.isInteractive() | This flag is no longer used and simply defaults to 'false'.
  org.gradle.api.tasks.SourceSetOutput.isLegacyLayout() | This method always returns false starting from Gradle 5.0.
  org.gradle.StartParameter.isRecompileScripts() | This flag is no longer used.
  org.gradle.api.artifacts.repositories.IvyArtifactRepository.layout(String, Closure) | use `IvyArtifactRepository.layout(String)` or `IvyArtifactRepository.patternLayout(Action)`
  org.gradle.api.artifacts.repositories.IvyArtifactRepository.layout(String, Action<? extends RepositoryLayout>) | use `IvyArtifactRepository.layout(String)` or `IvyArtifactRepository.patternLayout(Action)`
  org.gradle.api.DefaultTask.newInputDirectory() | Replaced by `ObjectFactory.directoryProperty()`
  org.gradle.api.DefaultTask.newInputFile() | Replaced by `ObjectFactory.fileProperty()`
  org.gradle.api.DefaultTask.newOutputDirectory() | Replaced by `ObjectFactory.directoryProperty()`
  org.gradle.api.DefaultTask.newOutputFile() | Replaced by `ObjectFactory.fileProperty()`
  org.gradle.api.plugins.PluginCollection.remove(Object) | plugins cannot be removed.
  org.gradle.api.plugins.PluginCollection.removeAll(Collection<?>) | plugins cannot be removed.
  org.gradle.testing.jacoco.tasks.JacocoReportBase.setAdditionalClassDirs(FileCollection) | Use `getAdditionalClassDirs().setFrom(...)`
  org.gradle.testing.jacoco.tasks.JacocoReportBase.setAdditionalSourceDirs(FileCollection) | Use `getAdditionalSourceDirs().setFrom(...)`
  org.gradle.testing.jacoco.plugins.JacocoTaskExtension.setAppend(boolean)
  org.gradle.testing.jacoco.tasks.JacocoReportBase.setClassDirectories(FileCollection) | Use `getClassDirectories().setFrom(...)`
  org.gradle.testing.jacoco.tasks.JacocoReportBase.setExecutionData(FileCollection) | Use `getExecutionData().setFrom(...)`
  org.gradle.StartParameter.setInteractive(boolean) | This flag is no longer used.
  org.gradle.StartParameter.setRecompileScripts(boolean) | This flag is no longer used and simply defaults to 'false'.
  org.gradle.testing.jacoco.tasks.JacocoReportBase.setSourceDirectories(FileCollection) | Use `getSourceDirectories().setFrom(...)`

- Deprecated Constructors
  Constructor | Description
  --- | ---
  org.gradle.api.plugins.osgi.OsgiPluginConvention(ProjectInternal) | Creating instances of this class is deprecated. These should be created by the OSGi plugin only.