React Native应用配置minSDK=27、targetSDK=30时无法在Android设备安装

1. Build Tools版本兼容性问题 #

当前配置中buildToolsVersion = "31.0.0"的大版本高于compileSdkVersion = 30，当minSDK≥26时，高版本Build Tools会默认启用Android 12的打包校验规则，与compileSDK 30的配置冲突，生成的APK包结构不符合Android 8.1+的安装要求。

2. 签名方案不达标 #

Android 8.0（API 26）及以上系统要求APK必须启用v2及更高版本的签名方案才能正常安装，minSDK提升至27后，如果项目签名配置仅开启了v1签名，就会触发安装失败。

3. 旧版本应用残留冲突 #

测试设备上如果已经安装过minSDK=21的旧版本APK，新旧版本的签名校验、版本规则不一致时，会导致覆盖安装失败。

4. Native库架构适配问题 #

RN 0.64.1默认打包未配置ABI过滤规则时，minSDK≥23后会自动过滤部分32位架构的so库，若测试设备为32位架构，会因为缺少对应so库无法安装。

• 修正Build Tools版本，与compileSDK大版本保持一致，替换为RN 0.64.1官方适配compileSDK 30的推荐版本30.0.3，修改后配置如下：

buildscript {
    ext {
        buildToolsVersion = "30.0.3"
        minSdkVersion = 27
        compileSdkVersion = 30
        targetSdkVersion = 30
        ndkVersion = "20.1.5948944"
    }

• 检查并开启多版本签名支持，在android/app/build.gradle的签名配置块中补充v2、v3签名配置：

signingConfigs {
    release {
        // 保留原有签名配置（storeFile、storePassword、keyAlias、keyPassword）
        v1SigningEnabled true
        v2SigningEnabled true
        v3SigningEnabled true
    }
}

• 卸载测试设备上所有旧版本的应用，避免残留数据冲突。
• 若需支持32位设备，在android/app/build.gradle的defaultConfig块中添加ABI过滤配置：

defaultConfig {
    // 保留原有配置
    ndk {
        abiFilters "armeabi-v7a", "arm64-v8a", "x86", "x86_64"
    }
}

• 打包前执行全量清理：在Android工程根目录运行./gradlew clean，再重新生成签名APK即可。

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