Навигация в android без боли и слез

Навигация без боли и слез

Константин Цховребов Android Team Leader

Первый большой проект на MVP

В теории все прекрасно!

Первый большой проект на MVP

В теории все прекрасно!

Первый большой проект на MVP На практике встречаешь ANDROID

Навигация в андроид приложении


●  Переход между экранами


●  Переход между экранами ●  Экраны сменяются в некотором контейнере


●  Переход между экранами ●  Экраны сменяются в некотором контейнере ●  Для совершения перехода нужен Context

А что если Fragment сделать презентером?

А что если Fragment сделать презентером? 1.  Lifecycle


2.  Нужен универсальный подход (Activity/Fragment/View)


2.  Нужен универсальный подход (Activity/Fragment/View)

3.  Context (и другие классы)

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(); } … }

Готовые решения

Flow (https://github.com/square/flow) Conductor (https://github.com/bluelinelabs/Conductor)

Требования к идеальной навигации


●  прямой доступ из презентера


●  прямой доступ из презентера ●  не завязана на фрагменты


●  прямой доступ из презентера ●  не завязана на фрагменты ●  не фреймворк


●  прямой доступ из презентера ●  не завязана на фрагменты ●  не фреймворк ●  короткие вызовы


●  прямой доступ из презентера ●  не завязана на фрагменты ●  не фреймворк ●  короткие вызовы ●  легка в расширении


●  прямой доступ из презентера ●  не завязана на фрагменты ●  не фреймворк ●  короткие вызовы ●  легка в расширении ●  приспособлена для тестов


●  прямой доступ из презентера ●  не завязана на фрагменты ●  не фреймворк ●  короткие вызовы ●  легка в расширении ●  приспособлена для тестов ●  не зависит от жизненного цикла!

//TODO:


Это реальный проект!

Команды переходов

Команды переходов Forward(String screenKey, Object transitionData);


Back();


Back();

BackTo(String screenKey);


Back();

BackTo(String screenKey);

Replace(String screenKey, Object transitionData);

SystemMessage

SystemMessage(String message);

Navigator public interface Navigator { void applyCommand(Command command); }

Navigator public interface Navigator { void applyCommand(Command command); }

public class MainActivity extends Activity { private Navigator navigator = new Navigator() { @Override public void applyCommand(Command command) { ... } } }

//TODO:


//TODO:


✓

public class Presenter { @Inject Navigator navigator; private void next() { navigator.applyCommand(new Forward(“Some screen”)); } }

//TODO:


✓

//TODO:


✓ ✓

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!")); } }

Router public class Router extends BaseRouter { void newRootScreenWithMessage(String screenKey, Object data, String message) {...} }

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!"); } }

//TODO:


✓ ✓

//TODO:


✓ ✓

✓

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!")); } } }

public class MainActivity extends Activity { @Override protected void onResume() { super.onResume(); router.setNavigator(navigator); } @Override protected void onPause() { super.onPause(); router.removeNavigator(); } }

Presenter View load()

View Presenter load()

request()

Presenter

request()

View

Presenter

request() response()

View

Presenter

Router


View

Presenter

RouterImpl Command

Queue


View

View Presenter

RouterImpl Command

Queue


//TODO:


✓ ✓

✓

//TODO:


✓ ✓

✓

✓

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() ); }

//TODO:


✓ ✓

✓

✓

//TODO:


✓ ✓

✓

✓ ✓

Расширение возможностей

●  в большинстве случаев достаточно добавить метод в Router и реализовать его с помощью Command

●  реже необходимо создать новую Command

//TODO:


✓ ✓

✓

✓ ✓

//TODO:


✓ ✓

✓

✓ ✓ ✓

//TODO:


✓ ✓

✓

✓ ✓ ✓

✓

Cicerone Чичероне - (устар.) гид для иностранцев

https://github.com/terrakok/Cicerone repositories { maven { url 'https://dl.bintray.com/terrakok/terramaven/' } } dependencies { //Cicerone compile 'ru.terrakok.cicerone:cicerone:1.0' }

Для кого мы ее создали?

Для кого мы ее создали? Для себя :)


Почему она может пригодиться вам?

Для себя :)


●  В приложении нелинейная навигация


Для себя :)


●  В приложении нелинейная навигация ●  Отделение логики от отображения


Для себя :)


●  В приложении нелинейная навигация ●  Отделение логики от отображения ●  Сохранение вызовов навигации после возвращения к приложению


Для себя :)

Возможности 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 exitWithMessage(String message); void showSystemMessage(String message); }

public abstract class FragmentNavigator implements Navigator {}

Спасибо за внимание! Вопросы?

email: [email protected] telegram: @terrakok https://github.com/terrakok/Cicerone

Навигация в android без боли и слез

Mobile