##IntentBuilder IntentBuilder is a type safe way of creating intents and populating them with extras. Use them with your Activities, Services, Broadcastreceivers and other components.
##Installation
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'
}
}
apply plugin: 'com.neenbedankt.android-apt' dependencies {
compile 'be.trikke:intentbuilder-api:1.1.4'
apt 'be.trikke:intentbuilder-compiler:1.1.4'
}
Version History
- v1.0 Initial release
- v1.1 Added support for Broadcastreceivers. Changed the usage of
@Nullableand created an extra annotation@ExtraOptionalto use with optional values.
##Usage Annotate your activities and services with an @BuildIntent annotation so that they are picked up by the library. For every class with an @BuildIntent annotation a class named <ComponentName>Intent will be generated. If your Component takes in parameters via extras in the intent you can now mark field with the @Extra annotation and they can be injected with the static inject method on the generated intent builder class. Extras can be marked as optional with the @ExtraOptional annotation.
Sample activity using IntentBuilder:
@BuildIntent public class DetailActivity extends AppCompatActivity {
@Extra String requiredString;
@Extra boolean requiredBoolean;
@ExtraOptional String optionalString;
@ExtraOptional int optionalInteger;
@ExtraOptional("coolName") String optionalStringDiffName;
@ExtraOptional boolean optionalBoolean;
@Override public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
DetailActivityIntent.inject(getIntent(), this);
setContentView(R.layout.activity_detail);
// use extras
}
}
##Launching
Use the builder to create the Intent.
Intent i = new DetailActivityIntent("Required String", true)
.optionalString("Optional String")
.optionalInteger(102)
.build(MainActivity.this);
startActivity(i);
Or quickly build an intent with the provided Flow shortcut class.
Flow.gotoDetailActivity("i'm a required String", true)
.optionalString("i'm just optional")
.coolName("Trikke")
.optionalBoolean(true)
.flag(Intent.FLAG_ACTIVITY_CLEAR_TOP)
.launch(MainActivity.this);
Use the provided Flow shortcut class to quickly launch an Intent with it's required extra's (if any).
Flow.launchDetailActivity(MainActivity.this, "required", true)The Flow provides quick methods for getting all your generated Intents, and has launch methods for compatible Components.
Flow.getMyBroadcastReceiver("A required String").action(MY_INTENT_FILTER).send(MainActivity.this);
Flow.startMyService(MainActivity.this, "Required String");
##Contributing Please do! Let me know what you think, and PR's are always welcome!
##Thanks Thanks to emilsjolander and robertoestivill for their source and inspiring me to get off my butt and make this.