Transfuse

Overview of the Transfuse framework for Google Android.

Transcript

1. Transfuse androidtransfuse.org
2. +John Ericksen @johncarl81 github.com/johncarl81 johncarl81@gmail.com
4. What is Transfuse? POJO Components JSR330 Implementation Manifest Management Event System Aspect Oriented Programming
5. What is Transfuse? Reduce Boilerplate... In a performance sensitive way.
6. "I'm generally unwilling to sacrifice user experience for developer experience"
7. Typical Android public class BigButtonActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); Button button = (Button)findViewById(R.id.Button01); button.setOnLongClickListener( new LongClickLogger(button)); } }
8. Context Base Class • Lifecycle Events • Resource Getters • Configuration • Managers • Heavily Associated with View (Activity) • Etc.
10. @Activity public class Example { } POJO Components
11. @Activity(label = "Transfuse Example") @Layout(R.id.example_layout) @IntentFilter({ @Intent(type=IntentType.ACTION, name=android.app.Intent.ACTION_MAIN @Intent(type=IntentType.CATEGORY, name=android.app.Intent.CATEGORY_LAUNCHER)}) public class Example { } Component Metadata
12. Manifest Management <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.android.apis"> <uses-permission android:name="android.permission.INTERNET" /> <application android:name="ApiDemosApplication"> <activity android:name="ApiDemos"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
13. I forgot to add ___ to the AndroidManifest.xml Manifest Management
14. Previous Manifest Next Manifest @Activity Application Model Android Manifest @Service @Activity @Activity
15. @OnCreate public void logCreated() { Log.i("Created", "Hello World"); } *Any Lifecycle Event is available in corresponding injected objects (event different scopes) Lifecycle Events
16. Lifecycle Events @Activity(label = "Transfuse Example") @Layout(R.id.example_layout) public class Example { @OnCreate public void logCreated() { Log.i("Created", "Hello World"); } }
17. @Inject @Singleton Provider<T> @Activity JSR 330
18. @Inject @Activity(label = "Transfuse Example") @Layout(R.id.example_layout) public class Example { @Inject private Dependency1 d1; @Inject public Example(Dependency2 d2){...} @Inject public void setDependency(Dependency3 d3){...} }
19. @Inject Public Protected Package Private Private Constructor Method Field No Performance Hit Requires Reflection Recommended
20. Specialty Injections @Inject @View(R.id.button1) Button button; @Inject LocationManager locationManager; @Inject Activity activity; @Inject @Preference(value="pref_dialog", defaultValue="test") String dialog; @Inject @Resource(R.string.app_name) String appName;
21. eventManager.trigger(new EventOne(“value”)); public void observe(@Observes EventOne one){ ... } @Observes
22. @Activity Generated Activity OnPause() getViewById() onClick() .trigger(new Event()) @Observes Event e
23. "Startup of my application took 7 seconds" Startup is Critical
24. Technique Compile time Runtime Analysis / Config
25. Technique JSR 269 Pluggable Annotation Processing API Compiler Extensions
26. More Features
27. public class MyParcelable implements Parcelable { private int mData; public int describeContents() { return 0; } public void writeToParcel(Parcel out, int flags) { out.writeInt(mData); } public static final Parcelable.Creator<MyParcelable> CREATOR = new Parcelable.Creator<MyParcelable>() { public MyParcelable createFromParcel(Parcel in) { return new MyParcelable(in); } public MyParcelable[] newArray(int size) { return new MyParcelable[size]; } }; private MyParcelable(Parcel in) { mData = in.readInt(); } } Parcelable
28. @Parcel public class ParcelExample { private String name; private double value; public String getName() { return name; } public void setName(String name) { this.name = name; } public double getValue() { return value; } ... @Parcel
29. @Activity public class ExtraInjection { @Inject @Extra(EXTRA_ONE) private String extraOne; @Inject @Extra(value = EXTRA_PARCELABLE, optional=true) private ParcelExample parcelExample; } intentFactory.start( new ExtraInjectionActivityStrategy(TEST_VALUE)); Extras and IntentFactory
30. @Inject @RegisterListener(value = R.id.button1) RegisterOnClickListener listener1; @RegisterListener(value = R.id.button5) View.OnClickListener listener5 = new View.OnClickListener() { ... }; Registering Listeners
31. @AOPInterceptor public void interceptMe() { } public class InjectedInterceptor implements MethodInterceptor { @Override public Object invoke(MethodInvocation invocation) { ... Object retValue = invocation.proceed(); ... return retValue; } } Aspect Oriented Programming
32. @TransfuseModule @Bind(type = LoopThree.class, to = LoopThreeImpl.class) @BindProvider(type = Random.class, provider = RandomProvider.class) @BindInterceptor(annotation = AOPInterceptor.class, interceptor = InterceptorRecorder.class) public class IntegrationModule { @Provides public GenericType<MyType> build(ConcreteType concreteType){ return concreteType; } } Configuration DSL
33. @Service public class Example { @OnStart public void onStart() { ... } } @Service
34. @BroadcastReceiver public class Example { @OnReceive public void onStart() { ... } } @BroadcastReceiver
35. @Application public class Example { @OnCreate public void onStart() { ... } } @Application
36. @Fragment @Layout(R.layout.details) public class DetailFragment { @Inject @View(R.id.detailsText) private TextView view; @OnActivityCreated public void onActivityCreated() { Log.i("fragments", "onActivityCreated"); } public void setText(@Observes TextChange textChange) { view.setText(textChange.getValue()); } } @Fragment
37. @Activity public class ManagedActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.display); TextView textView = (TextView) findViewById(R.id.displayText); textView.setText(MANAGED_TEXT); } } Legacy Friendly
38. What About Performance?
39. 10ms - 100ms Cold Start Performance
40. Testability? Android Issues
41. Testability? package android.app; public class Activity { public Activity() { throw new RuntimeException("Stub!"); } public static long getInstanceCount() { throw new RuntimeException("Stub!"); } public android.content.Intent getIntent() { throw new RuntimeException("Stub!"); } public void setIntent(android.content.Intent newIntent) { throw new RuntimeException("Stub!"); } public final android.app.Application getApplication() { throw new RuntimeException("Stub!"); } public final boolean isChild() { throw new RuntimeException("Stub!"); } public final android.app.Activity getParent() { throw new RuntimeException("Stub!"); } public android.view.WindowManager getWindowManager() { throw new RuntimeException("Stub!"); } public android.view.Window getWindow() { throw new RuntimeException("Stub!"); } public android.view.View getCurrentFocus() { throw new RuntimeException("Stub!"); } public int getWallpaperDesiredMinimumWidth() { throw new RuntimeException("Stub!"); } public int getWallpaperDesiredMinimumHeight() { throw new RuntimeException("Stub!"); } throw new RuntimeException("Stub!"); Android Issues
42. POJO Components Transfuse Components are Easy to Test @RunWith(RobolectricTestRunner.class) public class HelloAndroidTest { private static final String TEST_TEXT = "hello"; private HelloAndroid helloAndroid; private TextView textView; @Before public void setup(){ textView = new TextView(new Activity()); helloAndroid = new HelloAndroid(textView, TEST_TEXT); } @Test public void test(){ helloAndroid.hello(); assertEquals(TEST_TEXT, textView.getText()); } }
43. Custom Scopes Assisted Injection (@Factory) Binding Annotations And more... Upcoming Features
44. Getting Transfuse <dependency> <groupId>org.androidtransfuse</groupId> <artifactId>transfuse</artifactId> <version>0.1.2</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.androidtransfuse</groupId> <artifactId>transfuse-api</artifactId> <version>0.1.2</version> </dependency>