Cicerone. How it works and how to use it. MobiusConf 2017

Transcript

1. Cicerone - навигация без боли и слез Константин Цховребов Android Team Leader
2. Ты кто такой? Константин Цховребов Android Team Lead MobileUp Более 6 лет в Android. Работал в ooApps, Phereo, i-Free. С октября 2014 г. – ведущий Android-разработчик в MobileUp. В 2015 году стал победителем конкурса Павла Дурова для Android- разработчиков «Telegram Challenge». Выступал на конференциях AppsConf 2016, DevFest Siberia 2016.
3. Навигация в андроид приложении
4. Навигация в андроид приложении • Переход между экранами
5. Навигация в андроид приложении • Переход между экранами • Экраны сменяются в некотором контейнере
6. Навигация в андроид приложении • Переход между экранами • Экраны сменяются в некотором контейнере • Для совершения перехода нужен Context
7. Mosby (http://hannesdorfmann.com/mosby/) public interface LoginView extends MvpView { public void showLoginForm(); public void showError(); public void showLoading(); public void loginSuccessful(); } public class LoginFragment … implements LoginView { … // Called when login was successful @Override public void loginSuccessful() { getActivity().finish(); } … }
8. Готовые решения Flow (https://github.com/square/flow) Conductor (https://github.com/bluelinelabs/Conductor)
9. Требования к идеальной навигации
10. Требования к идеальной навигации • прямой доступ из презентера
11. Требования к идеальной навигации • прямой доступ из презентера • не завязана на фрагменты
12. Требования к идеальной навигации • прямой доступ из презентера • не завязана на фрагменты • не фреймворк
13. Требования к идеальной навигации • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы
14. Требования к идеальной навигации • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении
15. Требования к идеальной навигации • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов
16. Требования к идеальной навигации • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла!
17. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла!
18. Это реальный проект!
19. Команды переходов
20. Команды переходов Forward(String screenKey, Object transitionData);
21. Команды переходов Forward(String screenKey, Object transitionData); Back();
22. Команды переходов Forward(String screenKey, Object transitionData); Back(); BackTo(String screenKey);
23. Команды переходов Forward(String screenKey, Object transitionData); Back(); BackTo(String screenKey); Replace(String screenKey, Object transitionData);
24. SystemMessage SystemMessage(String message);
25. Navigator public interface Navigator { void applyCommand(Command command); }
26. Navigator public interface Navigator { void applyCommand(Command command); } public class MainActivity extends Activity { private Navigator navigator = new Navigator() { @Override public void applyCommand(Command command) { ... } } }
27. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла!
28. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓
29. public class Presenter { @Inject Navigator navigator; private void next() { navigator.applyCommand(new Forward(“Some screen”)); } }
30. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓
31. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓
34. public class Presenter { @Inject Navigator navigator; private void authError() { navigator.applyCommand(new BackTo(null)); navigator.applyCommand(new Replace("Login screen", null)); navigator.applyCommand(new SystemMessage("Token expired!")); } }
35. Router public class Router extends BaseRouter { void newRootScreenWithMessage(String screenKey, Object data, String message) {...} }
36. Router public class Router extends BaseRouter { void newRootScreenWithMessage(String screenKey, Object data, String message) {...} } public class Presenter { @Inject Router router; private void authError() { router.newRootScreenWithMessage("Login screen", null, "Token expired!"); } }
37. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓
38. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓
39. public class Router extends BaseRouter { private Navigator navigator; public void setNavigator(Navigator navigator) { this.navigator = navigator; } public void removeNavigator() { this.navigator = null; } public void newRootScreenWithMessage(String screenKey, Object data, String message) { if (navigator != null) { navigator.applyCommand(new BackTo(null)); navigator.applyCommand(new Replace("Login screen", null)); navigator.applyCommand(new SystemMessage("Token expired!")); } } }
40. public class MainActivity extends Activity { @Override protected void onResume() { super.onResume(); router.setNavigator(navigator); } @Override protected void onPause() { super.onPause(); router.removeNavigator(); } }
41. Presenter View load()
42. View Presenter load() request()
43. Presenter request() View
44. Presenter request() response() View
45. Presenter Router request() response() navigate() View
46. Presenter RouterImpl Command Queue request() response() navigate() View
47. View Presenter RouterImpl Command Queue request() response() navigate()
48. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓
49. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓ ✓
50. Unit тестирование @Test public void someTest() throws Exception { Router mockRouter = mock(Router.class); Presenter presenter = new Presenter(); presenter.onNextButtonClicked(); verify(mockRouter, times(1)).navigateTo( eq("Some screen"), argument.capture() ); }
51. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓ ✓
52. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓ ✓ ✓
53. Расширение возможностей • в большинстве случаев достаточно добавить метод в Router и реализовать его с помощью Command • реже необходимо создать новую Command
54. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓ ✓ ✓
55. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓ ✓ ✓ ✓
56. //TODO: • прямой доступ из презентера • не завязана на фрагменты • не фреймворк • короткие вызовы • легка в расширении • приспособлена для тестов • не зависит от жизненного цикла! ✓ ✓ ✓ ✓ ✓ ✓ ✓
57. Cicerone Чичероне - (устар.) гид для иностранцев https://mobileupllc.github.io/ dependencies { //Cicerone compile 'ru.terrakok.cicerone:cicerone:1.2.1' }
59. Для кого мы ее создали?
60. Для кого мы ее создали? Для себя :)
61. Для кого мы ее создали? Почему она может пригодиться вам? Для себя :)
62. Для кого мы ее создали? • В приложении нелинейная навигация Почему она может пригодиться вам? Для себя :)
63. Для кого мы ее создали? • В приложении нелинейная навигация • Отделение логики от отображения Почему она может пригодиться вам? Для себя :)
64. Для кого мы ее создали? • В приложении нелинейная навигация • Отделение логики от отображения • Сохранение вызовов навигации после возвращения к приложению Почему она может пригодиться вам? Для себя :)
65. Возможности Cicerone public class Router extends BaseRouter { void navigateTo(String screenKey, Object data); void newScreenChain(String screenKey, Object data); void newRootScreen(String screenKey, Object data); void replaceScreen(String screenKey, Object data); void backTo(String screenKey); void exit(); void finishChain(); void exitWithMessage(String message); void showSystemMessage(String message); } public abstract class FragmentNavigator implements Navigator {} public abstract class AppNavigator implements Navigator {}
66. Практика или Чичероне в реальной жизни Я понятия не имею кто это, но именно такая у меня ассоциация со словом чичероне :)
67. Параллельная навигация (аля Instagram)
71. public class CiceroneHolder { private HashMap<String, Cicerone<Router>> containers; public CiceroneHolder() { containers = new HashMap<>(); } public Cicerone<Router> getCicerone(String containerTag) { if (!containers.containsKey(containerTag)) { containers.put(containerTag, Cicerone.create()); } return containers.get(containerTag); } }
72. Сквозное “левое” меню
74. Навигация по deeplink-ам
76. IMHO: Activity & Fragments
77. IMHO: Activity & Fragments • Fragment’ы - легкая адаптация под планшеты
78. IMHO: Activity & Fragments • Fragment’ы - легкая адаптация под планшеты • Activity - долгий старт на слабых устройствах
79. IMHO: Activity & Fragments • Fragment’ы - легкая адаптация под планшеты • Activity - долгий старт на слабых устройствах • Activity - ограничение в возможностях анимации
80. IMHO: Activity & Fragments • Fragment’ы - легкая адаптация под планшеты • Activity - долгий старт на слабых устройствах • Activity - ограничение в возможностях анимации • От Fragment’ов полностью не отказаться (табы)
81. IMHO: Activity & Fragments • Fragment’ы - легкая адаптация под планшеты • Activity - долгий старт на слабых устройствах • Activity - ограничение в возможностях анимации • От Fragment’ов полностью не отказаться (табы) • Мы смогли полюбить Fragment’ы
82. IMHO: Activity & Fragments • Fragment’ы - легкая адаптация под планшеты • Activity - долгий старт на слабых устройствах • Activity - ограничение в возможностях анимации • От Fragment’ов полностью не отказаться (табы) • Мы смогли полюбить Fragment’ы • Activity - “приложение внутри приложения”
83. Смешанная навигация. Ч. 1: Activity
84. Смешанная навигация. Ч. 1: Activity • Navigator управляет контейнером
85. Смешанная навигация. Ч. 1: Activity • Navigator управляет контейнером • Navigator живет вместе с контейнером
86. Смешанная навигация. Ч. 1: Activity
87. Смешанная навигация. Ч. 2
88. Смешанная навигация. Ч. 2 private Navigator navigator = new AppNavigator(this, R.id.mainContainer) { @Override protected Intent createActivityIntent(String screenKey, Object data) { switch (screenKey) { case "F_4": return new Intent(getBaseContext(), LoginActivity.class); } return null; } @Override protected Fragment createFragment(String screenKey, Object data) { switch (screenKey) { case "Some screen": return new SomeFragment(); } return null; } };
89. Диалоги и навигация
90. Спасибо за внимание! Вопросы? Email: terrakok@mobileup.ru Telegram: @terrakok Telegram Chat: @Cicerone_RUS @Cicerone_ENG https://mobileupllc.github.io/