React Native Video 项目中 Android Manifest 重复 Service 标签问题分析

在 React Native Video 项目中使用 Expo 预构建功能时，开发人员可能会遇到一个关于 Android Manifest 文件重复生成 Service 标签的问题。这个问题主要影响使用 Expo 预构建流程并启用了通知控制功能的 Android 平台项目。

问题现象

当开发者在 app.json 配置文件中启用了 react-native-video 插件的通知控制功能后，每次执行 expo prebuild 命令时，系统都会在 AndroidManifest.xml 文件中重复添加相同的 Service 标签。具体表现为：

<service android:name="com.brentvatne.exoplayer.VideoPlaybackService" 
         android:exported="false" 
         android:foregroundServiceType="mediaPlayback">
  <intent-filter>
    <action android:name="androidx.media3.session.MediaSessionService"/>
  </intent-filter>
</service>

每次执行预构建命令，这个 Service 标签就会被重复添加一次，导致 Manifest 文件中出现多个完全相同的 Service 定义。

问题根源

经过分析，这个问题源于 Expo 配置插件 withNotificationControls.ts 中的实现逻辑。该插件在向 AndroidManifest.xml 添加 Service 时，没有先检查是否已经存在相同的 Service 定义，而是直接向 application.service 数组推送新的 Service 配置。

核心问题代码如下：

manifest.application.map((application) => {
  if (!application.service) {
    application.service = [];
  }

  application.service.push({
    $: {
      'android:name': 'com.brentvatne.exoplayer.VideoPlaybackService',
      'android:exported': 'false',
      'android:foregroundServiceType': 'mediaPlayback',
    },
    'intent-filter': [
      {
        action: [
          {
            $: {
              'android:name': 'androidx.media3.session.MediaSessionService',
            },
          },
        ],
      },
    ],
  });

  return application;
});

技术影响

这种重复添加 Service 标签的行为虽然不会直接导致应用崩溃，但会带来几个潜在问题：

1. Manifest 文件会随着每次预构建而不断增大
2. 可能影响 Android 系统对 Service 的管理
3. 在极端情况下可能导致资源浪费或性能问题

解决方案

修复这个问题的正确做法是在添加 Service 前先检查是否已经存在相同的定义。可以通过以下方式实现：

1. 检查 application.service 数组是否已经包含相同 android:name 的 Service
2. 如果存在则跳过添加，否则才添加新的 Service 定义

这种检查可以确保 Service 只被添加一次，避免重复问题。

最佳实践建议

对于使用 Expo 预构建功能的开发者，建议：

1. 定期检查生成的 AndroidManifest.xml 文件
2. 在升级 react-native-video 版本后，清理并重新预构建项目
3. 如果发现重复的 Service 标签，可以手动删除多余的条目

这个问题已经被项目维护者确认并修复，开发者可以通过更新到最新版本来解决。理解这类问题的根源有助于开发者在遇到类似 Manifest 修改问题时能够快速定位和解决。