求助：Android Java项目迁移至Navigation Rail的实现教程

1. 确认依赖配置 #

首先确保你的Module级build.gradle中包含Navigation组件和Material Design的依赖：

dependencies {
    // Navigation组件
    implementation "androidx.navigation:navigation-fragment:2.7.6"
    implementation "androidx.navigation:navigation-ui:2.7.6"
    // Material Design（Navigation Rail属于该库）
    implementation "com.google.android.material:material:1.11.0"
}

同步项目后，这些依赖会自动下载。

2. 改造主布局文件 #

将原来包含DrawerLayout的主布局，替换为带有NavigationRailView的布局（推荐用ConstraintLayout作为根布局）。示例activity_main.xml：

<?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"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 导航宿主，用于承载各个Fragment -->
    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/nav_host_fragment"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:defaultNavHost="true"
        app:navGraph="@navigation/nav_graph" />

    <!-- 侧边导航栏（Navigation Rail） -->
    <com.google.android.material.navigationrail.NavigationRailView
        android:id="@+id/navigation_rail"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_gravity="start"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:menu="@menu/navigation_rail_menu" />

</androidx.constraintlayout.widget.ConstraintLayout>

如果需要将Navigation Rail放在右侧，把layout_gravity改成end即可。

3. 创建导航菜单和导航图 #

• 首先在res/menu下创建navigation_rail_menu.xml，定义导航项：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/homeFragment"
        android:icon="@drawable/ic_home"
        android:title="首页" />
    <item
        android:id="@id/settingsFragment"
        android:icon="@drawable/ic_settings"
        android:title="设置" />
    <item
        android:id="@id/profileFragment"
        android:icon="@drawable/ic_profile"
        android:title="我的" />
</menu>

• 然后在res/navigation下创建nav_graph.xml，关联各个Fragment目的地：

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

    <fragment
        android:id="@+id/homeFragment"
        android:name="com.yourpackage.HomeFragment"
        android:label="首页" />

    <fragment
        android:id="@+id/settingsFragment"
        android:name="com.yourpackage.SettingsFragment"
        android:label="设置" />

    <fragment
        android:id="@+id/profileFragment"
        android:name="com.yourpackage.ProfileFragment"
        android:label="我的" />

</navigation>

4. 在MainActivity中绑定导航逻辑 #

打开你的MainActivity.java，移除原来和Drawer相关的代码（比如ActionBarDrawerToggle），添加Navigation Rail的绑定逻辑：

import androidx.appcompat.app.AppCompatActivity;
import androidx.navigation.NavController;
import androidx.navigation.fragment.NavHostFragment;
import androidx.navigation.ui.NavigationUI;

import com.google.android.material.navigationrail.NavigationRailView;

public class MainActivity extends AppCompatActivity {

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

        // 获取导航控制器
        NavHostFragment navHostFragment = (NavHostFragment) getSupportFragmentManager()
                .findFragmentById(R.id.nav_host_fragment);
        NavController navController = navHostFragment.getNavController();

        // 获取Navigation Rail并绑定导航控制器
        NavigationRailView navigationRailView = findViewById(R.id.navigation_rail);
        NavigationUI.setupWithNavController(navigationRailView, navController);

        // 可选：自定义导航项选中事件（如果需要额外逻辑）
        navigationRailView.setOnItemSelectedListener(item -> {
            switch (item.getItemId()) {
                case R.id.homeFragment:
                    navController.navigate(R.id.homeFragment);
                    return true;
                case R.id.settingsFragment:
                    navController.navigate(R.id.settingsFragment);
                    return true;
                case R.id.profileFragment:
                    navController.navigate(R.id.profileFragment);
                    return true;
                default:
                    return false;
            }
        });
    }
}

NavigationUI.setupWithNavController会自动处理导航项选中与Fragment切换的关联，如果你不需要额外逻辑，可以不用手动设置setOnItemSelectedListener。

5. 清理遗留代码 #

删除所有和Drawer相关的代码：比如DrawerLayout对象、ActionBarDrawerToggle的初始化与绑定、菜单中打开抽屉的逻辑等。如果原来的ActionBar有汉堡按钮，记得在onCreateOptionsMenu中移除相关按钮，或者隐藏ActionBar（使用Toolbar时同理）。

6. 适配屏幕尺寸（可选） #

如果你的应用需要适配平板等大屏设备，可以通过限定符布局实现：在res/layout-sw600dp下保留原来的Drawer布局，小屏设备使用Navigation Rail。Java代码中无需额外处理，系统会自动加载对应布局。

内容的提问来源于stack exchange，提问作者Simon