Uygulamanız için gezinme tasarlarken koşullu mantığa göre bir hedefe gitmek isteyebilirsiniz. Örneğin, bir kullanıcı, giriş yapmasını gerektiren bir hedefe yönlendiren derin bağlantıyı takip edebilir veya bir oyunda oyuncunun kazanması ya da kaybetmesi durumunda farklı hedefleriniz olabilir.
Kullanıcı girişi
Bu örnekte, kullanıcı kimlik doğrulaması gerektiren bir profil ekranına gitmeye çalışmaktadır. Bu işlem kimlik doğrulama gerektirdiğinden, kimliği doğrulanmamış kullanıcılar bir giriş ekranına yönlendirilmelidir.
Bu örnekteki gezinme grafiği şuna benzer:
Kimlik doğrulaması için uygulamanın login_fragment adresine gitmesi gerekir. Kullanıcı, bu adreste kullanıcı adı ve şifre girerek kimlik doğrulayabilir. Kabul edilirse kullanıcı profile_fragment ekranına geri gönderilir. Kabul edilmezse kullanıcıya Snackbar ile kimlik bilgilerinin geçersiz olduğu bildirilir. Kullanıcı giriş yapmadan profil ekranına geri dönerse main_fragment ekranına yönlendirilir.
Bu uygulamanın gezinme grafiği şu şekildedir:
<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, kullanıcının profilini görüntülemek için tıklayabileceği bir düğme içerir.
Kullanıcı, profil ekranını görmek istiyorsa önce kimliğini doğrulamalıdır. Bu etkileşim iki ayrı parça kullanılarak modellenir ancak paylaşılan kullanıcı durumuna bağlıdır. Bu durum bilgisi, bu iki parçanın sorumluluğunda değildir ve paylaşılan bir UserViewModel içinde tutulması daha uygundur.
Bu ViewModel, ViewModelStoreOwner uygulayan etkinliğe kapsam atanarak parçalar arasında paylaşılır. Aşağıdaki örnekte, MainActivity ProfileFragment'yi barındırdığı için requireActivity(), MainActivity olarak çözümlenir:
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 içindeki kullanıcı verileri LiveData kullanılarak gösterilir. Bu nedenle, nereye gideceğinize karar vermek için bu verileri incelemeniz gerekir. ProfileFragment sayfasına gidildiğinde kullanıcı verileri mevcutsa uygulama bir karşılama mesajı gösterir. Kullanıcı verileri null ise kullanıcının profilini görmeden önce kimliğini doğrulaması gerektiğinden LoginFragment sayfasına gidersiniz. Aşağıdaki örnekte gösterildiği gibi, ProfileFragment dosyanızda karar mantığını tanımlayın:
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() {
...
}
}
Kullanıcı verileri ProfileFragment değerine ulaştığında null ise kullanıcı LoginFragment sayfasına yönlendirilir.
Önceki hedefin NavBackStackEntry değerini almak için NavController.getPreviousBackStackEntry yöntemini kullanabilirsiniz. Bu değer, hedefin NavController'ya özgü durumunu kapsar. LoginFragment, kullanıcının başarıyla giriş yapıp yapmadığını gösteren bir başlangıç değeri ayarlamak için önceki NavBackStackEntry'nin SavedStateHandle değerini kullanır. Kullanıcı sistem geri düğmesine hemen basarsa bu duruma dönmek istersiniz.
Bu durumu SavedStateHandle kullanarak ayarlamak, durumun işlem sonlandırma sırasında kalıcı olmasını sağlar.
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);
}
}
Kullanıcı bir kullanıcı adı ve şifre girdikten sonra, kimlik doğrulama için UserViewModel adresine yönlendirilir. Kimlik doğrulama başarılı olursa UserViewModel, kullanıcı verilerini depolar. Ardından LoginFragment, SavedStateHandle üzerindeki LOGIN_SUCCESSFUL değerini günceller ve kendisini eski yığından çıkarır.
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
}
}
Kimlik doğrulamayla ilgili tüm mantığın UserViewModel içinde tutulduğunu unutmayın. Kullanıcıların kimliklerinin nasıl doğrulanacağını belirlemek LoginFragment veya ProfileFragment'in sorumluluğunda olmadığından bu önemlidir. Mantığınızı bir ViewModel içinde kapsüllemek, paylaşmayı ve test etmeyi kolaylaştırır. Gezinme mantığınız karmaşıksa bu mantığı özellikle test ederek doğrulamanız gerekir. Uygulamanızın mimarisini test edilebilir bileşenler etrafında yapılandırma hakkında daha fazla bilgi için Uygulama mimarisi kılavuzu'na bakın.
ProfileFragment içinde, SavedStateHandle içinde depolanan LOGIN_SUCCESSFUL değeri onCreate() yönteminde görülebilir. Kullanıcı ProfileFragment sayfasına döndüğünde LOGIN_SUCCESSFUL değeri kontrol edilir. Değer false ise kullanıcı MainFragment sayfasına geri yönlendirilebilir.
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);
}
});
}
...
}
Kullanıcı başarıyla giriş yaptıysa ProfileFragment bir karşılama mesajı gösterir.
Burada kullanılan, sonucu kontrol etme tekniği iki farklı durumu ayırt etmenizi sağlar:
- Kullanıcının giriş yapmadığı ve giriş yapmasının istendiği ilk durum.
- Kullanıcı giriş yapmamayı seçtiği için giriş yapmamıştır (
falsesonucunda).
Bu kullanım alanlarını ayırt ederek kullanıcıdan tekrar tekrar giriş yapmasını istemekten kaçınabilirsiniz. Hata durumlarını ele almaya yönelik iş mantığı size bırakılmıştır. Bu mantık, kullanıcının neden giriş yapması gerektiğini açıklayan bir yer paylaşımı göstermeyi, tüm etkinliği tamamlamayı veya kullanıcıyı giriş yapmayı gerektirmeyen bir hedefe yönlendirmeyi içerebilir (önceki kod örneğinde olduğu gibi).