Dagger 2.23.1

In addition to the 2.23 release notes, this release fixes support for gradle incremental annotation processing (a91d962)

Dagger 2.23

• Validation/strictness
  • Generated components are no longer public unless the component type is public (298dea8)
  • @BindsInstance annotations are now more strictly validated (d3ed46d)
• Build performance
  • Generated code is no longer formatted by default. Use -Adagger.formatGeneratedSource=enabled to turn it on. (fcd069c)
  • General build performance improvements (7e374b5)
• Android
  • Added dagger.android.HasAndroidInjector, which will soon replace the Has*Injector interfaces. This one interfaces coalesces the others and should be functionally equivalent. (8f01526)
• Full Binding Graph Validation
  • Rename -Adagger.moduleBindingValidation to -Adagger.fullBindingGraphValidation. The old name continues to work as an alias. (add5a74)
  • Do full binding graph validation for components and subcomponents, not just modules. (15d20f8)
• Bug Fixes
  • Fixed an issue where @BindsInstance on a Builder setter method's parameter caused a failure in codegen if the parameter had a different name than the method itself (#1464). (8051d28)

Dagger 2.22.1

In addition to the 2.22 release notes, this release fixes an issue where @BindsInstance on a @Component.Builder setter method's parameter caused a failure in code generation if the parameter had a different name than the method itself (#1464). (8051d28)

Dagger 2.22

NOTE: A bug in the Dagger compiler was introduced in this release. A fix is available in 2.22.1

• Add the ability to create @Component.Factory types for components instead of @Component.Builders. An @Component.Factory is stateless and has a single method, returning the creator type, that takes parameters for anything that a Builder could have setters for. (d340886)
• @BindsInstance can now be applied to the parameter of a setter method on a builder rather than to the setter method itself, for consistency with factory methods. (60dc2a6)
• When a single instance of a component builder with no setter for a particular module that Dagger can instantiate is used to instantiate multiple component instances, provide a new instance of that module to each component rather than caching and reusing a single instance of the module for each component. (fa714e9)
• Public modules are now allowed to include non-public modules when those included modules do not require an instance: that is, they only have abstract and/or static binding methods. (bfdecad)
• Fix @BindsOptionalOf methods to require that they have a different name than any other binding method in the module; this was already true for all other types of binding methods (@Provides, @Binds etc.) but @BindsOptionalOf wasn't being included. (1ea36ec)
• Report an error for scopes on @Multibinds methods. This was never supported, but the scope was previously ignored. (9582bc3)
• Limit the number of requests and entry points reported explicitly for errors. (1d5d829)
• SPI: Renamed BindingKind.SUBCOMPONENT_BUILDER to SUBCOMPONENT_CREATOR to reflect the fact that it can be a builder or a factory, and renamed the edge type to SubcomponentCreatorBindingEdge. (65e2209)
• Build performance improvements:
  • 82f10d4
  • c7b0f12
  • 6cb9f6b
  • c74e5dc
  • 9b4a094
  • 6caef06
  • 39456a4
  • 9cf7cec

Dagger 2.21

• Build performance improvements (174a7a9)
  • Separately, there may be an increase in build times for opensource users using javac9 or javac10. Neither javac8 or javac11 should be affected. (96fcce8)
• New validation:
  • Installing a module with scoped bindings that an ancestor component has also installed is now an error. (4695ff5)
  • A warning is now reported if an explicit binding conflicts with an @Inject binding in an ancestor component. This was never intended to be supported but never checked. Adds a flag to control whether that is a warning or an error. (7f5500f)
  • Installing a @ProducerModule in a @Subcomponent that is already installed in a parent (or earlier ancestor) component is now an error. It is also an error to repeat a @Module that has a binding in @ProductionScope. (68b2153)
• SPI
  • New method: ComponentNode.isSubcomponent() (b6b9dca)
• Producers
  • Deprecated dagger.producers.internal.Producers.immediateProducer() and dagger.producers.internal.Producers.immediateFailedProducer() in favor of newly added methods with the same names in dagger.producers.Producers (a4914c6) (added in 50d7010)
• Properly generate components when qualifiers are generated (ab9cdbc)
• Dagger itself now uses more Dagger (97fce1e)

Dagger 2.20

• Peformance improvements in annotation processing (8012ab5)
• Report duplicate bindings only once, not once per request. (623461f)
• Make sure all processing steps defer elements properly if they have missing types. (3b0fcc8)
• Make @ProductionComponent have runtime retention so tools can interpret it like all of the other component annotations (fff65e3)
• 325b516:
  • Add module-level validation. When -Adagger.moduleBindingValidation=ERROR or =WARNING is set, then each module is processed as a kind of component (without generating any code) in order to validate the bindings installed by it and all included modules. Any binding graph errors, such as duplicate bindngs (but not including missing bindings), will be reported as errors or warnings depending on the option.
• Report map multibinding contribution errors once regardless of whether the map is requested as Map<K, V>, Map<K, Provider<V>>, or Map<K, Producer<V>>. (350368e)
• c7e7c4f:
  • Fixes two bugs related to @ProductionScope bindings:
    • Where modules with @ProductionScope bindings are installed in multiple components in the same component ancestry, the binding is now resolved only once and only in the rootmost component.
    • When @Inject bindings with @ProductionScope are referenced in a binding graph, the binding is now resolved in the rootmost @ProductionScope component.
• 221f000:
  • dagger.android code can no longer use the AndroidInjector.Factory<? extends Activity> format to bind injector factories. See https://google.github.io/dagger/android and the 2.19 release notes for information on how to migrate.
  • Adds an ErrorProne refactoring for migrating from AndroidSupportInjectionModule (which now is functionless) to AndroidInjectionModule. See these docs for how to apply the refactoring to your codebase if you're on dagger-compiler-2.20.
• Removed dagger.releaseablereferences (a72c342)
• Removed the -Adagger.floatingBindsMethods flag added in 2.17 (https://github.com/google/dagger/wiki/Dagger-2.17-@Binds-bugs) (bc8dd5b)

Dagger 2.19

• dagger.android has a new format for binding AndroidInjector.Factorys:
  • Instead of returning AndroidInjector.Factory<? extends Activity> (or Service, Fragment, etc), return just AndroidInjector.Factory>
  • Instead of using @ActivityKey (or @ServiceKey, @FragmentKey, etc), use @ClassKey. The dagger.android map keys (with the exception of @AndroidInjectionKey are now deprecated
  • If you use @ContributesAndroidInjector, there's nothing to do. We have updated the output to match the new format
  • We have provided an ErrorProne refactoring for migrating to the new format of binding AndroidInjector.Factorys with dagger.android. See these docs for how to apply the refactoring to your codebase if you're on dagger-compiler-2.19. (02dc4a7)
  • In the next release (2.20), we will remove the old format. This will allow us to support AndroidX packages better.
  • For the complete docs, visit https://google.github.io/dagger/android
• Avoid some thrown errors during Dagger compilation for invalid modules. (4df5adf)
• Some formatting fixes even when the formatter is turned off

Dagger 2.18

• Producers:
  • Added @CancellationPolicy annotation, which can be used to make a production component or subcomponent allow cancellation of its subcomponent(s) to propagate up to it and cancel its nodes as well. (f5c04a5)
  • Producer cancellation is now deterministic; cancelling an entry point of a production component will now ensure that it cancels all running tasks for that component and prevents any further tasks for that component from starting. For components with more than one entry point, this does mean that cancelling one entry point will cancel all entry points for the component. For production subcomponents, cancellation of a subcomponent entry point will not propagate cancellation to tasks owned by an ancestor component. (ea48dfd)
• Better Errors:
  • Change constructor bindings and dependency requests from void package.Class.<init>(params) to package.Class(params), which looks more like how Java users think of constructors. (d31943c)
  • Report errors on members injection component methods and MembersInjector requests that have qualifiers. (3be3073)
  • Report erroneous bindings once for all their incoming dependency requests, instead of once for each incoming dependency request. If a binding is owned in more than one component, it will still be reported once for each component that owns it. (beefa94)
  • Report errors when members-injecting primitives and arrays in component methods as well as unused bindings. (d6a0db3)
  • Report binding graph errors once at the root component, not once per entry point from which the error is reachable. Include the dependency trace from one entry point only, and list the other entry points from which the error is reachable. (46f315f)
  • Report errors for dependency requests with multiple qualifiers in @Provides and @Produces methods and component entry points instead of throwing IllegalArgumentException. (da2e1f0)
• dagger.android:
  • Adds a support version of DaggerDialogFragment (47be5db)
• Build perf:
  • Add an option to disable formatting of generated code: -Adagger.formatGeneratedSource=disabled (6814a21)
  • Add support for gradle's incremental annotation processing. This can be enabled by passing -Adagger.gradle.incremental to javac (cd83b30)
  • Originating elements are now reported to the Filer (baf2357)
  • Improvements in processing time (b0786a5)
• Bug fixes:
  • Fixes bug in fast init (b/116268009). (be9493d)
  • Report an error (instead of throwing IAE) if a component builder method has a primitive parameter and is not annotated with @BindsInstance. (5c69aab)
  • Avoid IncompatibleClassChangeError in DiagnosticReporterImpl when guava-android is on the processor path. (efb042d)

Dagger 2.17

• 7eab363:
  • Fixed a bug where parent components sometimes had bindings for child subcomponents if a parent module had a @Binds @ChildScope method.
  • Fixed a bug where a @Binds method in a parent but used only from a child, whose dependency is missing in the parent but present in the child, used to result in a valid graph. Now an error is correctly added.
  • If you start seeing missing binding errors in this release, check out this wiki page for information on how to debug the issues.
• Fix bug when reporting cycles if some components have no entry points that depend on the cycle. (c55bec3)
• 3a08964:
  • If you use dagger.android and you aren't already installing AndroidInjectionModule (or AndroidSupportInjectionModule), you should do so, otherwise you are likely to get a missing binding error from Dagger when you upgrade.
  • Adds an option to use string keys for dagger.android and allow the keys to be obfuscated.
    • Note that if you use a bytecode shrinker/optimizer, this is only viable if you use a version of R8 that can read generated proguard rules (or if you extract the contents of the generated rule and include it in your build)
    • You can enable this mode with the flag -Adagger.android.experimentalUseStringKeys.
• If two entry point methods with different keys are inherited from different supertypes of a component type, Dagger will now report an error. (51d049f)
• Renamed experimentalAndroidMode to fastInit. See https://google.github.io/dagger/compiler-options (d55c02d)
• Deprecated dagger.android.DaggerFragment in favor of dagger.android.support.DaggerFragment to match Android P's deprecation of framework fragments. (a1bd0ea)
• Scope annotations have no meaning on @BindsOptionalOf methods. Dagger now reports an error for them. Instead of applying a scope to the @BindsOptionalOf method, apply it to the non-optional binding that satisfies the optional binding. (8852d0b)
• Report an error for binding methods that have more than one scope annotation, instead of throwing an exception. (192d359)
• Fixes a bug where scope annotations in error messages were missing annotation attributes (fc09c71)

Dagger 2.16

• Deprecate dagger.releasablereferences (928b157)
• @Module cycles will no longer crash the processor. (cd70691)
• Change SPI diagnostic reporting to calling methods on a DiagnosticReporter instead of returning ValidationItems. (1f4f6bc)
• Construct inlined multibindings more efficiently if a newer version of Guava is available (84ec3c6)
• Fix a bug where @Binds methods with inaccessible map keys crashed the processor. (ebf0742)
• Fixes dagger-android-processor to handle androidx types