Android 官方元件 Navigation 初使用

Keven發表於2019-04-10

Google I/O 大會中國場次已經結束,最近也上線了 Android Studio 3.2 版本,在新版本上有一個谷歌著重推薦的架構元件 Navigation。

Navigation 主要是提供了 Fragment 之間的跳轉切換,棧管理,可以使我們在應用中更加輕鬆的使用 Fragment。先看下我使用兩個 Fragment 實現的最終效果:

Android 官方元件 Navigation 初使用

第一步:想要使用 Navigation,首先要將 Android Studio 升級到 3.2 版本,然後在 Settings 中最後一行找到 Experimental,對右側 Enable Navigation Editor 打鉤,如下圖所示,然後重啟 studio 使設定生效。

Android 官方元件 Navigation 初使用

第二步: 建立兩個 Fragment,FirstFragment 和 SecondFragment,佈局內容如下:

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".FirstFragment">

    <!-- TODO: Update blank fragment layout -->
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:layout_marginTop="100dp"
        android:text="我是第一個Fragment"/>

    <Button
        android:id="@+id/btn_next"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="跳轉到第二個Fragment"
        android:textAllCaps="false"
    />
</FrameLayout>
複製程式碼
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
             xmlns:tools="http://schemas.android.com/tools"
             android:layout_width="match_parent"
             android:layout_height="match_parent"
             tools:context=".SecondFraagment">

    <!-- TODO: Update blank fragment layout -->
    <TextView
        android:layout_marginTop="100dp"
        android:layout_gravity="center_horizontal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="我是第二個Fragment"/>

    <Button
        android:textAllCaps="false"
        android:id="@+id/btn_back"
        android:layout_gravity="center"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="返回"
    />

</FrameLayout>
複製程式碼

第三步: 建立導航檢視檔案

在 res 目錄下新建 navigation 資料夾,然後新建一個 navigation 資原始檔(需要 Android Studio3.2以上版本)

Android 官方元件 Navigation 初使用

開啟資原始檔,然後切換為視覺化模式,將兩個已經建立好的 Fragment 新增進去,用箭頭連線它們,這樣就為它們繫結了跳轉事件。

Android 官方元件 Navigation 初使用

切換為 Text 模式後,可以看到具體的實現程式碼:

<?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/changefragment"
    app:startDestination="@id/firstFragment">

    <fragment
        android:id="@+id/firstFragment"
        android:name="keven.com.myteststudio3l2.FirstFragment"
        android:label="fragment_first"
        tools:layout="@layout/fragment_first">
        <action
            android:id="@+id/action_firstFragment_to_secondFraagment"
            app:destination="@id/secondFraagment"/>
    </fragment>
    <fragment
        android:id="@+id/secondFraagment"
        android:name="keven.com.myteststudio3l2.SecondFraagment"
        android:label="fragment_second_fraagment"
        tools:layout="@layout/fragment_second_fraagment"/>
</navigation>
複製程式碼

第四步: 編輯 MainActivity

在 Acitvity 佈局檔案中新增 fragment 元件,設定 name 屬性為 androidx.navigation.fragment.NavHostFragment。在傳統的單 Activity 多 Fragment 場景中,我們往往需要為 Activity 新增一個 FrameLayout 作為 Fragment 的容器。在 Navigation 中 HavHostFragment 就是 Fragment 的容器。佈局中的 navGraph 屬性建立了與 navigation 資原始檔的關係。

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.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">

    <fragment
        android:id="@+id/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/changefragment"
    />

</android.support.constraint.ConstraintLayout>
複製程式碼

重寫 onSupportNavigateUp()方法,目的是將 back 事件委託出去。若棧中有兩個以上 Fragment,點選 back 鍵就會返回到上一個 Fragment。

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public boolean onSupportNavigateUp() {
        Fragment fragment=getSupportFragmentManager().findFragmentById(R.id.fragment);
        return NavHostFragment.findNavController(fragment).navigateUp();
    }
}
複製程式碼

第五步: 在 Fragment 中設定相應的跳轉事件。

public class FirstFragment extends Fragment {


    public FirstFragment() {
        // Required empty public constructor
    }


    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        // Inflate the layout for this fragment
        return inflater.inflate(R.layout.fragment_first, container, false);
    }

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        Button btnNext=view.findViewById(R.id.btn_next);
        btnNext.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Navigation.findNavController(v).navigate(R.id.action_firstFragment_to_secondFraagment);
            }
        });
    }
}

複製程式碼
public class SecondFraagment extends Fragment {


    public SecondFraagment() {
        // Required empty public constructor
    }


    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        // Inflate the layout for this fragment
        return inflater.inflate(R.layout.fragment_second_fraagment, container, false);
    }

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        Button btnBack=view.findViewById(R.id.btn_back);
        btnBack.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Navigation.findNavController(v).navigateUp();
            }
        });
    }
}

複製程式碼

如果在介面切換的過程中需要傳值,就把資料設定在 Bundle 中,使用如下程式碼:

Navigation.findNavController(view).navigate(actionid,bundle);
複製程式碼

現在,我們就可以把程式執行起來了,如果需要轉場動畫,可以在 Navigation 資原始檔的 action 標籤下,新增動畫屬性。

相關文章