Android——JetPack{Navigation}

作者: So_ProbuING | 来源:发表于2021-09-08 18:11 被阅读0次

Navigation诞生背景

单个Activity+多个Fragment的UI架构模式，已经被越来越多的项目开发所采用。但是对Fragment的管理一直是一件比较麻烦的事情。管理Fragment需要使用FragmentManager和FragmentTransaction来管理Fragment之间的切换。
为此，Jetpack提供了一个名为Navigation的组件，来帮助我们管理页面和Appbar

什么是Navigation

Navigation

Navigation三大件

Navigation Graph：这是一种新型的XML资源文件，其中包含应用程序的所有页面，以及页面间的关系
NavHost：用于显示导航中目标的空包容器。Navigation Graph中的Fragment正是通过NavHostFragment进行展示的
NavController：控制显示在NavHost中显示的内容，这是一个Java对象，用于在代码中完成Navigation Graph中具体的页面切换

当想要切换Fragment时，使用NavController对象，告诉它你想要去Navigation Graph中的哪个Fragment，NavController会将你想去的Fragment展示在NavHost中

Navigation三大件提供的功能

Navigation三大件提供的优势

往返操作——回退栈的操作
动画——提供标准的进入进出动画的使用资源
深层链接——deepLink

Navigation能做什么

使用Navigation

添加gradle依赖

    implementation 'androidx.navigation:navigation-fragment:2.3.0'
    implementation 'androidx.navigation:navigation-ui:2.3.0'

创建Navigation Graph
使用AndoridStudio 可以帮我们创建Navigation Graph

image.png

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/nav_graph"
    app:startDestination="@id/fragmenta">
    <action android:id="@+id/to_fragmentb"
        app:destination="@+id/fragmentb"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmentc"
        app:destination="@+id/fragmentc"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmentd"
        app:destination="@+id/fragmentd"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmenta"
        app:destination="@+id/fragmenta"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmente"
        app:destination="@+id/fragmente"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <fragment
        android:id="@+id/fragmenta"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentA"
        android:label="fragment">

    </fragment>
    <fragment
        android:id="@+id/fragmentb"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentB"
        android:label="fragment">
        <deepLink app:uri="http://www.wx.com/{params}"/>
    </fragment>
    <fragment
        android:id="@+id/fragmentc"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentC"
        android:label="fragment"></fragment>
    <fragment
        android:id="@+id/fragmentd"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentD"
        android:label="fragment"></fragment>
    <fragment
        android:id="@+id/fragmente"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentE"
        android:label="fragment"></fragment>
</navigation>

根布局中的app:startDestination="@id/fragmenta"：表示设置起始的路径点，也就是一开始加载的fragment
Action中的app:destination="@+id/fragmenta" 表示要前往的目的地是哪个组件，用id标识

添加NavHostFragment
在Activity的布局文件中添加

    <fragment
        android:id="@+id/nav_fragment"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:defaultNavHost="true"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:navGraph="@navigation/nav_graph" />

指定android:name 是在告诉系统，这是一个特殊的Fragment

app:defaultNavHost：表示使用该Fragment处理回退栈
app:navGraph:设置该Fragment对应的导航图
4.创建FragmentA （其他Fragment带代码类似）

public class FragmentB extends Fragment {
    private static final String TAG = "----------->";

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View containerView = inflater.inflate(R.layout.fragment_b, container, false);
        return containerView;
    }
}

使用NavController完成导航

navController = Navigation.findNavController(this, R.id.nav_fragment);

使用navController完成Fragment跳转

        NavController navController = Navigation.findNavController(getView());
                navController.navigate(R.id.to_fragmentc);

参数传递

常见的参数传递

safe args传递参数

安装safe args插件在project的build.gradle文件中添加safe args插件

    dependencies {
        classpath 'androidx.navigation:navigation-safe-args-gradle-plugin:2.3.0-alpha01'
    }

在app的build.gradle文件中添加对safe args的依赖

plugins {
    id 'com.android.application'
    id 'androidx.navigation.safeargs'
}

在导航文件 nav_graph中添加<argument/>标签

    <fragment
        android:id="@+id/fragmentb"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentB"
        android:label="fragment">
        <deepLink app:uri="http://www.wx.com/{params}"/>
        <argument android:defaultValue="unknow" android:name="user_name" app:argType="string"/>
        <argument android:defaultValue="0" android:name="user_age" app:argType="integer"/>
    </fragment>

添加<argument/>后，便可以在app/generatedJava目录下看到safe args插件为我们生成的代码文件了，这些代码文件中包含了参数所对应的Getter和Setter方法
需要在Fragment中利用所生成的代码文件，传递数据

image.png

NavigationUI的使用

NavigationUI的存在意义

Jetpack为了方便我们管理App bar中menu菜单的变化。切换页面时来管理App bar 与导航图中的页面关联
我们来实现一个这样的效果

image.png

在Activity中添加BottomNavigationView

<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=".navigationlsn.NavigationActivity">

    <fragment
        android:id="@+id/nav_fragment"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:defaultNavHost="true"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:navGraph="@navigation/nav_graph" />

    <com.google.android.material.bottomnavigation.BottomNavigationView
        android:id="@+id/nav_bottom"
        android:layout_width="match_parent"
        android:layout_height="50dp"
        android:background="@color/white"
        app:labelVisibilityMode="auto"
        app:itemRippleColor = "@null"
        app:layout_constraintBottom_toBottomOf="parent"
        app:menu="@menu/nav_menu"/>
</androidx.constraintlayout.widget.ConstraintLayout>

创建menu

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/fragmenta"
        android:icon="@mipmap/index"
        android:title="首页" />
    <item
        android:id="@+id/fragmentb"
        android:icon="@mipmap/cate"
        android:title="分类" />
    <item
        android:id="@+id/fragmentc"
        android:icon="@mipmap/cart"
        android:title="购物车" />
    <item
        android:id="@+id/fragmentd"
        android:icon="@mipmap/me"
        android:title="我的" />
</menu>

使用NavigationUI帮我们关联起来

  //绑定navcontroller
        NavigationUI.setupWithNavController(bottomNavgation, navController);
       bottomNavgation.setOnNavigationItemSelectedListener(new BottomNavigationView.OnNavigationItemSelectedListener() {
            @Override
            public boolean onNavigationItemSelected(@NonNull MenuItem item) {
                switch (item.getItemId()) {
                    case R.id.nav_menu_home:
                        Log.d(TAG, "onNavigationItemSelected: home");
                        navController.navigate(R.id.to_fragmenta);
                        break;
                    case R.id.nav_menu_cate:
                        Log.d(TAG, "onNavigationItemSelected: cate");
                        navController.navigate(R.id.to_fragmentb);
                        break;
                    case R.id.nav_menu_cart:
                        Log.d(TAG, "onNavigationItemSelected: cart");
                        navController.navigate(R.id.to_fragmentc);
                        break;
                    case R.id.nav_menu_me:
                        Log.d(TAG, "onNavigationItemSelected: me");
                        navController.navigate(R.id.to_fragmentd);
                        break;
                }
                return false;
            }
        });

NavigationUI的扩展

NavigationUI对3种类型的App bar提供了支持，以上代码以BottomBar为例

ActionBar
Toolbar
CollapsingToolbarLayout
除了Menu菜单，NavigationUI还可以配合其他两种菜单使用
App bar 左侧的抽屉菜单(DrawLayout+NavigationVIew)
底部菜单(BottomNavigationView)

image.png

深层链接DeepLink

应用场景

PendingIntent的方式，当应用程序接收到某个通知推送，希望用户在单击该通知时，能够直接跳转到展示该通知的内容页面，可以通过PendingIntent来完成
URL方式，用户通过浏览器浏览网站上的某个页面，可以在网页上放置一个类似于“在应用内打开”的按钮，如果用户的手机安装有我们的应用程序，那么通过DeepLink就能打开相应的页面，如果没有安装，那么就引导用户下载

PendingIntent

 /**
     * 发送一个系统通知
     */
    private void sendNotification() {
        if (getActivity() == null) {
            return;
        }
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            int importance = NotificationManager.IMPORTANCE_DEFAULT;
            NotificationChannel channel = new NotificationChannel(CHANNEL_ID, "ChannelName", importance);
            channel.setDescription("描述性语句");
            NotificationManager notificationManager = getActivity().getSystemService(NotificationManager.class);
            notificationManager.createNotificationChannel(channel);
        }
        NotificationCompat.Builder builder = new NotificationCompat.Builder(getActivity(), CHANNEL_ID)
                .setSmallIcon(R.mipmap.me)
                .setContentTitle("通知来了")
                .setContentText("通知内容来了")
                .setPriority(NotificationCompat.PRIORITY_DEFAULT)
                .setContentIntent(getPendingIntent())
                .setAutoCancel(true);
        NotificationManagerCompat notificationManager = NotificationManagerCompat.from(getActivity());
        notificationManager.notify(notificationId, builder.build());
    }

    private PendingIntent getPendingIntent() {
        if (getActivity() != null) {
            Bundle bundle = new Bundle();
            bundle.putString("params", "from Notification");
            return Navigation.findNavController(getActivity(), R.id.btn_jumptoB)
                    .createDeepLink()
                    .setGraph(R.navigation.nav_graph)
                    .setDestination(R.id.fragmentc)
                    .setArguments(bundle)
                    .createPendingIntent();
        }
        return null;
    }

URL

在导航视图中为想要展示的页面添加<deepLink/>标签。在app:uri属性中填入网站的相应的web页面地址，后面的参数也会通过Bundle对象传递到页面中

<fragment
        android:id="@+id/fragmentb"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentB"
        android:label="fragment">
        <deepLink app:uri="http://www.wx.com/{params}"/>

为Activity设置<nav-graph/>标签，当用户在Web页面访问网站时，应用程序能够得到监听，在AndroidManifest.xml

      <activity android:name=".navigationlsn.NavigationActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <nav-graph android:value="@navigation/nav_graph" />
        </activity>

测试

>adb shell am start -a android.intent.action.VIEW -d "http://www.wx.com/123"

然后可以从系统的弹窗中选择我们的应用程序进行打开，打开后，在Fragment中，通过获取Bundle对象获取相应的参数，也就是URL链接后面的字符串，进而完成操作