التنقّل المشروط

عند تصميم التنقّل في تطبيقك، قد تحتاج إلى الانتقال إلى وجهة معيّنة بدلاً من وجهة أخرى استنادًا إلى منطق شرطي. على سبيل المثال، قد يتّبع المستخدم رابطًا عميقًا يؤدي إلى وجهة تتطلب تسجيل الدخول، أو قد تكون لديك وجهات مختلفة في لعبة ما عندما يفوز اللاعب أو يخسر.

تسجيل دخول المستخدم

في هذا المثال، يحاول المستخدم الانتقال إلى شاشة ملف شخصي تتطلب مصادقة. نظرًا لأن هذا الإجراء يتطلب المصادقة، يجب إعادة توجيه المستخدم إلى شاشة تسجيل الدخول إذا لم تتم مصادقته بالفعل.

قد يبدو الرسم البياني للتنقّل في هذا المثال على النحو التالي:

يتم التعامل مع عملية تسجيل الدخول بشكل مستقل عن عملية التنقل الرئيسية في التطبيق.
الشكل 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).

ومن خلال التمييز بين حالات الاستخدام هذه، يمكنك تجنُّب مطالبة المستخدم بتسجيل الدخول بشكل متكرر. يمكنك تحديد المنطق التجاري للتعامل مع حالات تعذُّر تسجيل الدخول، وقد يشمل ذلك عرض نافذة تراكب توضّح سبب حاجة المستخدم إلى تسجيل الدخول، أو إنهاء النشاط بالكامل، أو إعادة توجيه المستخدم إلى وجهة لا تتطلّب تسجيل الدخول، كما هو الحال في مثال الرمز البرمجي السابق.