Unconventional Android v3

Transcript

1. (Un)conventional Android v3 Richard Cirerol Unconventional Android v3 | Richard Cirerol | @codeprogression
2. Why "(Un)conventional"? 4 Deviate from the traditional Google conventions 4 No Fragments, Loaders, or AsyncTasks 4 Strict about Android code vs Java code 4 Use patterns and conventions Unconventional Android v3 | Richard Cirerol | @codeprogression
3. Library Dependencies Unconventional Android v3 | Richard Cirerol | @codeprogression
4. Dependency Injection 4 Dagger 4 Glassfish annotation 4 Android APT plugin Unconventional Android v3 | Richard Cirerol | @codeprogression
5. Code Generation 4 Lombok 4 Parceler 4 ParcelablePlease 4 AutoValue/AutoParcel Unconventional Android v3 | Richard Cirerol | @codeprogression
6. UI 4 Picasso 4 Butterknife 4 Android Data Binding Unconventional Android v3 | Richard Cirerol | @codeprogression
7. Networking 4 Retrofit2 4 OkHttp3 4 GSON Unconventional Android v3 | Richard Cirerol | @codeprogression
8. Other 4 Timber 4 Joda Time (for Android) 4 Reactive Extensions (RxJava/RxAndroid) Unconventional Android v3 | Richard Cirerol | @codeprogression
9. Case Scenario: The Movie Database(TMDB) Unconventional Android v3 | Richard Cirerol | @codeprogression
10. TMDB 4 Similar to IMDB 4 Free access 4 Open, documented API Unconventional Android v3 | Richard Cirerol | @codeprogression
11. The Conventions AKA Design Patterns Unconventional Android v3 | Richard Cirerol | @codeprogression
12. The Conventions 4 Networking 4 Dependency Injection 4 Model-View-Presenter Unconventional Android v3 | Richard Cirerol | @codeprogression
13. Networking 1. Define types 2. Configure deserialization rules 3. Define web API methods 4. Provide API service bridge 5. Use ReactiveX Unconventional Android v3 | Richard Cirerol | @codeprogression
14. Configuration { "images":{ "base_url": "...", "secure_base_url": "...", ... }, "change_keys":[] } Unconventional Android v3 | Richard Cirerol | @codeprogression
15. public class Configuration { private Images images; private List<String> changeKeys; } Unconventional Android v3 | Richard Cirerol | @codeprogression
16. Lombok Reduce boilerplate code 4 @Getter 4 @Setter 4 @EqualsAndHashCode 4 @ToString 4 @Data Unconventional Android v3 | Richard Cirerol | @codeprogression
17. public class Configuration { @Getter private Images images; private List<String> changeKeys; } Unconventional Android v3 | Richard Cirerol | @codeprogression
18. GSON JSON (De)serialization Unconventional Android v3 | Richard Cirerol | @codeprogression
19. Gson gson = new GsonBuilder().create(); Unconventional Android v3 | Richard Cirerol | @codeprogression
20. GSON Mapping field names // base_url -> baseUrl Gson gson = new GsonBuilder() .setFieldNamingPolicy( FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES) .create(); Unconventional Android v3 | Richard Cirerol | @codeprogression
21. Retrofit 4 Define a API service via interface and annotations 4 HttpClient (OkHttp) 4 Converter (Gson) 4 Optional adapter (RxJava) Unconventional Android v3 | Richard Cirerol | @codeprogression
22. Define the API public interface TmdbApi { @GET("configuration") Observable<Configuration> getConfiguration(); @GET("movie/now_playing") Observable<Movie.Collection> getNowPlaying(); @GET("movie/{id}") Observable<Movie> getMovie(@Path("id") long id); } Unconventional Android v3 | Richard Cirerol | @codeprogression
23. Configure the API TmdbApi apiService(OkHttpClient.Builder client, GsonBuilder gson) { client.addInterceptor(getApiKeyInterceptor()); Retrofit retrofit = new Retrofit.Builder() .baseUrl("https://api.themoviedb.org/3/") .client(client.build()) .addConverterFactory(GsonConverterFactory.create(gson.create())) .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) .build(); return retrofit.create(TmdbApi.class); } Unconventional Android v3 | Richard Cirerol | @codeprogression
24. Add api_key query parameter to every call via OkHttp interceptor private Interceptor getApiKeyInterceptor() { return new Interceptor() { @Override public Response intercept(Chain chain) throws IOException { Request request = chain.request(); HttpUrl url = request.url().newBuilder() .addQueryParameter("api_key", BuildConfig.TMDB_API_KEY).build(); request = request.newBuilder().url(url).build(); return chain.proceed(request); } }; } Unconventional Android v3 | Richard Cirerol | @codeprogression
25. Provide an API service bridge 4 Hides naked API definition from consumers 4 Allows for further customization 4 May look similar to the Retrofit interface, but... 4 Service/API interfaces can vary independently Unconventional Android v3 | Richard Cirerol | @codeprogression
26. Provide an API service bridge private TmdbApi api; public Observable<Movie.Collection> getMovies() { return api.getMovies() .subscribeOn(Schedulers.io()); } Unconventional Android v3 | Richard Cirerol | @codeprogression
27. Show me teh codez! Unconventional Android v3 | Richard Cirerol | @codeprogression
28. The Conventions √ Networking - Dependency Injection - Model-View-Presenter Unconventional Android v3 | Richard Cirerol | @codeprogression
29. Dagger 2.x 4 Dependency injection without reflection 4 Define and construct dependencies 4 Inject dependencies 4 Keep dependency consumers ignorant. Unconventional Android v3 | Richard Cirerol | @codeprogression
30. Dagger 4 @Inject 4 @Scope 4 @Qualifier / @Named 4 @Module / @Provides 4 @Component / @Subcomponent Unconventional Android v3 | Richard Cirerol | @codeprogression
31. @Inject 4 Denotes field to be injected 4 Denotes constructor with parameters to be injected Unconventional Android v3 | Richard Cirerol | @codeprogression
32. @Inject TmdbService service; @Inject public TmdbService(TmdbApi api) { this.api = api; } Unconventional Android v3 | Richard Cirerol | @codeprogression
33. @Scope annotations 4 Defines the lifetime of the dependency 4 @Singleton (Application singleton) 4 @PerActivity (Activity singleton) 4 No-scope == new type per injection Unconventional Android v3 | Richard Cirerol | @codeprogression
34. @Singleton public class TmdbService{ private final TmdbApi api; @Inject public TmdbService(TmdbApi api) { this.api = api; } } Unconventional Android v3 | Richard Cirerol | @codeprogression
35. @Qualifier annotations 4 Distinguishes between similar dependencies Unconventional Android v3 | Richard Cirerol | @codeprogression
36. @Named("GSON_SNAKE_CASE") GsonBuilder gson; @SnakeCase GsonBuilder gson; @CamelCase GsonBuilder gson; Unconventional Android v3 | Richard Cirerol | @codeprogression
37. @Module annotations 4 Denotes a class with @Provides methods. Unconventional Android v3 | Richard Cirerol | @codeprogression
38. @Module public class ApplicationModule{ // Define constructed dependencies } Unconventional Android v3 | Richard Cirerol | @codeprogression
39. @Provides annotations 4 Denotes methods that construct dependencies 4 Always in a @Module class 4 Usually accompanied by a @Scope Unconventional Android v3 | Richard Cirerol | @codeprogression
40. @Provides @Singleton GsonBuilder gsonBuilder() { return new GsonBuilder() .setFieldNamingPolicy( FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES); } Unconventional Android v3 | Richard Cirerol | @codeprogression
41. @Component 4 Interface to wire up providers to consumers 4 Defines inject methods 4 Defines exportable dependencies 4 Uses modules and scoped classes 4 Can declare parent components Unconventional Android v3 | Richard Cirerol | @codeprogression
42. @Singleton @Component(modules = { ApplicationModule.class, TmdbApiModule.class }) public interface ApplicationComponent { ... TmdbService service(); void inject(LauncherActivity launcherActivity); } Unconventional Android v3 | Richard Cirerol | @codeprogression
43. @PerActivity @Component(dependencies = ApplicationComponent.class, includes = { ActivityModule.class }) public interface MainActivityComponent { void inject(MoviesView moviesView); void inject(MovieItemView movieItemView); } Unconventional Android v3 | Richard Cirerol | @codeprogression
44. What does Dagger do with all this? 4 Writes code! Unconventional Android v3 | Richard Cirerol | @codeprogression
45. Show me teh codez! Unconventional Android v3 | Richard Cirerol | @codeprogression
46. The Conventions √ Networking √ Dependency Injection - Model-View-Presenter Unconventional Android v3 | Richard Cirerol | @codeprogression
47. Model-View-Presenter 4 Defines distinct responsibilities 4 View notifies the presenter of events 4 Presenter delegates work to a service (the model) 4 Presenter updates the view with results from the model Unconventional Android v3 | Richard Cirerol | @codeprogression
48. Model-View-Presenter 4 Passive view pattern 4 Binding pattern Unconventional Android v3 | Richard Cirerol | @codeprogression
49. MVP - Passive View Updating the view: - Define a view interface - Implement the interface in your custom view - Instrument the view from the presenter Unconventional Android v3 | Richard Cirerol | @codeprogression
50. MVP - Passive View Conventions: - Inject the presenter - On load, attach the view (interface) to the presenter - On unload, detach the view from the presenter - While attached, delegate work and update the view Unconventional Android v3 | Richard Cirerol | @codeprogression
51. Show me teh codez! Unconventional Android v3 | Richard Cirerol | @codeprogression
52. MVP - Android Data Binding Updating the view: - Define a view model - Use view model variables in your layout markup - Instrument the view model from the presenter Unconventional Android v3 | Richard Cirerol | @codeprogression
53. Configure Android Data Binding 4 Enable in gradle 4 Wrap view in <layout/> 4 Add <data/> and <variable/> elements 4 Bind variables Unconventional Android v3 | Richard Cirerol | @codeprogression
54. MVP - Android Data Binding Conventions: - Inject the presenter - Create the view model object - On load, attach the view model to the presenter - On unload, detach the view model from the presenter - While attached, delegate work and update the view model Unconventional Android v3 | Richard Cirerol | @codeprogression
55. Android Data Binding 4 Define your own binding adapters (custom attributes) 4 Use conditional logic in the layout Unconventional Android v3 | Richard Cirerol | @codeprogression
56. Show me teh codez! Unconventional Android v3 | Richard Cirerol | @codeprogression
57. Android Fundamentals: Data Binding Update coming soon! Unconventional Android v3 | Richard Cirerol | @codeprogression
58. Thanks! Richard Cirerol @codeprogression http://codeprogression.com Come back for RxAndroid after lunch! Unconventional Android v3 | Richard Cirerol | @codeprogression