React Native Firebase 在 Expo 项目中解决 Android 构建冲突的技术方案

在 React Native 开发中，使用 React Native Firebase 库与 Expo 项目集成时，Android 平台构建过程中可能会遇到 Manifest 合并冲突的问题。本文将深入分析该问题的成因，并提供完整的解决方案。

问题现象分析

当开发者在 Expo 项目中同时使用 React Native Firebase 的 messaging 模块和 expo-notifications 插件时，Android 构建过程会出现如下错误：

Manifest merger failed : Attribute meta-data#com.google.firebase.messaging.default_notification_color@resource

错误表明两个模块都尝试设置相同的 Android Manifest 属性，导致构建系统无法自动合并这些配置。具体来说，expo-notifications 和 react-native-firebase/messaging 都试图定义通知图标的默认颜色。

问题根源探究

这个问题的本质在于 Android Manifest 合并机制。当多个模块尝试修改同一个 Manifest 属性时，构建系统需要明确的合并策略。在 React Native Firebase 的 messaging 模块中，默认设置了通知颜色为白色（@color/white），而 expo-notifications 插件也尝试设置相同的属性。

React Native Firebase 的 messaging 模块实际上已经包含了处理这种冲突的逻辑，通过添加 tools:replace="android:resource" 属性来声明应该使用自己的配置。然而，在某些 Expo 项目中，这种冲突解决机制未能按预期工作。

解决方案实现

方案一：移除冲突配置

最简单的解决方案是避免在 expo-notifications 插件中设置颜色属性：

[
  "expo-notifications",
  {
    icon: "./assets/iconNotifAndroid.png",
    // 移除 color 配置
  }
]

这种方法虽然简单，但限制了自定义通知颜色的能力。

方案二：自定义 Expo 配置插件

更完整的解决方案是创建一个自定义的 Expo 配置插件，确保正确设置 tools:replace 属性：

const { withAndroidManifest } = require('@expo/config-plugins');

module.exports = function withNotificationToolsReplace(config) {
  return withAndroidManifest(config, (config) => {
    const androidManifest = config.modResults;

    if (!androidManifest.manifest.$['xmlns:tools']) {
      androidManifest.manifest.$['xmlns:tools'] = 'http://schemas.android.com/tools';
    }

    const application = androidManifest.manifest.application[0];
    application['meta-data'] ??= [];

    const metaData = application['meta-data'].find(
      (item) =>
        item['$']['android:name'] ===
        'com.google.firebase.messaging.default_notification_color'
    );

    if (metaData) {
      metaData['$']['tools:replace'] = 'android:resource';
    } else {
      application['meta-data'].push({
        $: {
          'android:name': 'com.google.firebase.messaging.default_notification_color',
          'android:resource': '@color/notification_icon_color',
          'tools:replace': 'android:resource',
        },
      });
    }

    return config;
  });
};

这个插件会：

1. 确保 tools 命名空间存在于 Manifest 中
2. 查找或创建相关的 meta-data 元素
3. 明确设置 tools:replace 属性来声明合并策略

方案三：升级依赖版本

在某些情况下，升级 React Native Firebase 相关依赖到最新版本可以解决问题：

"@react-native-firebase/messaging": "^21.0",
"@react-native-firebase/app": "^21.0"

最佳实践建议

1. 版本一致性：确保所有 React Native Firebase 模块使用相同的主要版本
2. 配置优先级：明确哪个模块应该控制通知颜色设置
3. 测试验证：在修改配置后，务必进行完整的构建测试
4. 长期维护：考虑向 React Native Firebase 项目提交 PR，修复插件中的问题

技术原理深入

Android Manifest 合并是构建过程中的关键步骤，它允许不同模块贡献自己的配置。tools:replace 属性是 Android 提供的一种显式合并策略，它告诉构建系统当冲突发生时应该使用哪个配置。

在 React Native 生态中，这种冲突特别常见，因为多个库可能都需要修改相同的 Manifest 属性。理解并正确应用这些合并策略对于构建稳定的跨平台应用至关重要。

通过本文提供的解决方案，开发者可以有效地解决 React Native Firebase 在 Expo 项目中的构建冲突问题，同时保持对通知系统的完整控制能力。