Android Navigation的四大要点你都知道吗？开发者社区

link之家

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

Android Navigation的四大要点你都知道吗？

 1<navigation xmlns:android="http://schemas.android.com/apk/res/android"
 2    xmlns:app="http://schemas.android.com/apk/res-auto"
 3    xmlns:tools="http://schemas.android.com/tools"
 4    android:id="@+id/nav_graph"
 5    app:startDestination="@id/welcome_fragment">
 7    <fragment
 8        android:id="@+id/welcome_fragment"
 9        android:name="com.idisfkj.androidapianalysis.navigation.fragment.WelcomeFragment"
10        android:label="welcome_fragment"
11        tools:layout="@layout/fragment_welcome">
13        <action
14            android:id="@+id/action_go_to_register_page"
15            app:destination="@id/register_fragment" />
17        <action
18            android:id="@+id/action_go_to_order_list_page"
19            app:destination="@id/order_list_fragment"/>
21    </fragment>
23    <fragment
24        android:id="@+id/register_fragment"
25        android:name="com.idisfkj.androidapianalysis.navigation.fragment.RegisterFragment"
26        android:label="register_fragment"
27        tools:layout="@layout/fragment_register">
29        <action
30            android:id="@+id/action_go_to_shop_list_page"
31            app:destination="@id/shop_list_fragment" />
33    </fragment>
35    ...
36</navigation>

 1<?xml version="1.0" encoding="utf-8"?>
 2<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
 3    xmlns:app="http://schemas.android.com/apk/res-auto"
 4    xmlns:tools="http://schemas.android.com/tools"
 5    android:layout_width="match_parent"
 6    android:layout_height="match_parent"
 7    android:background="@android:color/background_light"
 8    android:orientation="vertical"
 9    tools:context=".navigation.NavigationMainActivity">
11    <fragment
12        android:id="@+id/nav_host_fragment"
13        android:name="androidx.navigation.fragment.NavHostFragment"
14        android:layout_width="match_parent"
15        android:layout_height="match_parent"
16        app:defaultNavHost="true"
17        app:navGraph="@navigation/nav_graph" />
19</LinearLayout>

1class WelcomeFragment : Fragment() {
3    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
4        return inflater.inflate(R.layout.fragment_welcome, container, false).apply {
5            register_bt.setOnClickListener(Navigation.createNavigateOnClickListener(R.id.action_go_to_register_page))
6            stroll_bt.setOnClickListener(Navigation.createNavigateOnClickListener(R.id.action_go_to_order_list_page))
7        }
8    }
9}

 1    @Override
 2    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
 3        super.onViewCreated(view, savedInstanceState);
 4        if (!(view instanceof ViewGroup)) {
 5            throw new IllegalStateException("created host view " + view + " is not a ViewGroup");
 6        }
 7        Navigation.setViewNavController(view, mNavController);
 8        // When added programmatically, we need to set the NavController on the parent - i.e.,
 9        // the View that has the ID matching this NavHostFragment.
10        if (view.getParent() != null) {
11            View rootView = (View) view.getParent();
12            if (rootView.getId() == getId()) {
13                Navigation.setViewNavController(rootView, mNavController);
14            }
15        }
16    }

 1    -------------- NavController ------------------
 3    private void navigate(@NonNull NavDestination node, @Nullable Bundle args,
 4            @Nullable NavOptions navOptions, @Nullable Navigator.Extras navigatorExtras) {
 5        boolean popped = false;
 6        if (navOptions != null) {
 7            if (navOptions.getPopUpTo() != -1) {
 8                popped = popBackStackInternal(navOptions.getPopUpTo(),
 9                        navOptions.isPopUpToInclusive());
10            }
11        }
12        Navigator<NavDestination> navigator = mNavigatorProvider.getNavigator(
13                node.getNavigatorName());
14        Bundle finalArgs = node.addInDefaultArgs(args);
15        # ---- 关键代码 -------
16        NavDestination newDest = navigator.navigate(node, finalArgs,
17                navOptions, navigatorExtras);
18        ....
19    }
21    -------------- FragmentNavigator ------------------
23    public NavDestination navigate(@NonNull Destination destination, @Nullable Bundle args,
24            @Nullable NavOptions navOptions, @Nullable Navigator.Extras navigatorExtras) {
25        if (mFragmentManager.isStateSaved()) {
26            Log.i(TAG, "Ignoring navigate() call: FragmentManager has already"
27                    + " saved its state");
28            return null;
29        }
30        String className = destination.getClassName();
31        if (className.charAt(0) == '.') {
32            className = mContext.getPackageName() + className;
33        }
34        final Fragment frag = instantiateFragment(mContext, mFragmentManager,
35                className, args);
36        frag.setArguments(args);
37        final FragmentTransaction ft = mFragmentManager.beginTransaction();
39        int enterAnim = navOptions != null ? navOptions.getEnterAnim() : -1;
40        int exitAnim = navOptions != null ? navOptions.getExitAnim() : -1;
41        int popEnterAnim = navOptions != null ? navOptions.getPopEnterAnim() : -1;
42        int popExitAnim = navOptions != null ? navOptions.getPopExitAnim() : -1;
43        if (enterAnim != -1 || exitAnim != -1 || popEnterAnim != -1 || popExitAnim != -1) {
44            enterAnim = enterAnim != -1 ? enterAnim : 0;
45            exitAnim = exitAnim != -1 ? exitAnim : 0;
46            popEnterAnim = popEnterAnim != -1 ? popEnterAnim : 0;
47            popExitAnim = popExitAnim != -1 ? popExitAnim : 0;
48            ft.setCustomAnimations(enterAnim, exitAnim, popEnterAnim, popExitAnim);
49        }
51        # ------ 关键代码 ------
52        ft.replace(mContainerId, frag);
53        ft.setPrimaryNavigationFragment(frag);
54        ...
55    }

1findNavController().navigate(R.id.action_go_to_shop_detail_page, bundleOf("title" to "I am title"))

1buildscript {
2    repositories {
3        google()
4    }
5    dependencies {
6        def nav_version = "2.1.0"
7        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
8    }
9}

1apply plugin: "androidx.navigation.safeargs.kotlin"

 1    <fragment
 2        android:id="@+id/shop_list_fragment"
 3        android:name="com.idisfkj.androidapianalysis.navigation.fragment.ShopListFragment"
 4        android:label="shop_list_fragment"
 5        tools:layout="@layout/fragment_shop_list">
 7        <action
 8            android:id="@+id/action_go_to_shop_detail_page"
 9            app:destination="@id/shop_detail_fragment">
11            <argument
12                android:name="title"
13                app:argType="string" />
15        </action>
17    </fragment>
19    <fragment
20        android:id="@+id/shop_detail_fragment"
21        android:name="com.idisfkj.androidapianalysis.navigation.fragment.ShopDetailFragment"
22        android:label="shop_detail_fragment"
23        tools:layout="@layout/fragment_shop_detail">
25        <action
26            android:id="@+id/action_go_to_cart_page"
27            app:destination="@id/cart_fragment"
28            app:popUpTo="@id/cart_fragment"
29            app:popUpToInclusive="true" />
31        <argument
32            android:name="title"
33            app:argType="string" />
35    </fragment>

1holder.item.setOnClickListener(Navigation.createNavigateOnClickListener(ShopListFragmentDirections.actionGoToShopDetailPage(shopList[position])))

 1class ShopListFragmentDirections private constructor() {
 2    private data class ActionGoToShopDetailPage(val title: String) : NavDirections {
 3        override fun getActionId(): Int = R.id.action_go_to_shop_detail_page
 5        override fun getArguments(): Bundle {
 6            val result = Bundle()
 7            result.putString("title", this.title)
 8            return result
 9        }
10    }
12    companion object {
13        fun actionGoToShopDetailPage(title: String): NavDirections = ActionGoToShopDetailPage(title)
14    }
15}

 1class ShopDetailFragment : Fragment() {
 3    private val args by navArgs<ShopDetailFragmentArgs>()
 5    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
 6        return inflater.inflate(R.layout.fragment_shop_detail, container, false).apply {
 7            title.text = args.title
 8            add_cart.setOnClickListener(Navigation.createNavigateOnClickListener(ShopDetailFragmentDirections.actionGoToCartPage()))
 9        }
10    }
12}

 1<?xml version="1.0" encoding="utf-8"?>
 2<navigation xmlns:android="http://schemas.android.com/apk/res/android"
 3    xmlns:app="http://schemas.android.com/apk/res-auto"
 4    xmlns:tools="http://schemas.android.com/tools"
 5    android:id="@+id/nav_graph"
 6    app:startDestination="@id/welcome_fragment">
 8    <fragment
 9        android:id="@+id/welcome_fragment"
10        android:name="com.idisfkj.androidapianalysis.navigation.fragment.WelcomeFragment"
11        android:label="welcome_fragment"
12        tools:layout="@layout/fragment_welcome">
14        <action
15            android:id="@+id/action_go_to_register_page"
16            app:destination="@id/register_fragment"
17            app:enterAnim="@anim/slide_in_right"
18            app:exitAnim="@anim/slide_in_left"
19            app:popEnterAnim="@anim/slide_out_left"
20            app:popExitAnim="@anim/slide_out_right" />
22        <action
23            android:id="@+id/action_go_to_order_list_page"
24            app:destination="@id/order_list_fragment"
25            app:enterAnim="@anim/slide_in_right"
26            app:exitAnim="@anim/slide_in_left"
27            app:popEnterAnim="@anim/slide_out_left"
28            app:popExitAnim="@anim/slide_out_right" />
30    </fragment>
31    ...
32</navigation>

 1    <fragment
 2        android:id="@+id/register_fragment"
 3        android:name="com.idisfkj.androidapianalysis.navigation.fragment.RegisterFragment"
 4        android:label="register_fragment"
 5        tools:layout="@layout/fragment_register">
 7        <action
 8            android:id="@+id/action_go_to_shop_list_page"
 9            app:destination="@id/shop_list_fragment"
10            app:enterAnim="@anim/slide_in_right"
11            app:exitAnim="@anim/slide_in_left"
12            app:popEnterAnim="@anim/slide_out_left"
13            app:popExitAnim="@anim/slide_out_right" />
15        <deepLink app:uri="api://register/" />
17    </fragment>

1<deepLink app:uri="api://register/{id}" />

 1    <application
 2        ...
 3        android:theme="@style/AppTheme">
 4        <activity android:name=".navigation.NavigationMainActivity" >
 5            <intent-filter>
 6                <action android:name="android.intent.action.VIEW"/>
 7                <action android:name="android.intent.action.MAIN" />