Day05 - Android Jetpack: Navigation

这篇会稍微从前几篇的内容抽离出来，因为中秋节连假家人来找，只能先做点简单的事情...

Android Jetpack是Google在2018年时发布的一系列的Android Library，其中不少Library在现今开发时通常都会导入。我自己最常用到的就是Navigation了，它能很方便的管理App内各个Fragment的画面流，并且也能很直观的进行设定。有时回想起Navigation问世前使用Fragment的经历都会默默落下两行泪(?)

使用上首先是dependency的部分

dependencies {
    def nav_version = "2.3.5"
    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
    implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
}

因为目前来说我的App很简单，各页面间还没有太多的资料需要传输，所以引入基本的内容即可。

接下来是几个初步的动作

1. 在res下建立navigation资料夹以及resource file。

<?xml version="1.0" encoding="utf-8"?>
<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_main">
</navigation>

2. 在底层Activity的layout内加入FragmentContainerView

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    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:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/nav_host_fragment"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:defaultNavHost="true"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:navGraph="@navigation/nav_main" />

</androidx.constraintlayout.widget.ConstraintLayout>

3. 加入起始Fragment以及几个目的页面(fragment tag)、页面切换方向(action tag)。

<?xml version="1.0" encoding="utf-8"?>
<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_main"
    app:startDestination="@id/welcomeFragment">

    <fragment
        android:id="@+id/welcomeFragment"
        android:name="pet.ca.ptttweetsobserver.WelcomeFragment"
        android:label="fragment_welcome"
        tools:layout="@layout/fragment_welcome">
        <action
            android:id="@+id/action_welcomeFragment_to_loginFragment"
            app:destination="@id/loginFragment"
            app:popExitAnim="@id/welcomeFragment"
            app:popUpToInclusive="true" />
    </fragment>
    <fragment
        android:id="@+id/loginFragment"
        android:name="pet.ca.ptttweetsobserver.LoginFragment"
        android:label="fragment_login"
        tools:layout="@layout/fragment_login" />
</navigation>

这部分以程序码较不直观，以预览图来说会像这样：

最後在WelcomeFragment里面，需要往下一页前进时只需呼叫如下：

// 在这边的this为Fragment
NavHostFragment.findNavController(this)
    .navigate(R.id.action_welcomeFragment_to_loginFragment)

就能直接进到LoginFragment了。