= image:http://androidtransfuse.org/images/icon.png[Transfuse] Transfuse
image:https://badges.gitter.im/johncarl81/transfuse.svg[link="https://gitter.im/johncarl81/transfuse?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"]
image:https://travis-ci.org/johncarl81/transfuse.png?branch=master["Build Status", link="https://travis-ci.org/johncarl81/transfuse"]
image:https://maven-badges.herokuapp.com/maven-central/org.androidtransfuse/transfuse-api/badge.svg["Maven Central", link="https://maven-badges.herokuapp.com/maven-central/org.androidtransfuse/transfuse-api"]
Transfuse is a Java Dependency Injection (DI) and integration library geared specifically for the Google Android API.
There are several key features that make Transfuse a great framework to use with Android:
All of these features help eliminate boilerplate plumbing code and make Android applications much easier to write.
=== Example
Using Transfuse, an Android Activity looks like the following:
[source,java]
@Activity(label = "@string/app_name")
@Layout(R.layout.main)
public class HelloTransfuse {
@Inject @View(R.id.textview)
TextView textView;
@Inject @Resource(R.string.hello)
String helloText;
@OnCreate
public void hello() {
textView.setText(helloText);
}
}
<1> Now, Activities no longer extend the android.app.Activity class.
<2> The Android Activity lifecycle is handled via lightweight events.
Any component within the injection graph may define event methods to be called during those phases of the lifecycle.
<3> All specialty injections, such as injecting View elements, are designated with qualifier injections (@View, @Resource, etc.).
<4> Activity Manifest metadata, such as the label, are now defined on the class level instead of the AndroidManifest.xml file.
This puts all the relevant information regarding the Activity in one place.
Transfuse handles the job of registering the Activity and all the associated metadata in the AndroidManifest.xml file.
Interested? Check out http://androidtransfuse.org/[the website] for details.
=== Download
You may download Transfuse as a Maven dependency:
[source,xml]
--
org.androidtransfuse
transfuse
${transfuse.version}
provided
org.androidtransfuse
transfuse-api
${transfuse.version}
--
or Gradle:
[source,groovy]
--
apt "org.androidtransfuse:transfuse:${transfuseVersion}"
compile "org.androidtransfuse:transfuse-api:${transfuseVersion}"
--
Or from http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.androidtransfuse%22[Maven Central].
== License
----
Copyright 2011-2015 John Ericksen
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.
----