React Native Firebase与Expo Notifications的Android构建冲突解决方案

在React Native开发中，当同时使用React Native Firebase和Expo Notifications时，开发者可能会遇到Android构建失败的问题。本文将深入分析这一问题的根源，并提供多种解决方案。

问题现象

在构建Android应用时，Gradle会报错显示Manifest合并失败，具体错误信息指出com.google.firebase.messaging.default_notification_color属性在两个不同的AndroidManifest.xml文件中被定义，且值不同。一个来自项目本身的配置(@color/notification_icon_color)，另一个来自React Native Firebase消息模块(@color/white)。

问题根源

这个冲突的根本原因在于两个库都试图定义Firebase通知的默认颜色：

1. Expo Notifications：从0.28.0版本开始，自动在AndroidManifest.xml中添加了Firebase通知颜色配置
2. React Native Firebase Messaging：同样在它的AndroidManifest.xml中定义了默认通知颜色

当两个库的配置同时存在时，Android构建系统无法确定应该使用哪个值，从而导致构建失败。

解决方案

方案一：降级Expo Notifications版本

将expo-notifications降级到0.27.x或更早版本可以避免此问题，因为这些版本不会自动添加Firebase通知颜色配置。

"expo-notifications": "0.27.0"

方案二：修改AndroidManifest.xml

1. 运行npx expo prebuild生成Android项目文件
2. 修改android/app/src/main/AndroidManifest.xml：
   • 在manifest标签中添加tools命名空间
   • 在meta-data标签中添加tools:replace属性

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
          xmlns:tools="http://schemas.android.com/tools">

<-- 其他配置 -->

<meta-data 
    android:name="com.google.firebase.messaging.default_notification_color" 
    android:resource="@color/notification_icon_color" 
    tools:replace="android:resource"/>

方案三：使用patch-package修改React Native Firebase

创建一个补丁文件，移除React Native Firebase Messaging中的相关配置：

diff --git a/node_modules/@react-native-firebase/messaging/android/src/main/AndroidManifest.xml b/node_modules/@react-native-firebase/messaging/android/src/main/AndroidManifest.xml
index 2f6741b..ff2504b 100644
--- a/node_modules/@react-native-firebase/messaging/android/src/main/AndroidManifest.xml
+++ b/node_modules/@react-native-firebase/messaging/android/src/main/AndroidManifest.xml
@@ -27,11 +27,5 @@
     <meta-data
       android:name="firebase_messaging_auto_init_enabled"
       android:value="${firebaseJsonAutoInitEnabled}"/>
-    <meta-data
-      android:name="com.google.firebase.messaging.default_notification_channel_id"
-      android:value="${firebaseJsonNotificationChannelId}" />
-    <meta-data
-      android:name="com.google.firebase.messaging.default_notification_color"
-      android:resource="${firebaseJsonNotificationColor}" />
   </application>
 </manifest>

最佳实践建议

1. Expo项目：推荐使用方案一或方案二，因为它们更符合Expo的工作流程
2. 纯React Native项目：可以考虑方案三，但需要维护patch文件
3. 持续集成环境：如果使用EAS构建，需要确保修改后的配置在构建过程中被正确应用

总结

这个构建冲突问题展示了在混合使用不同通知库时可能遇到的配置冲突。理解Android Manifest合并机制对于解决这类问题至关重要。开发者应根据项目具体情况选择最适合的解决方案，并在升级相关依赖时注意潜在的兼容性问题。