Jetpack第七篇:Navigation 组件

Navigation是一个路由组件,是一个优秀的Fragment管理工具,同样也可以管理Activity。开发者可以将重点放在业务开发上,避免处理太多了Fragment管理代码和调用代码,从而加速业务开发效率。

1、Navigation的组成

导航图

这个是在Android的资源文件路径下的navigation的文件夹下的资源文件,在这个资源文件中能够配置Fragment、Activity已经跳转动作action等等。

NavHost

这个是显示页面的空白容器,默认为NavHostFragment,可以理解为所有的Fragment都依靠它来显示。

NavController

NavHost中的管理对象,可以通过Controller对象去跳转Fragment和回退栈。也可以用于绑定NavigationBar等操作。

资源

这里说的就是Fragment、Activity等布局资源了,如果和BottomNavigationView绑定还需要menu资源等等。

2、实现一个简单的Navigation

实现一个非常简单的Navigation用法Demo,这里先展示一个Fragment,然后在FragmentA中有一个按钮,点击进入FragmentB。我们根据前面所说的几个部分一个个添加进入

1、导入依赖

    def nav_version = "2.3.0"
    implementation "androidx.navigation:navigation-fragment:$nav_version"
    implementation "androidx.navigation:navigation-ui:$nav_version"

2、添加导航图
在res下新建navigation资源文件,并且新建一个nav.xml文件。
并且做好如下配置:


<?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"
    app:startDestination="@id/fmt_a"
    android:id="@+id/nav">

    <fragment
        android:id="@+id/fmt_a"
        android:name="com.mg.axechen.libnavigation.fragment.FragmentA"
        app:layout="@layout/fragment_a"
        android:label="FramentA" >

        <action android:id="@+id/action_fmta_to_fmtb"
            app:destination="@id/fmt_b"
            app:enterAnim="@anim/nav_default_enter_anim"
            app:exitAnim="@anim/nav_default_exit_anim"/>

    </fragment>

    <fragment
        android:id="@+id/fmt_b"
        android:name="com.mg.axechen.libnavigation.fragment.FragmentB"
        app:layout="@layout/fragment_b"
        android:label="FragmentB" />


</navigation>

注意:这里的navigation 一定要添加一个初始的Fragment,app:startDestination="@id/fmt_a" 否则会出现异常:

     Caused by: android.view.InflateException: Binary XML file line #14 in com.mg.axechen.libnavigation:layout/activity_test: Error inflating class fragment
     Caused by: java.lang.IllegalStateException: no start destination defined via app:startDestination for com.mg.axechen.libnavigation:id/nav

这里对里面的这些配置做下说明:

    <fragment
        android:id="@+id/fmt_a"   // 指定Fragment的Id
        android:name="com.mg.axechen.libnavigation.fragment.FragmentA" // 指定是哪个Fragment
        app:layout="@layout/fragment_a" // 指定Fragment的资源文件
        android:label="FramentA" >

        <action android:id="@+id/action_fmta_to_fmtb" // action的id
            app:destination="@id/fmt_b" // 目标Fragment的id,这里指跳转
            app:enterAnim="@anim/nav_default_enter_anim"  // 默认进入动画
            app:exitAnim="@anim/nav_default_exit_anim"/> // 默认退出动画

这里面也可以配置Activity用法和Fragment一致。

3、添加NavHost

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_height="match_parent">

    <fragment
        android:id="@+id/fmt_test"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:name="androidx.navigation.fragment.NavHostFragment"
        app:navGraph="@navigation/nav"
        app:defaultNavHost="true"
        />

</FrameLayout>

这里有几个参数:

        android:name="androidx.navigation.fragment.NavHostFragment"
        app:navGraph="@navigation/nav"
        app:defaultNavHost="true"

第一个是name,目前默认要指定NavHostFragment。
第二个是指定导航图,这里指定navigation下的nav资源文件。
第三个参数会导致Fragment的回退栈发生变化。这里后面细说。

4、添加NavController

public class TestActivity extends AppCompatActivity {

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

    private void initNavigation() {
        NavController navController = Navigation.findNavController(this, R.id.fmt_test);
    }
}

这样一来,当启动Test Activity时,TestActivity就会通过NavController显示FragmentA了。
FragmentA也可以通过NavControl去跳转到FragmentB。

public class FragmentA extends Fragment {

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

        Button test = view.findViewById(R.id.test);
        test.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Navigation.findNavController(view).navigate(R.id.action_fmta_to_fmtb);
            }
        });

        return view;
    }
}

3、和BottomNavigationView联用

这也是一个常用的用法,BottomNavigationView的使用方法这里就不多做说明了,如果需要和BottonNavigationView联用,还需要NavController做好绑定关系。
创建BottomNavigationView的menu时,需要将menu的id和在导航图配置的id一致:
比如:

<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- item的id必须和navigation中的资源id一致 -->
    <item android:id="@+id/fmt_a"
        android:icon="@mipmap/index"
        android:title="首页"></item>

    <item android:id="@+id/fmt_b"
        android:icon="@mipmap/cate"
        android:title="列表"></item>

    <item android:id="@+id/fmt_c"
        android:icon="@mipmap/cart"
        android:title="购物车"></item>

    <item android:id="@+id/fmt_d"
        android:icon="@mipmap/me"
        android:title="我的"></item>
</menu>

导航图:

    <!-- 资源 -->
    <fragment
        android:id="@+id/fmt_a"
        android:name="com.mg.axechen.libnavigation.fragment.FragmentA"
        tools:layout="@layout/fragment_a"
        android:label="FramentA" >

        <!--  action_now_to_target -->
        <action android:id="@+id/action_fmta_to_fmtb"
            app:destination="@id/fmt_b"
            app:enterAnim="@anim/nav_default_enter_anim"
            app:exitAnim="@anim/nav_default_exit_anim"/>

    </fragment>

    <fragment
        android:id="@+id/fmt_b"
        android:name="com.mg.axechen.libnavigation.fragment.FragmentB"
        tools:layout="@layout/fragment_b"
        android:label="FragmentB" />

    <fragment
        android:id="@+id/fmt_c"
        android:name="com.mg.axechen.libnavigation.fragment.FragmentC"
        tools:layout="@layout/fragment_c"
        android:label="FragmentC" />

    <fragment
        android:id="@+id/fmt_d"
        android:name="com.mg.axechen.libnavigation.fragment.FragmentD"
        tools:layout="@layout/fragment_d"
        android:label="FragmentD" />
    private void initNavigation() {
        NavController navController = Navigation.findNavController(this, R.id.fmt_main);
        navController.navigate(R.id.fmt_d);

        bottomNavigationView = findViewById(R.id.btn_navigation_view);

        NavigationUI.setupWithNavController(bottomNavigationView, navController);
    }

这样就可以通过BottonNavigationView去控制Fragment的显示了。

4、defaultNavHost的使用

如果这个为true,则会将返回键交给Navigation进行管理,会覆盖Activity的回退事件,这样每次回退都会从栈中拿出上一个保存Fragment。

如果为false则不会覆盖Activity的回退事件。

这个属性可以在不同的场景中使用,假如使用BottonNavigationView+Navigation这种方式做主页,如果点击返回需要回到桌面,那可以将这个属性设置成false。

5、支持DeepLink

DeepLink实际上就是通过一种约定好的Url的方式直接定位的页面。


    <!-- 资源 -->
    <fragment
        android:id="@+id/fmt_a"
        android:name="com.mg.axechen.libnavigation.fragment.FragmentA"
        tools:layout="@layout/fragment_a"
        android:label="FramentA" >


        <deepLink app:uri="http://www.axechen.com/{params}"></deepLink>


    </fragment>

直接在fragment中配置deepLink即可,然后通过访问这个url即可直接打开这个Fragment。

6、传递参数

传递参数是通过Bundle来传递的,在接收的时候也是
Fragment通过getArguments()来接收。Activity通过Intent来接收

传参:

 Bundle bundle = new Bundle();
 bundle.putString("name","参数");

   Navigation.findNavController(getView())
                    .navigate(R.id.action_fmta_to_activity_demo,bundle);

Activity:

  String name = getIntent().getStringExtra("name");

Fragment:

 String params = getArguments().getString("name");

7、过渡动画

前面的配置中实际上已经配置了过渡动画了。动画配置在Action中。

   <action android:id="@+id/action_fmta_to_fmtb"
            app:destination="@id/fmt_b"
            app:enterAnim="@anim/nav_default_enter_anim"
            app:exitAnim="@anim/nav_default_exit_anim"/>

enterAnim和exitAnim就是过渡动画了。

以上就是Navigation的基本用法了,实际使用起来是非常简单的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,451评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,172评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,782评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,709评论 1 294
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,733评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,578评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,320评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,241评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,686评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,878评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,992评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,715评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,336评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,912评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,040评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,173评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,947评论 2 355

推荐阅读更多精彩内容