如何将React Native的minSdkVersion从21降至19？适配Android4.4

首先明确：React Native 0.70及以上版本强制要求最低Android API 21，要兼容API 19必须使用React Native 0.69.x及更早版本。以下是具体操作步骤：

1. 安装指定版本的React Native #

如果是新项目，直接初始化0.69.x版本：

npx react-native init MyProject --version 0.69.9

如果是现有项目，修改package.json中react-native及相关依赖的版本号为0.69.x系列，执行npm install或yarn install完成降级。

2. 修改Android项目配置 #

（1）调整项目根目录下的android/build.gradle #

找到buildscript里的ext配置块，将minSdkVersion改为19：

buildscript {
    ext {
        minSdkVersion = 19
        // compileSdkVersion、targetSdkVersion可按需保持原有设置
    }
}

（2）调整模块级android/app/build.gradle #

确保defaultConfig中的minSdkVersion同步指向根项目配置的19：

defaultConfig {
    applicationId "com.yourprojectname"
    minSdkVersion rootProject.ext.minSdkVersion
    targetSdkVersion rootProject.ext.targetSdkVersion
    versionCode 1
    versionName "1.0"
}

（3）处理兼容性细节 #

• 检查项目依赖的原生模块，部分模块可能默认依赖API 21+特性，需要替换为兼容API 19的版本，或自行修改模块代码适配。
• API 19不支持通知渠道、WebView部分新API等特性，业务代码中需通过版本判断做兼容处理，示例：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // 仅在API 26及以上执行的代码逻辑
}

3. 验证兼容性 #

在Android 4.4的模拟器或真机上运行项目，确认功能正常：

npx react-native run-android

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