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

Навигация
без боли и слез
Константин Цховребов
Android Team Leader

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

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

В теории все прекрасно!
На практике встречаешь ANDROID

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

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

●  Экраны сменяются в некотором контейнере

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

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

1.  Lifecycle

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

1.  Lifecycle
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:
✓

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

//TODO:
✓
✓

@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
void newRootScreenWithMessage(String screenKey, Object data, String message) {...}
}
@Inject
Router router;
private void authError() {
router.newRootScreenWithMessage("Login screen", null, "Token expired!");
}
}

//TODO:
✓
✓
✓

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

ViewPresenter
load()
request()

Presenter
request() response()
View

Presenter
Router
View

Presenter
RouterImpl
Command
Queue
View

ViewPresenter
RouterImpl
Command
Queue

//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:
✓
✓
✓
✓
✓

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

//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
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: terrakok@mobileup.ru
telegram: @terrakok
https://github.com/terrakok/Cicerone

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

More Related Content

What's hot

Viewers also liked

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

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