Гладкая навигация с Cicerone

Transcript

1. @akhbulatov Гладкая навигация с Cicerone
2. Навигация в реальном приложении
3. Навигация в реальном приложении * со слов автора библиотеки
4. Архитектура в Android-приложениях: • Паттерн MVC
5. Архитектура в Android-приложениях: • Паттерн MVC (устарел)
6. Архитектура в Android-приложениях: • Паттерн MVC (устарел) • Паттерн MVP
7. Архитектура в Android-приложениях: • Паттерн MVC (устарел) • Паттерн MVP • Паттерн MVVM
8. Архитектура в Android-приложениях: • Паттерн MVC (устарел) • Паттерн MVP • Паттерн MVVM + Clean Architecture (Чистая архитектура)
9. Навигация в MVP
10. Навигация в MVP Навигация - это скорее бизнес-логика
11. Навигация в MVP Навигация - это скорее бизнес-логика Ответственность за переходы возлагается на презентер
12. Навигация в MVP Навигация - это скорее бизнес-логика Ответственность за переходы возлагается на презентер В презентере не должно быть импортов из Android Framework, например, Context
13. Навигация в MVP Навигация - это скорее бизнес-логика Ответственность за переходы возлагается на презентер В презентере не должно быть импортов из Android Framework, например, Context import android.content.Context import android.content.res.Resources class UsersPresenter { ... }
14. Навигация в MVP Навигация - это скорее бизнес-логика Ответственность за переходы возлагается на презентер В презентере не должно быть импортов из Android Framework, например, Context import android.content.Context import android.content.res.Resources class UsersPresenter { ... }
15. Главная проблема, связанная с этим в Андроиде: Для осуществления переходов между Activity и смены Fragment'oв нужен Context
16. Плюсы Cicerone
17. Плюсы Cicerone • Прямой доступ из презентера
18. Плюсы Cicerone • Прямой доступ из презентера • Не завязана на фрагменты (т.е. есть также поддержка переходов между Activity)
19. Плюсы Cicerone • Прямой доступ из презентера • Не завязана на фрагменты (т.е. есть также поддержка переходов между Activity) • Не фреймворк
20. Плюсы Cicerone • Прямой доступ из презентера • Не завязана на фрагменты (т.е. есть также поддержка переходов между Activity) • Не фреймворк • Короткие вызовы
21. Плюсы Cicerone • Прямой доступ из презентера • Не завязана на фрагменты (т.е. есть также поддержка переходов между Activity) • Не фреймворк • Короткие вызовы • Легка в расширении
22. Плюсы Cicerone • Прямой доступ из презентера • Не завязана на фрагменты (т.е. есть также поддержка переходов между Activity) • Не фреймворк • Короткие вызовы • Легка в расширении • Не зависит от жизненного цикла!
23. Структура Cicerone
24. Структура Cicerone На схеме четыре сущности:
25. Структура Cicerone На схеме четыре сущности: Command – простейшая команда перехода, которую выполняет Navigator
26. Структура Cicerone На схеме четыре сущности: Command – простейшая команда перехода, которую выполняет Navigator Navigator – реализация «переключения экранов» внутри контейнера (для фрагментов) и Activity.
27. Структура Cicerone На схеме четыре сущности: Command – простейшая команда перехода, которую выполняет Navigator Navigator – реализация «переключения экранов» внутри контейнера (для фрагментов) и Activity. Router - класс, которому передаем команды для выполнения перехода
28. Структура Cicerone На схеме четыре сущности: Command – простейшая команда перехода, которую выполняет Navigator Navigator – реализация «переключения экранов» внутри контейнера (для фрагментов) и Activity. Router - класс, которому передаем команды для выполнения перехода CommandBuffer – отвечает за сохранность вызванных команд навигации, если нет возможности сразу выполнить переход
29. Команды переходов Forward R обозначен корневой экран приложения
30. Команды переходов Forward Осуществляет переход на новый экран, добавляя его в текущую цепочку экранов R обозначен корневой экран приложения
31. Команды переходов Forward public Forward(Screen screen) { this.screen = screen; } Осуществляет переход на новый экран, добавляя его в текущую цепочку экранов R обозначен корневой экран приложения
32. Команды переходов Back R обозначен корневой экран приложения
33. Команды переходов Back Удаляет последний активный экран из цепочки, и возвращает на предыдущий R обозначен корневой экран приложения
34. Команды переходов Back Удаляет последний активный экран из цепочки, и возвращает на предыдущий R обозначен корневой экран приложения При вызове на корневом экране ожидается выход из приложения
35. Команды переходов BackTo R обозначен корневой экран приложения
36. Команды переходов BackTo Возвращает на любой из экранов в цепочке, достаточно указать его экран (Screen) R обозначен корневой экран приложения
37. Команды переходов BackTo Возвращает на любой из экранов в цепочке, достаточно указать его экран (Screen) R обозначен корневой экран приложения public BackTo(Screen screen) { this.screen = screen; }
38. Команды переходов BackTo Возвращает на любой из экранов в цепочке, достаточно указать его экран (Screen) R обозначен корневой экран приложения При вызове на корневом экране ожидается выход из приложения public BackTo(Screen screen) { this.screen = screen; }
39. Команды переходов Replace R обозначен корневой экран приложения
40. Команды переходов Replace Заменяет активный экран на новый R обозначен корневой экран приложения
41. Команды переходов Replace Заменяет активный экран на новый R обозначен корневой экран приложения public Replace(Screen screen) { this.screen = screen; }
42. Screen
43. Screen public abstract class Screen { protected String screenKey = getClass().getCanonicalName(); public String getScreenKey() { return screenKey; } }
44. Screen public abstract class Screen { protected String screenKey = getClass().getCanonicalName(); public String getScreenKey() { return screenKey; } } public abstract class SupportAppScreen extends Screen { public Fragment getFragment() { return null; } public Intent getActivityIntent(Context context) { return null; } }
45. Screen public abstract class Screen { protected String screenKey = getClass().getCanonicalName(); public String getScreenKey() { return screenKey; } } public abstract class SupportAppScreen extends Screen { public Fragment getFragment() { return null; } public Intent getActivityIntent(Context context) { return null; } } Реализация:
46. Screen public abstract class Screen { protected String screenKey = getClass().getCanonicalName(); public String getScreenKey() { return screenKey; } } public abstract class SupportAppScreen extends Screen { public Fragment getFragment() { return null; } public Intent getActivityIntent(Context context) { return null; } } public class UsersScreen extends SupportAppScreen { public Fragment getFragment() { return new UsersFragment(); } } Реализация:
47. Navigator Команды только описывают переходы
48. Navigator Команды только описывают переходы Как реализовать переключение экранов?
49. Navigator Команды только описывают переходы Как реализовать переключение экранов? - c помощью Navigator
50. Navigator Команды только описывают переходы Как реализовать переключение экранов? - c помощью Navigator public interface Navigator { void applyCommands(Command[] commands); }
51. Navigator Navigator всегда будет там, где находится контейнер для переключаемых экранов
52. Navigator Navigator всегда будет там, где находится контейнер для переключаемых экранов • в Activity для переключения Fragment’ов.
53. Navigator Navigator всегда будет там, где находится контейнер для переключаемых экранов • в Activity для переключения Fragment’ов. • во Fragment’е для переключения вложенных (child) Fragment’ов.
54. Готовая реализация Navigator - SupportAppNavigator public class SupportAppNavigator implements Navigator { .... }
55. Готовая реализация Navigator - SupportAppNavigator public class SupportAppNavigator implements Navigator { public SupportAppNavigator(FragmentActivity activity, int containerId) { this(activity, activity.getSupportFragmentManager(), containerId); } }
56. Готовая реализация Navigator - SupportAppNavigator public class SupportAppNavigator implements Navigator { public SupportAppNavigator(FragmentActivity activity, int containerId) { this(activity, activity.getSupportFragmentManager(), containerId); } public SupportAppNavigator(FragmentActivity activity, FragmentManager fragmentManager, int containerId) { this.activity = activity; this.fragmentManager = fragmentManager; this.containerId = containerId; } }
57. Router public class Router extends BaseRouter { // Переход на новый экран public void navigateTo(Screen screen) { executeCommands(new Forward(screen)); } }
58. Router public class Router extends BaseRouter { // Переход на новый экран public void navigateTo(Screen screen) { executeCommands(new Forward(screen)); } // Очищает все экраны и открывает новый корневой public void newRootScreen(Screen screen) { executeCommands( new BackTo(null), new Replace(screen) ); } }
59. Router public class Router extends BaseRouter { // Переход на новый экран public void navigateTo(Screen screen) { executeCommands(new Forward(screen)); } // Очищает все экраны и открывает новый корневой public void newRootScreen(Screen screen) { executeCommands( new BackTo(null), new Replace(screen) ); } // Замена текущего экрана public void replaceScreen(Screen screen) { executeCommands(new Replace(screen)); } }
60. Router public class Router extends BaseRouter { // Переход на новый экран public void navigateTo(Screen screen) { executeCommands(new Forward(screen)); } // Очищает все экраны и открывает новый корневой public void newRootScreen(Screen screen) { executeCommands( new BackTo(null), new Replace(screen) ); } // Замена текущего экрана public void replaceScreen(Screen screen) { executeCommands(new Replace(screen)); } // Возврат на любой экран в цепочке public void backTo(Screen screen) { executeCommands(new BackTo(screen)); } }
61. Router public class Router extends BaseRouter { ... // Открывает несколько экранов внутри одной транзакции public void newChain(Screen... screens) { ... } }
62. Router public class Router extends BaseRouter { ... // Открывает несколько экранов внутри одной транзакции public void newChain(Screen... screens) { ... } // Очищает стек и открывает несколько экранов внутри 1-й транзакции public void newRootChain(Screen... screens) { ... } }
63. Router public class Router extends BaseRouter { ... // Открывает несколько экранов внутри одной транзакции public void newChain(Screen... screens) { ... } // Очищает стек и открывает несколько экранов внутри 1-й транзакции public void newRootChain(Screen... screens) { ... } // Удаляет все экраны из цепочки и выход (из приложения) public void finishChain() { executeCommands( new BackTo(null), new Back() ); } }
64. Router public class Router extends BaseRouter { ... // Открывает несколько экранов внутри одной транзакции public void newChain(Screen... screens) { ... } // Очищает стек и открывает несколько экранов внутри 1-й транзакции public void newRootChain(Screen... screens) { ... } // Удаляет все экраны из цепочки и выход (из приложения) public void finishChain() { executeCommands( new BackTo(null), new Back() ); } // Возвращает на предыдущий экран в цепочке public void exit() { executeCommands(new Back()); } }
65. CommandBuffer Передает команду навигации к активному навигатору
66. CommandBuffer Передает команду навигации к активному навигатору Или сохраняет в очереди, если навигатор не активен
67. CommandBuffer class CommandBuffer implements NavigatorHolder { private Navigator navigator; private Queue<Command[]> pendingCommands = new LinkedList<>(); @Override public void setNavigator(Navigator navigator) { this.navigator = navigator; ... } @Override public void removeNavigator() { this.navigator = null; } void executeCommands(Command[] commands) { if (navigator != null) { navigator.applyCommands(commands); } else { pendingCommands.add(commands); } } }
68. CommandBuffer class CommandBuffer implements NavigatorHolder { private Navigator navigator; private Queue<Command[]> pendingCommands = new LinkedList<>(); @Override public void setNavigator(Navigator navigator) { this.navigator = navigator; ... } @Override public void removeNavigator() { this.navigator = null; } void executeCommands(Command[] commands) { if (navigator != null) { navigator.applyCommands(commands); } else { pendingCommands.add(commands); } } }
69. CommandBuffer class CommandBuffer implements NavigatorHolder { private Navigator navigator; private Queue<Command[]> pendingCommands = new LinkedList<>(); @Override public void setNavigator(Navigator navigator) { this.navigator = navigator; ... } @Override public void removeNavigator() { this.navigator = null; } void executeCommands(Command[] commands) { if (navigator != null) { navigator.applyCommands(commands); } else { pendingCommands.add(commands); } } }
70. CommandBuffer class CommandBuffer implements NavigatorHolder { private Navigator navigator; private Queue<Command[]> pendingCommands = new LinkedList<>(); @Override public void setNavigator(Navigator navigator) { this.navigator = navigator; ... } @Override public void removeNavigator() { this.navigator = null; } void executeCommands(Command[] commands) { if (navigator != null) { navigator.applyCommands(commands); } else { pendingCommands.add(commands); } } }
71. CommandBuffer class CommandBuffer implements NavigatorHolder { private Navigator navigator; private Queue<Command[]> pendingCommands = new LinkedList<>(); @Override public void setNavigator(Navigator navigator) { this.navigator = navigator; ... } @Override public void removeNavigator() { this.navigator = null; } void executeCommands(Command[] commands) { if (navigator != null) { navigator.applyCommands(commands); } else { pendingCommands.add(commands); } } }
72. CommandBuffer class CommandBuffer implements NavigatorHolder { private Navigator navigator; private Queue<Command[]> pendingCommands = new LinkedList<>(); @Override public void setNavigator(Navigator navigator) { this.navigator = navigator; ... } @Override public void removeNavigator() { this.navigator = null; } void executeCommands(Command[] commands) { if (navigator != null) { navigator.applyCommands(commands); } else { pendingCommands.add(commands); } } }
73. NavigatorHolder
74. NavigatorHolder public interface NavigatorHolder { void setNavigator(Navigator navigator); void removeNavigator(); }
75. NavigatorHolder public interface NavigatorHolder { void setNavigator(Navigator navigator); void removeNavigator(); } Пример:
76. NavigatorHolder public interface NavigatorHolder { void setNavigator(Navigator navigator); void removeNavigator(); } Пример: @Override protected void onResumeFragments() { super.onResume(); App.INSTANCE.getNavigatorHolder().setNavigator(navigator); } @Override protected void onPause() { App.INSTANCE.getNavigatorHolder().removeNavigator(); super.onPause(); }
77. От теории к практике. Как использовать Cicerone? dependencies { implementation 'ru.terrakok.cicerone:cicerone:4.0.2' }
78. От теории к практике. Как использовать Cicerone? public class App extends Application { public static App INSTANCE; private Cicerone<Router> cicerone; @Override public void onCreate() { super.onCreate(); INSTANCE = this; cicerone = Cicerone.create(); } public NavigationHolder getNavigationHolder() { return cicerone.getNavigationHolder(); } public Router getRouter() { return cicerone.getRouter(); } } dependencies { implementation 'ru.terrakok.cicerone:cicerone:4.0.2' }
79. От теории к практике. Как использовать Cicerone? public class App extends Application { public static App INSTANCE; private Cicerone<Router> cicerone; @Override public void onCreate() { super.onCreate(); INSTANCE = this; cicerone = Cicerone.create(); } public NavigationHolder getNavigationHolder() { return cicerone.getNavigationHolder(); } public Router getRouter() { return cicerone.getRouter(); } } dependencies { implementation 'ru.terrakok.cicerone:cicerone:4.0.2' }
80. От теории к практике. Как использовать Cicerone? public class App extends Application { public static App INSTANCE; private Cicerone<Router> cicerone; @Override public void onCreate() { super.onCreate(); INSTANCE = this; cicerone = Cicerone.create(); } public NavigationHolder getNavigationHolder() { return cicerone.getNavigationHolder(); } public Router getRouter() { return cicerone.getRouter(); } } dependencies { implementation 'ru.terrakok.cicerone:cicerone:4.0.2' }
81. От теории к практике. Как использовать Cicerone? public class App extends Application { public static App INSTANCE; private Cicerone<Router> cicerone; @Override public void onCreate() { super.onCreate(); INSTANCE = this; cicerone = Cicerone.create(); } public NavigationHolder getNavigationHolder() { return cicerone.getNavigationHolder(); } public Router getRouter() { return cicerone.getRouter(); } } dependencies { implementation 'ru.terrakok.cicerone:cicerone:4.0.2' }
82. От теории к практике. Как использовать Cicerone? public class MainActivity extends AppCompatActivity { Navigator navigator = SupportAppNavigator(this, R.id.main_container); @Override protected void onResumeFragments() { super.onResume(); App.INSTANCE.getNavigatorHolder().setNavigator(navigator); } @Override protected void onPause() { App.INSTANCE.getNavigatorHolder().removeNavigator(); super.onPause(); } }
83. От теории к практике. Как использовать Cicerone? public class MainActivity extends AppCompatActivity { Navigator navigator = SupportAppNavigator(this, R.id.main_container); @Override protected void onResumeFragments() { super.onResume(); App.INSTANCE.getNavigatorHolder().setNavigator(navigator); } @Override protected void onPause() { App.INSTANCE.getNavigatorHolder().removeNavigator(); super.onPause(); } }
84. От теории к практике. Как использовать Cicerone? public class MainActivity extends AppCompatActivity { Navigator navigator = SupportAppNavigator(this, R.id.main_container); @Override protected void onResumeFragments() { super.onResume(); App.INSTANCE.getNavigatorHolder().setNavigator(navigator); } @Override protected void onPause() { App.INSTANCE.getNavigatorHolder().removeNavigator(); super.onPause(); } }
85. От теории к практике. Как использовать Cicerone? public class MainActivity extends AppCompatActivity { Navigator navigator = SupportAppNavigator(this, R.id.main_container); @Override protected void onResumeFragments() { super.onResume(); App.INSTANCE.getNavigatorHolder().setNavigator(navigator); } @Override protected void onPause() { App.INSTANCE.getNavigatorHolder().removeNavigator(); super.onPause(); } }
86. От теории к практике. Как использовать Cicerone? public class MainActivity extends AppCompatActivity { Navigator navigator = SupportAppNavigator(this, R.id.main_container); @Override protected void onResumeFragments() { super.onResume(); App.INSTANCE.getNavigatorHolder().setNavigator(navigator); } @Override protected void onPause() { App.INSTANCE.getNavigatorHolder().removeNavigator(); super.onPause(); } }
87. От теории к практике. Как использовать Cicerone? public class MainActivity extends AppCompatActivity { Navigator navigator = SupportAppNavigator(this, R.id.main_container); @Override protected void onResumeFragments() { super.onResume(); App.INSTANCE.getNavigatorHolder().setNavigator(navigator); } @Override protected void onPause() { App.INSTANCE.getNavigatorHolder().removeNavigator(); super.onPause(); } }
88. От теории к практике. Как использовать Cicerone? public class UsersPresenter extends BasePresenter<UsersView> { private Router router; public UsersPresenter() { router = App.INSTANCE.getRouter(); } public void onUserClicked(User user) { router.navigateTo(new UserScreen(user)); } public void onBackClicked() { router.exit(); } }
89. От теории к практике. Как использовать Cicerone? public class UsersPresenter extends BasePresenter<UsersView> { private Router router; public UsersPresenter() { router = App.INSTANCE.getRouter(); } public void onUserClicked(User user) { router.navigateTo(new UserScreen(user)); } public void onBackClicked() { router.exit(); } }
90. От теории к практике. Как использовать Cicerone? public class UsersPresenter extends BasePresenter<UsersView> { private Router router; public UsersPresenter() { router = App.INSTANCE.getRouter(); } public void onUserClicked(User user) { router.navigateTo(new UserScreen(user)); } public void onBackClicked() { router.exit(); } }
91. От теории к практике. Как использовать Cicerone? public class UsersPresenter extends BasePresenter<UsersView> { private Router router; public UsersPresenter() { router = App.INSTANCE.getRouter(); } public void onUserClicked(User user) { router.navigateTo(new UserScreen(user)); } public void onBackClicked() { router.exit(); } }
92. От теории к практике. Как использовать Cicerone? public class UsersPresenter extends BasePresenter<UsersView> { private Router router; public UsersPresenter() { router = App.INSTANCE.getRouter(); } public void onUserClicked(User user) { router.navigateTo(new UserScreen(user)); } public void onBackClicked() { router.exit(); } }
93. Схема работы Cicerone
94. Ну все, конец