Android语言基础教程（93）Android基本程序单元Activity Fragment之在Activity中添加Fragment：Activity的“神助攻”！Fragment这样用，让你的A

原创于 2025-11-08 14:35:55 发布 · 258 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#android

Android基础教程专栏收录该内容

256 篇文章

订阅专栏

嘿，各位Android开发的小伙伴们！今天咱们来聊一个超级实用的话题——如何在Activity里“塞”进去一个Fragment。别一听“Fragment”就头大，觉得它是什么高深莫测的东西。其实它就像Activity的“神助攻”，能让你的应用界面变得更灵活、更强大，而且用对了简直爽到飞起！

想象一下：你正在开发一个音乐App，在手机上，播放列表和播放器界面可能是两个独立的页面；但在平板上，为了充分利用大屏幕，你希望这两个界面能同时显示。如果只用Activity，你可能得写两套布局，代码重复到怀疑人生。但有了Fragment，一切就简单多了——你可以把播放列表和播放器做成两个独立的Fragment，像拼乐高一样在Activity里自由组合。是不是瞬间感觉开发效率爆棚？

一、Activity和Fragment：到底是啥关系？

先来个快速科普！Activity可以理解成应用的“大舞台”，负责管理一整个屏幕的界面和用户交互。而Fragment则是舞台上的“模块化道具”，比如一个按钮组、一个列表或者一个对话框。它必须“依附”在Activity上才能存活，但好处是：一个Activity可以塞进多个Fragment，而且这些Fragment能动态替换、复用，甚至跨设备适配！

为什么非要用Fragment？举个例子：如果你的App需要适配手机和平板，用Fragment可以轻松实现“手机单页显示，平板多栏布局”。再比如，你想在界面里动态切换内容（比如点Tab切换页面），用Fragment比不停跳转Activity流畅多了，还省资源。

二、手把手实战：在Activity里添加Fragment

理论说再多不如直接上代码！接下来，我会用一个美食App的示例来演示：在MainActivity中动态添加一个显示菜品列表的MenuListFragment。

步骤1：定义Fragment的布局文件（fragment_menu_list.xml）
首先，给Fragment设计一个“脸”——也就是它的布局。这里我们简单放一个TextView和Button：

<!-- 在res/layout/fragment_menu_list.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <TextView
        android:id="@+id/titleText"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="今日特色菜：红烧Fragment！"
        android:textSize="18sp" />

    <Button
        android:id="@+id/detailsButton"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="10dp"
        android:text="查看详情" />

</LinearLayout>

步骤2：创建Fragment类（MenuListFragment.java）
接下来，写Fragment的“灵魂”——Java类。这里的关键是重写onCreateView方法，把布局“吹胀”成界面：

public class MenuListFragment extends Fragment {
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        // 用LayoutInflater把XML布局转换成View对象
        View view = inflater.inflate(R.layout.fragment_menu_list, container, false);
        
        // 找控件，设置点击事件
        Button detailsButton = view.findViewById(R.id.detailsButton);
        detailsButton.setOnClickListener(v -> {
            // 点击按钮后，触发和Activity的通信（后面会讲）
            if (getActivity() instanceof MainActivity) {
                ((MainActivity) getActivity).showDetails("红烧Fragment：入口即化，代码味十足！");
            }
        });
        
        return view;
    }
}

注意：inflate方法的第三个参数要设成false，因为系统会自动把布局添加到container里，咱别瞎帮忙！

步骤3：在Activity的布局里给Fragment留“坑位”（activity_main.xml）
现在回到Activity的布局，我们需要一个容器（比如FrameLayout）作为Fragment的“家”：

<!-- res/layout/activity_main.xml -->
<FrameLayout
    android:id="@+id/fragmentContainer"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

步骤4：在Activity中动态添加Fragment（MainActivity.java）
重头戏来了！在Activity里通过FragmentManager和Transaction，把Fragment塞进容器：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 检查是否已存在Fragment（防止旋转屏幕时重复添加）
        if (savedInstanceState == null) {
            // 获取FragmentManager，开始一个事务
            FragmentManager fragmentManager = getSupportFragmentManager();
            FragmentTransaction transaction = fragmentManager.beginTransaction();
            
            // 创建Fragment实例，并替换到容器中
            MenuListFragment menuFragment = new MenuListFragment();
            transaction.replace(R.id.fragmentContainer, menuFragment);
            
            // 提交事务！别忘了这步，否则白干
            transaction.commit();
        }
    }

    // Fragment通信方法：显示详情
    public void showDetails(String message) {
        Toast.makeText(this, message, Toast.LENGTH_SHORT).show();
    }
}

搞定！运行App，你会看到Activity里成功显示了MenuListFragment的界面。点击按钮还会弹出Toast——这说明Fragment和Activity已经顺利“搭上话”了！

三、进阶技巧：让Activity和Fragment“说上话”

Fragment和Activity之间经常需要“通信”（比如点击Fragment的按钮，触发Activity的逻辑）。这里推荐用接口回调的方式，避免直接引用对方，降低耦合度。

比如，我们在Fragment里定义一个接口：

public class MenuListFragment extends Fragment {
    // 定义通信接口
    public interface OnMenuItemClickListener {
        void onItemClick(String itemName);
    }
    
    private OnMenuItemClickListener listener;
    
    // 在Attach时把Activity转为监听器
    @Override
    public void onAttach(Context context) {
        super.onAttach(context);
        if (context instanceof OnMenuItemClickListener) {
            listener = (OnMenuItemClickListener) context;
        }
    }
    
    // 点击按钮时回调接口方法
    detailsButton.setOnClickListener(v -> {
        if (listener != null) {
            listener.onItemClick("红烧Fragment");
        }
    });
}

然后在Activity中实现这个接口：

public class MainActivity extends AppCompatActivity implements MenuListFragment.OnMenuItemClickListener {
    @Override
    public void onItemClick(String itemName) {
        showDetails("你选择了：" + itemName);
    }
}

这样设计，Fragment就能灵活复用了——任何实现了这个接口的Activity都能接收它的点击事件！

四、避坑指南：新手常犯的3个错误

忘记commit事务：写好了Transaction但没调用commit()，Fragment当然显示不出来！记得检查这步。
重复添加Fragment：在onCreate里加Fragment前，先判断savedInstanceState == null，否则每次旋转屏幕都会多一个Fragment。
直接强转Activity：在Fragment里用(MainActivity) getActivity()前，务必先用instanceof检查类型，避免类型转换异常。