Ionic(Angular)应用上架Google Play仅2700款设备兼容，如何排查解决？

这类同框架同类型应用兼容数差数倍的问题，在Ionic/Cordova生态里非常普遍，核心原因大多是打包阶段的自动配置合并机制，导致你看到的手写配置和最终上架包的实际生效配置完全不一致，具体可以按以下顺序排查：

从官方渠道先拿准确的不兼容原因，不要盲猜 #

• 进入Google Play Console的「设备目录」板块，不要只看兼容设备的总数，直接切换到「不兼容」的筛选维度
• 对占比最高的Top20不兼容机型，逐台查看系统给出的官方不兼容判定理由，常见的理由会直接点明是缺少某类硬件、架构不匹配、系统版本不达标，不需要自己反向推导
• 可以直接对比你兼容数正常的同类型应用在同一设备目录下的判定结果，把两个应用的不兼容原因做差集，就是你要找的配置问题根源

排查打包后实际生效的合并Manifest配置（90%的这类问题出在这里） #

你在项目根目录下手写维护的AndroidManifest.xml不是最终上架的版本，Ionic/Cordova打包时会把所有插件、第三方依赖aar包里的Manifest配置自动合并到最终安装包里，很多强制规则都是悄悄生效的：

• 直接打开打包生成的真实Manifest文件，路径为platforms/android/app/src/main/AndroidManifest.xml（打release包后生成的那份），和正常兼容的Ionic应用的同路径文件做逐行对比
• 重点排查两类隐形配置：
  • 有没有被自动添加required="true"的uses-feature声明：比如摄像头、GPS、蓝牙、麦克风、NFC相关的硬件要求，常见于旧版的Cordova插件，比如旧版相机、扫码、NFC插件会强制要求对应硬件存在，直接把没有对应硬件的设备全部筛除。碰到这类被自动加的强制规则，只需要给对应的uses-feature标签加上android:required="false"，就不会触发兼容拦截
  • 权限触发的隐式硬件要求：哪怕你没写uses-feature，只要Manifest里声明了CAMERA、RECORD_AUDIO、ACCESS_FINE_LOCATION这类和硬件强绑定的权限，Android系统会默认将其判定为强制硬件要求。实际碰到过的案例：某插件自动加了录音权限，因为没标注非强制，系统默认要求麦克风，直接筛掉了近2000台无麦克风的老式平板，和你当前碰到的兼容数规模非常匹配

排查ABI架构与Gradle打包配置的差异 #

这个配置项的影响量级通常在几千到上万台设备之间，是最容易造成兼容数断层的配置：

• 打开Android模块下的app/build.gradle文件，对比两个同类型应用的ndk.abiFilters配置
• 常见的错误场景：当前出问题的项目只配置了arm64-v8a单架构，把所有32位armeabi-v7a架构的老设备、低端设备全部排除了，而正常兼容的应用会同时打包armeabi-v7a、arm64-v8a全量架构
• 另外检查Play App Bundle的配置，是不是误开了「仅为64位设备生成安装包」的选项，导致32位设备收不到兼容的安装包

排查依赖自动抬高的最低SDK版本 #

你在Ionic的config.xml里配置的MinSDK 19不代表最终生效的版本值：

• 打包阶段Gradle合并Manifest时，会自动取所有依赖中声明的最高MinSDK值作为项目的最终生效版本
• 如果某个第三方SDK、插件的aar包里自带了minSdkVersion="21"的声明，哪怕你自己配的是19，最终生效的MinSDK会被自动抬到21，直接筛掉所有Android 4.4、5.0版本的设备，这个调整通常会直接减少近万台的兼容设备规模
• 验证方法：直接看打包后app/build.gradle里自动生成的minSdkVersion实际值，和你自己配置的做对比

排查被遗漏的屏幕与OpenGL配置 #

• 检查supports-screens配置，是不是误加了屏幕尺寸限制，比如只支持大屏/平板尺寸，把普通手机、小屏设备全部排除
• 检查是不是配置了过高的OpenGL ES版本要求，比如强制要求OpenGL ES 3.0以上，把只支持2.0的老设备全部筛除

内容的提问来源于stack exchange，提问作者Julio Cesar