You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter如何设置Android、iOS平台最低支持版本并兼容高版本

Flutter 配置应用最低平台版本操作方法

配置完成后系统会自动拦截低于要求版本的设备安装应用,高版本系统默认提供向下兼容能力,只要代码做好版本分支适配,就能在所有高于最低要求的系统上正常运行。以下是设置最低支持Android 7、iOS 10的具体操作:

Android 端配置

Android 7.0 对应的系统API等级为24,配置步骤如下:

  1. 打开项目路径下的android/app/build.gradle文件
  2. 找到defaultConfig配置块,将minSdkVersion的取值修改为24,示例配置:
android {
    namespace "com.your.app"
    compileSdkVersion flutter.compileSdkVersion
    ndkVersion flutter.ndkVersion

    defaultConfig {
        applicationId "com.your.app"
        minSdkVersion 24 // 此处为Android最低版本配置,24对应Android 7.0
        targetSdkVersion flutter.targetSdkVersion
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }
}

注意:targetSdkVersion保持跟随Flutter模板默认值即可,无需手动修改,该字段不影响低版本兼容,仅声明应用适配过的最高系统版本。

iOS 端配置

iOS需要同步修改两处配置,避免CocoaPods依赖编译报错:

  1. 打开ios/Runner/Info.plist文件,找到MinimumOSVersion配置项,将值修改为10.0:
<key>MinimumOSVersion</key>
<string>10.0</string>
  1. 打开ios/Podfile文件,找到文件开头被注释的平台配置行,取消注释并将版本号改为10.0:
platform :ios, '10.0'

高版本兼容校验要点

配置完成后按以下要点校验,避免高版本运行异常:

  • 执行flutter clean清除历史构建缓存,再重新编译项目,避免旧配置缓存导致规则不生效
  • 引入第三方插件时,提前确认插件支持的最低平台版本,避免插件要求的最低版本高于你配置的阈值,引发编译或运行崩溃
  • 代码中如果需要调用仅高版本系统提供的API,必须增加系统版本判断逻辑,给低版本系统提供降级实现
  • 测试阶段需要覆盖三类环境:最低支持版本的设备/模拟器、主流中间版本设备、最新正式版系统设备,确认全版本功能正常

内容的提问来源于stack exchange,提问作者Majkelele

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.30 16:42:16