Dagger 2

A fast dependency injector for Android and Java.

For more information please see the website.

About Google's Fork

This project represents Google's fork of Square's Dagger. Google's Dagger fork is intended to vary from Square's project only where features are needed to deviate from Square's feature-set. Google's Dagger should be a drop-in compatible alternative to Square's Dagger, and many features in this fork will, if successful, be merged into the upstream project.

Efforts are made to also keep Google's fork as close in structure to Square's as possible, to facilitate merging and compatibility. Google/dagger will release shortly after Square's releases.

Differences with square/dagger

Injectable types with inheritance hierarchies are scanned at compile time and adapters are generated for their parent types statically. This differs from square/dagger which always falls back to reflection for the parent types
- Pro: Reflection can be entirely avoided in an application.
- Con: Changes to parent types to add or remove @Inject members require that this class' adapter be regenerated
- Con: Extra code is generated for each concrete sub-type which generates its own copy of the parent adapter (since we don't rely on the parent type having had InjectAdapterProcessor run over it)

Installation

You will need to include the dagger-${dagger.version}.jar in your application's runtime. In order to activate code generation you will need to include dagger-compiler-${dagger.version}.jar in your build at compile time.

In a Maven project, one would include the runtime in the dependencies section of your pom.xml (replacing ${dagger.version} with the appropriate current release), and the dagger-compiler artifact as an "optional" or "provided" dependency:

<dependencies>
  <dependency>
    <groupId>com.google.dagger</groupId>
    <artifactId>dagger</artifactId>
    <version>${dagger.version}</version>
  </dependency>
  <dependency>
    <groupId>com.google.dagger</groupId>
    <artifactId>dagger-compiler</artifactId>
    <version>${dagger.version}</version>
    <optional>true</optional>
  </dependency>
</dependencies>

Release Version: N/A
Pre-Release Version: N/A
Snapshot Version: 2.0-SNAPSHOT

Download

Upon release, downloadable .jars will appear via search on Maven Central. You'll need Dagger, dagger-compiler and javax.inject.

Pre-release directly downloaddable jars of the snapshots are available for dagger and dagger-compiler from sonatype's snapshot repository, and are built on a clean build at head.

License