Expo项目升级至52版本后Android设备兼容性问题解决方案

问题背景

在Expo项目从50版本升级到52版本后，开发团队遇到了一个棘手的兼容性问题：部分Android设备用户在Google Play商店中无法更新应用，系统提示"应用与设备不兼容"。值得注意的是，这些出现问题的设备都运行Android 10及以上系统，理论上完全满足Expo 52的最低SDK版本要求(API级别24)。

问题排查过程

经过深入分析，发现以下几个关键现象：

1. 所有出现兼容性问题的设备都有一个共同特点：没有配备摄像头硬件
2. 即使尝试了设备恢复出厂设置，问题依然存在
3. 在AndroidManifest.xml中明确设置了相机权限为非必需(android:required="false")，但问题仍未解决

通过对比新旧版本的AndroidManifest.xml文件，发现了一个重要差异：在旧版本中存在但新版本中缺失了两个关键声明：

<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-feature android:name="android.hardware.camera.autofocus" android:required="false" />

问题根源

在Android生态系统中，Google Play商店会根据应用的manifest文件中的uses-feature声明来判断应用与设备的兼容性。即使应用代码中正确处理了硬件缺失的情况，如果manifest中没有明确声明某些硬件特性是非必需的，Play商店仍可能阻止应用安装。

在Expo 52版本中，似乎移除了对相机特性的显式声明，导致没有摄像头的设备被错误地排除在兼容设备列表之外。

解决方案

开发团队最终通过创建一个Expo配置插件(Config Plugin)来解决这个问题。该插件主要做了两件事：

1. 确保相机权限被明确标记为非必需
2. 重新添加相机和自动对焦特性的声明，并明确标记为非必需

以下是完整的配置插件代码：

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

const CAMERA_FEATURE = 'android.hardware.camera';
const CAMERA_AUTOFOCUS_FEATURE = 'android.hardware.camera.autofocus';

module.exports = function unrequireCamera(config) {
  return withAndroidManifest(config, async (c) => {
    // 设置相机权限为非必需
    c.modResults.manifest['uses-permission'] = 
      c.modResults.manifest['uses-permission'].map((perm) => {
        if (perm.$['android:name'] === 'android.permission.CAMERA') {
          perm.$['android:required'] = 'false';
        }
        return perm;
      });

    // 确保相机特性声明存在且标记为非必需
    c.modResults.manifest['uses-feature'] = 
      (c.modResults.manifest['uses-feature'] || [])
        .filter(
          (f) =>
            f.$['android:name'] !== CAMERA_FEATURE &&
            f.$['android:name'] !== CAMERA_AUTOFOCUS_FEATURE
        )
        .concat([
          { $: { 'android:name': CAMERA_FEATURE, 'android:required': 'false' } },
          { $: { 'android:name': CAMERA_AUTOFOCUS_FEATURE, 'android:required': 'false' } },
        ]);

    return c;
  });
};

实施步骤

1. 将上述代码保存为项目中的一个JavaScript文件(如unrequireCamera.js)
2. 在项目的app.config.js或app.json文件中，将该插件添加到plugins数组中
3. 重新构建并发布应用

经验总结

1. 版本升级需谨慎：即使是小版本升级，也可能引入意想不到的兼容性问题
2. 全面测试很重要：不仅要在有完整硬件的设备上测试，也要在功能受限的设备上验证
3. 理解Play商店的过滤机制：了解Google Play如何根据manifest文件过滤设备对于确保应用覆盖范围至关重要
4. 配置插件是强大工具：Expo的配置插件系统允许开发者精细控制构建过程，解决各种平台特定的问题

这个问题也提醒我们，在移动开发中，硬件多样性是一个必须考虑的重要因素，特别是在Android生态系统中。通过适当的manifest配置，可以确保应用能够覆盖尽可能多的设备，同时正确处理硬件缺失的情况。