React Native WebView 中 Android 文件上传 `capture` 属性失效问题解析

问题现象

在使用 React Native WebView 组件时，开发人员发现当在 Android 设备上使用带有 capture 属性的文件上传输入框时，点击"选择文件"按钮后没有任何反应。控制台会显示错误日志："there is no Activity to handle this Intent"。

问题分析

这个问题的核心在于 Android 系统的 Intent 解析机制。当 WebView 中的 <input type="file" accept="image/*" capture="environment" /> 被点击时，系统需要启动一个能够处理图像捕获的 Activity。但在某些 Android 版本（特别是 Android 11 和 13 的模拟器及部分设备）上，系统无法正确解析这个 Intent。

解决方案

经过社区探索，发现有以下两种解决方案：

1. 修改 AndroidManifest.xml 文件
   在应用的 AndroidManifest.xml 文件中添加以下查询声明：

<queries>
    <intent>
        <action android:name="android.media.action.IMAGE_CAPTURE" />
    </intent>
</queries>

这个解决方案利用了 Android 11 引入的包可见性机制，明确声明应用需要查询能够处理图像捕获 Intent 的 Activity。

2. 修改 WebView 模块代码
   另一种方案是修改 React Native WebView 的 Java 代码，移除对 Activity 解析的检查。不过这种方法需要修改库的源代码，可能会影响其他功能，因此不是推荐的首选方案。

技术背景

Android 11 引入了更严格的包可见性限制，要求应用必须明确声明它们需要访问哪些其他应用的信息。对于 WebView 中的文件上传功能，当使用 capture 属性时，系统需要启动相机应用，但如果没有在清单文件中声明相应的查询，系统就无法找到合适的 Activity 来处理这个请求。

最佳实践建议

1. 对于使用 React Native WebView 的开发人员，建议优先采用修改 AndroidManifest.xml 的方案，这是最规范且影响最小的解决方案。

2. 如果需要在多种 Android 版本上保持兼容性，可以考虑同时实现传统的文件选择器和带有 capture 属性的方案，通过条件判断来提供最佳用户体验。

3. 在测试时，应当覆盖多种 Android 设备和版本，特别是不同厂商的设备，因为它们的相机应用实现可能有所不同。

总结

React Native WebView 在 Android 平台上处理带有 capture 属性的文件上传时遇到的问题，本质上是 Android 系统权限和包可见性机制变化带来的兼容性挑战。通过正确配置应用的清单文件，可以确保 WebView 能够正常调用设备相机功能，提供完整的文件上传体验。