Navigation. Cicerone

Transcript

1. Let’s take a look at our brother Dmytro Kuiko
2. Agenda - Theoretical part. - Practical part
4. Clean Architecture
5. VIPER V - View I - Interactor P - Presenter E - Entity R - Router
6. What if?? clean aRchitecture
7. Cicerone
8. Cicerone Presenter Router Command Buffer Navigator Fragment Manager/ Context
9. Cicerone - Command - Navigator - Router - Command Buffer
10. Command public Forward(String screenKey, Object transitionData) {...} public Back() {} public BackTo(String screenKey) {...} public Replace(String screenKey, Object transitionData) {...}
11. Command class OpenInBrowser(val url: String) : Command
12. Cicerone - Command - Navigator - Router - Command Buffer
13. Navigator SupportAppNavigator SupportFragmentNavigator AppNavigator FragmentNavigator
14. Navigator public SupportFragmentNavigator(FragmentManager fragmentManager, int containerId) { this.fragmentManager = fragmentManager; this.containerId = containerId; } protected abstract Fragment createFragment(String screenKey, Object data); protected abstract void showSystemMessage(String message); protected abstract void exit();
15. Navigator public SupportAppNavigator(FragmentActivity activity, int containerId) { super(activity.getSupportFragmentManager(), containerId); this.activity = activity; } protected abstract Intent createActivityIntent(Context context, String screenKey, Object data); protected abstract Fragment createFragment(String screenKey, Object data);
16. Cicerone - Command - Navigator - Router - Command Buffer
17. Router public class Router extends BaseRouter { ... public void newRootScreen(String screenKey, Object data) { executeCommands( new BackTo(null), new Replace(screenKey, data) ); } ... }
18. Cicerone - Command - Navigator - Router - Command Buffer
19. Command Buffer class CommandBuffer implements NavigatorHolder { … } public interface NavigatorHolder { void setNavigator(Navigator navigator); void removeNavigator(); }
20. Command Buffer
21. Cicerone @Module class NavigationModule { private val cicerone = Cicerone.create() @Singleton @Provides fun provideNavigatorHolder(): NavigatorHolder = cicerone.navigatorHolder @Singleton @Provides fun provideRouter(): Router = cicerone.router }
22. Activity/Fragment @Inject lateinit var navigatorHolder: NavigatorHolder private val navigator: SupportFragmentNavigator = object : SupportFragmentNavigator( this.supportFragmentManager, R.id.activity_main_container ) { override fun exit() { this@MainActivity.finish() } override fun showSystemMessage(message: String) { … } override fun createFragment(screenKey: String?, data: Any?): Fragment? = when (screenKey) { ScreenKeys.MAIN_SCREEN -> MainFragment() ScreenKeys.BASKET_SCREEN -> BasketFragment() else -> null } }
23. Activity/Fragment override fun onResumeFragments() { ... navigatorHolder.setNavigator(navigator) ... } override fun onPause() { … navigatorHolder.removeNavigator() ... }
24. Presenter/... class MainPresenterImpl @Inject constructor( private val interactor: MainInteractor, private val mapper: MainDomainMapper, private val router: Router, private val schedulersProvider: SchedulersProvider, private val resourceManager: ResourceManager ) : MainPresenter { override fun basketClicked() { router.navigateTo(ScreenKeys.BASKET_SCREEN) }
25. Activity/Fragment @Inject lateinit var navigatorHolder: NavigatorHolder private val navigator: SupportFragmentNavigator = object : SupportFragmentNavigator( this.supportFragmentManager, R.id.activity_main_container ) { override fun exit() { this@MainActivity.finish() } override fun showSystemMessage(message: String) { … } override fun createFragment(screenKey: String?, data: Any?): Fragment? = when (screenKey) { ScreenKeys.MAIN_SCREEN -> MainFragment() ScreenKeys.BASKET_SCREEN -> BasketFragment() else -> null } }
26. Practical part - Passing data between Fragments - Global and local navigation
27. Passing data between fragments
28. Component manager object ComponentManager { private var appComponent: AppComponent? = null private val componentMap: MutableMap <String, BaseComponent<BaseActivity>> = hashMapOf() private val tempComponentMap: MutableMap<String, TempComponent> = hashMapOf() }
29. Fragment class SearchFragment : BaseFragment() { ... override fun injectModule(context: Context) { (ComponentManager.getTempComponent(context, this) as SearchComponent).inject(this) } ... }
30. Fragment class SearchFragment : BaseFragment() { ... override fun onDestroy() { super.onDestroy() searchAdapter.dispose() presenter.disposeRxBinding() if (isRemoving) { presenter.dispose() ComponentManager.releaseTempComponent(this) } } ... }
31. Fragment override fun onActivityCreated(savedInstanceState: Bundle?) { ... presenter.listenEditTextModel(RxTextView.editorActionEvents( fragment_search_edit_text) .map { EditTextBindingModel(it.view().text.toString(), it.actionId()) } ) ... } class EditTextBindingModel(val text: String, val actionId: Int)
32. Presenter override fun listenEditTextModel(observable:Observable<EditTextBindingModel>) { interactor.listenActionDone(observable) .subscribe(navigator::openSearchContent, this::handleError) .addTo(rxBindingCompositeDisposable) }
33. Interactor override fun listenActionDone(observable:Observable<EditTextBindingModel>): Observable<String> = observable.filter { it.actionId == ACTION_DONE } .flatMap { Completable.fromCallable { storeSearch(it.text) } .compose(this::setSchedulers) .andThen(Observable.just(it.text)) }
34. Presenter override fun listenEditTextModel(observable:Observable<EditTextBindingModel>) { interactor.listenActionDone(observable) .subscribe(navigator::openSearchContent, this::handleError) .addTo(rxBindingCompositeDisposable) }
35. Global navigator class NewsMainNavigatorImpl @Inject constructor(private val router: ExtendedRouter) : NewsMainNavigator { ... override fun openSearchContent(textTyped: String) { router.navigateTo(RouterConstants.SEARCH_CHOSEN_SCREEN, ContentChosen( toolbar = ToolbarData.SearchToolbar(title = textTyped), url = SEARCH_URL_PREFIX, query = textTyped ) ) ... }
36. Activity private val appNavigator = object : ExtendedNavigator( activity = this@MainActivity, containerId = R.id.main_activity_fragment_container ) { override fun createFragment(screenKey: String?, data: Any?): Fragment? = when (screenKey) { ... RouterConstants.MAIN_SCREEN -> MainFragment() RouterConstants.SEARCH_CHOSEN_SCREEN -> initTempComponent(SectionChosenFragment(), data) else -> null }
37. Component Manager @ActivityScope @Subcomponent(modules = [MainModule::class]) interface MainComponent : BaseComponent<MainActivity> { … fun sectionChosenBuilder(): SectionChosenComponent.Builder ... }
38. Component Manager @Subcomponent(modules = [SectionChosenModule::class]) interface SectionChosenComponent : TempComponent { @Subcomponent.Builder interface Builder { @BindsInstance fun contentChosenModel(model: ContentChosen): Builder fun build(): SectionChosenComponent } fun inject(fragment: SectionChosenFragment) }
39. Component Manager private val componentMap: MutableMap <String, BaseComponent<BaseActivity>> private val tempComponentMap: MutableMap<String, TempComponent> val nextScreenComponent = activityComponent.sectionChosenBuilder() .contentChosenModel(model) .build()
40. In brief First Screen 1) Perform some logic to receive require Data 2) Create DTO 3) Pass DTO to Component Manager Component Manager 1) Bind DTO with a Component for a next screen 2) Create this Component Second Screen 1) Inject this DTO and use Data
41. Global and Local Navigation
42. Activity Presenter GlobalRouter HomeMainFragment Presenter LocalRouter GlobalRouter HomeFirstFragment Presenter LocalRouter
43. Cicerone https://github.com/terrakok/Cicerone Telegram: Cicerone_Rus Lucia Payo - Android Architecture https://www.youtube.com/watch?v=foaKMruUBXc&t=1133s
44. Thanks for Attention! https://speakerdeck.com/dmytrykuiko/navigation-cicerone
45. Customizing
46. Router class OpenInBrowser(val url: String) : Command class ExtendedRouter : Router() { fun openInBrowser(url: String) { executeCommands(OpenInBrowser(url)) } }
47. Router class OpenInBrowser(val url: String) : Command class ExtendedRouter : Router() { fun openInBrowser(url: String) { executeCommands(OpenInBrowser(url)) } }
48. Navigator abstract class ExtendedNavigator(private val activity: FragmentActivity, containerId: Int) : SupportAppNavigator(activity, containerId) { override fun applyCommand(command: Command) = when (command) { is OpenInBrowser -> createCustomTabsIntent(command.url) .launchUrl(activity, Uri.parse(command.url)) else -> super.applyCommand(command) } protected abstract fun createCustomTabsIntent(url: String): CustomTabsIntent } class OpenInBrowser(val url: String) : Command
49. Cicerone @Module class NavigationModule { private val cicerone = Cicerone.create(ExtendedRouter()) @Singleton @Provides fun provideNavigatorHolder(): NavigatorHolder = cicerone.navigatorHolder @Singleton @Provides fun provideExtendedRouter(): ExtendedRouter = cicerone.router }