React Native WebRTC 在 Android 14 上的屏幕共享崩溃问题解析

问题背景

在 React Native WebRTC 项目中，开发者报告了一个关于屏幕共享功能的兼容性问题：在 Android 14 设备上，当尝试进行屏幕共享时，应用程序会崩溃，而这个问题在 Android 13 及以下版本中并不存在。

问题表现

当开发者在 Android 14 设备上启动屏幕共享功能时，应用程序会突然终止运行，没有任何明显的错误提示。通过检查日志可以发现，系统抛出了一个安全异常，指出缺少必要的权限配置。

根本原因分析

经过深入调查，这个问题主要与 Android 14 引入的更严格的前台服务权限控制有关。具体来说，错误日志显示：

java.lang.SecurityException: Starting FGS with type mediaProjection requires permissions: 
all of the permissions allOf=true [android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION] 
any of the permissions allOf=false [android.permission.CAPTURE_VIDEO_OUTPUT, android:project_media]

这表明应用程序尝试启动一个类型为 mediaProjection 的前台服务，但缺少必要的权限声明。

解决方案

要解决这个问题，需要在 AndroidManifest.xml 文件中进行以下配置：

1. 确保声明了所有必要的权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
<uses-permission android:name="android.permission.CAPTURE_VIDEO_OUTPUT" />

2. 正确配置前台服务：

<service
    android:name="com.oney.WebRTCModule.WebRTCScreenSharingService"
    android:foregroundServiceType="mediaProjection"
    android:exported="false" />

注意事项

1. 确保使用的是 React Native WebRTC 提供的 WebRTCScreenSharingService，而不是其他库的前台服务。

2. 对于 Android 14，必须明确声明 foregroundServiceType 为 "mediaProjection"。

3. 所有相关权限必须在 Manifest 中声明，包括 FOREGROUND_SERVICE 和 FOREGROUND_SERVICE_MEDIA_PROJECTION。

最佳实践

1. 始终在 Manifest 中声明所有需要的权限，即使它们在较低版本的 Android 上不是强制的。

2. 定期检查 Android 新版本的权限变更，特别是与前台服务相关的变更。

3. 在实现屏幕共享功能时，确保测试覆盖所有目标 Android 版本。

4. 考虑添加适当的错误处理逻辑，以便在权限不足时向用户提供友好的提示，而不是直接崩溃。

总结

Android 14 引入了更严格的前台服务权限控制，这影响了 React Native WebRTC 的屏幕共享功能。通过正确配置 Manifest 文件中的权限和服务声明，可以解决这个问题。开发者应该注意 Android 新版本的安全特性变化，并及时调整应用配置以确保兼容性。