Условная навигация

При разработке навигации для вашего приложения вы можете захотеть перейти к одному пункту назначения по сравнению с другим на основе условной логики. Например, ссылка на контент может вести на страницу, для просмотра которой требуется войти в аккаунт, или в игре могут быть разные целевые страницы для победителей и проигравших.

Вход пользователя

В этом примере пользователь пытается перейти на экран профиля, для которого требуется аутентификация. Поскольку это действие требует аутентификации, пользователь должен быть перенаправлен на экран входа, если он ещё не прошел аутентификацию.

Граф навигации для этого примера может выглядеть примерно так:

Процесс входа в аккаунт обрабатывается отдельно от основной навигации приложения.
Рисунок 1. Процесс входа в аккаунт обрабатывается отдельно от основного процесса навигации в приложении.

Для аутентификации приложение должно перейти по адресу login_fragment, где пользователь может ввести имя пользователя и пароль. Если пользователь соглашается, он возвращается на экран profile_fragment. Если нет, пользователь получает сообщение об ошибке Snackbar. Если пользователь вернется на экран профиля, не выполнив вход, он будет перенаправлен на экран main_fragment.

Вот граф навигации для этого приложения:

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        xmlns:tools="http://schemas.android.com/tools"
        android:id="@+id/nav_graph"
        app:startDestination="@id/main_fragment">
    <fragment
            android:id="@+id/main_fragment"
            android:name="com.google.android.conditionalnav.MainFragment"
            android:label="fragment_main"
            tools:layout="@layout/fragment_main">
        <action
                android:id="@+id/navigate_to_profile_fragment"
                app:destination="@id/profile_fragment"/>
    </fragment>
    <fragment
            android:id="@+id/login_fragment"
            android:name="com.google.android.conditionalnav.LoginFragment"
            android:label="login_fragment"
            tools:layout="@layout/login_fragment"/>
    <fragment
            android:id="@+id/profile_fragment"
            android:name="com.google.android.conditionalnav.ProfileFragment"
            android:label="fragment_profile"
            tools:layout="@layout/fragment_profile"/>
</navigation>

MainFragment содержит кнопку, нажав на которую пользователь может перейти в свой профиль. Чтобы увидеть экран профиля, пользователю сначала нужно пройти аутентификацию. Это взаимодействие моделируется с помощью двух отдельных фрагментов, но зависит от общего состояния пользователя. Эта информация о состоянии не является ответственностью ни одного из этих двух фрагментов и более уместно хранится в общей UserViewModel. Этот ViewModel используется фрагментами, поскольку он ограничен действием, которое реализует ViewModelStoreOwner. В примере ниже requireActivity() разрешается в MainActivity, потому что MainActivity размещает ProfileFragment:

Kotlin

class ProfileFragment : Fragment() {
    private val userViewModel: UserViewModel by activityViewModels()
    ...
}

Java

public class ProfileFragment extends Fragment {
    private UserViewModel userViewModel;
    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);
        ...
    }
    ...
}

Пользовательские данные в UserViewModel предоставляются с помощью LiveData, поэтому, чтобы решить, куда перейти, вам следует просмотреть эти данные. При переходе на страницу ProfileFragment приложение показывает приветственное сообщение, если данные пользователя доступны. Если данные пользователя равны null, вы переходите к LoginFragment, поскольку пользователю необходимо пройти аутентификацию, прежде чем увидеть свой профиль. Определите логику принятия решений в ProfileFragment, как показано в следующем примере:

Kotlin

class ProfileFragment : Fragment() {
    private val userViewModel: UserViewModel by activityViewModels()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val navController = findNavController()
        userViewModel.user.observe(viewLifecycleOwner, Observer { user ->
            if (user != null) {
                showWelcomeMessage()
            } else {
                navController.navigate(R.id.login_fragment)
            }
        })
    }

    private fun showWelcomeMessage() {
        ...
    }
}

Java

public class ProfileFragment extends Fragment {
    private UserViewModel userViewModel;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);
        final NavController navController = Navigation.findNavController(view);
        userViewModel.user.observe(getViewLifecycleOwner(), (Observer<User>) user -> {
            if (user != null) {
                showWelcomeMessage();
            } else {
                navController.navigate(R.id.login_fragment);
            }
        });
    }

    private void showWelcomeMessage() {
        ...
    }
}

Если пользовательские данные null, когда пользователь достигает ProfileFragment, он перенаправляется на LoginFragment.

Вы можете использовать NavController.getPreviousBackStackEntry, чтобы получить NavBackStackEntry для предыдущего пункта назначения, который инкапсулирует состояние, специфичное для NavController, для пункта назначения. LoginFragment использует SavedStateHandle предыдущего NavBackStackEntry, чтобы задать начальное значение, указывающее, успешно ли пользователь вошел в систему. Это состояние, которое вы хотите вернуть, если пользователь сразу нажмет системную кнопку «Назад». Задание этого состояния с помощью SavedStateHandle гарантирует, что оно сохранится после завершения процесса.

Kotlin

class LoginFragment : Fragment() {
    companion object {
        const val LOGIN_SUCCESSFUL: String = "LOGIN_SUCCESSFUL"
    }

    private val userViewModel: UserViewModel by activityViewModels()
    private lateinit var savedStateHandle: SavedStateHandle

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        savedStateHandle = findNavController().previousBackStackEntry!!.savedStateHandle
        savedStateHandle.set(LOGIN_SUCCESSFUL, false)
    }
}

Java

public class LoginFragment extends Fragment {
    public static String LOGIN_SUCCESSFUL = "LOGIN_SUCCESSFUL"

    private UserViewModel userViewModel;
    private SavedStateHandle savedStateHandle;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);

        savedStateHandle = Navigation.findNavController(view)
                .getPreviousBackStackEntry()
                .getSavedStateHandle();
        savedStateHandle.set(LOGIN_SUCCESSFUL, false);
    }
}

После того как пользователь введет имя и пароль, они будут переданы в UserViewModel для аутентификации. Если аутентификация прошла успешно, UserViewModel сохраняет данные пользователя. Затем LoginFragment обновляет значение LOGIN_SUCCESSFUL в SavedStateHandle и удаляет себя из обратного стека.

Kotlin

class LoginFragment : Fragment() {
    companion object {
        const val LOGIN_SUCCESSFUL: String = "LOGIN_SUCCESSFUL"
    }

    private val userViewModel: UserViewModel by activityViewModels()
    private lateinit var savedStateHandle: SavedStateHandle

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        savedStateHandle = findNavController().previousBackStackEntry!!.savedStateHandle
        savedStateHandle.set(LOGIN_SUCCESSFUL, false)

        val usernameEditText = view.findViewById(R.id.username_edit_text)
        val passwordEditText = view.findViewById(R.id.password_edit_text)
        val loginButton = view.findViewById(R.id.login_button)

        loginButton.setOnClickListener {
            val username = usernameEditText.text.toString()
            val password = passwordEditText.text.toString()
            login(username, password)
        }
    }

    fun login(username: String, password: String) {
        userViewModel.login(username, password).observe(viewLifecycleOwner, Observer { result ->
            if (result.success) {
                savedStateHandle.set(LOGIN_SUCCESSFUL, true)
                findNavController().popBackStack()
            } else {
                showErrorMessage()
            }
        })
    }

    fun showErrorMessage() {
        // Display a snackbar error message
    }
}

Java

public class LoginFragment extends Fragment {
    public static String LOGIN_SUCCESSFUL = "LOGIN_SUCCESSFUL"

    private UserViewModel userViewModel;
    private SavedStateHandle savedStateHandle;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        userViewModel = new ViewModelProvider(requireActivity()).get(UserViewModel.class);

        savedStateHandle = Navigation.findNavController(view)
                .getPreviousBackStackEntry()
                .getSavedStateHandle();
        savedStateHandle.set(LOGIN_SUCCESSFUL, false);

        EditText usernameEditText = view.findViewById(R.id.username_edit_text);
        EditText passwordEditText = view.findViewById(R.id.password_edit_text);
        Button loginButton = view.findViewById(R.id.login_button);

        loginButton.setOnClickListener(v -> {
            String username = usernameEditText.getText().toString();
            String password = passwordEditText.getText().toString();
            login(username, password);
        });
    }

    private void login(String username, String password) {
        userViewModel.login(username, password).observe(viewLifecycleOwner, (Observer<LoginResult>) result -> {
            if (result.success) {
                savedStateHandle.set(LOGIN_SUCCESSFUL, true);
                NavHostFragment.findNavController(this).popBackStack();
            } else {
                showErrorMessage();
            }
        });
    }

    private void showErrorMessage() {
        // Display a snackbar error message
    }
}

Обратите внимание, что вся логика, связанная с аутентификацией, содержится в UserViewModel. Это важно, поскольку ни LoginFragment, ни ProfileFragment не определяют, как выполняется аутентификация пользователей. Инкапсуляция логики в ViewModel не только упрощает обмен данными, но и облегчает тестирование. Если логика навигации сложная, вам следует проверить ее с помощью тестирования. Дополнительную информацию о том, как структурировать архитектуру приложения на основе тестируемых компонентов, можно найти в руководстве по архитектуре приложений.

Вернемся к ProfileFragment. Значение LOGIN_SUCCESSFUL, сохраненное в SavedStateHandle, можно увидеть в методе onCreate(). Когда пользователь вернется в ProfileFragment, будет проверено значение LOGIN_SUCCESSFUL. Если значение равно false, пользователь может быть перенаправлен обратно в MainFragment.

Kotlin

class ProfileFragment : Fragment() {
    ...

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        val navController = findNavController()

        val currentBackStackEntry = navController.currentBackStackEntry!!
        val savedStateHandle = currentBackStackEntry.savedStateHandle
        savedStateHandle.getLiveData<Boolean>(LoginFragment.LOGIN_SUCCESSFUL)
                .observe(currentBackStackEntry, Observer { success ->
                    if (!success) {
                        val startDestination = navController.graph.startDestination
                        val navOptions = NavOptions.Builder()
                                .setPopUpTo(startDestination, true)
                                .build()
                        navController.navigate(startDestination, null, navOptions)
                    }
                })
    }

    ...
}

Java

public class ProfileFragment extends Fragment {
    ...

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        NavController navController = NavHostFragment.findNavController(this);

        NavBackStackEntry navBackStackEntry = navController.getCurrentBackStackEntry();
        SavedStateHandle savedStateHandle = navBackStackEntry.getSavedStateHandle();
        savedStateHandle.getLiveData(LoginFragment.LOGIN_SUCCESSFUL)
                .observe(navBackStackEntry, (Observer<Boolean>) success -> {
                    if (!success) {
                        int startDestination = navController.getGraph().getStartDestination();
                        NavOptions navOptions = new NavOptions.Builder()
                                .setPopUpTo(startDestination, true)
                                .build();
                        navController.navigate(startDestination, null, navOptions);
                    }
                });
    }

    ...
}

Если пользователь успешно вошел в систему, ProfileFragment показывает приветственное сообщение.

Используемый здесь метод проверки результата позволяет различать два разных случая:

  • Начальное состояние, когда пользователь не вошел в аккаунт и ему предлагается это сделать.
  • Пользователь не вошел в аккаунт, потому что он решил этого не делать (результат false).

Различая эти варианты использования, вы можете избежать повторных запросов на вход пользователя. Бизнес-логика обработки ошибок остается на ваше усмотрение. Например, вы можете показать оверлей с объяснением, почему пользователю нужно войти в аккаунт, завершить все действия или перенаправить пользователя на страницу, для которой вход не требуется, как в предыдущем примере кода.