Flutter应用无法在实体Android设备上运行问题求助

解决方案 #

1. 先确认实体机调试连接正常 #

• 打开安卓手机的开发者选项，开启USB调试、USB安装权限，小米、华为等国产机型需额外开启「USB调试(安全设置)」允许通过USB安装应用
• 手机连接电脑时选择「文件传输(MTP)」模式，不要选择仅充电
• 打开cmd执行flutter devices命令，确认列表中能识别到你的安卓设备，识别不到需前往对应手机品牌官网下载安装官方ADB驱动

2. 调整Gradle构建内存配置适配低内存环境 #

你的4G运行内存不足以支撑默认的Gradle构建堆内存配置，是本次报错的核心原因：

• 打开Flutter项目android目录下的gradle.properties文件
• 找到org.gradle.jvmargs配置项，修改为以下参数，降低最大堆内存占用：

  org.gradle.jvmargs=-Xmx1024m -XX:MaxMetaspaceSize=256m
  

• 追加以下配置关闭不必要的构建特性，减少内存消耗：

  android.enableJetifier=false
  org.gradle.parallel=false
  

3. 优化运行命令降低构建压力 #

• 先执行flutter clean清理异常构建缓存
• 运行时使用命令flutter run --debug --no-shrink，跳过资源压缩、混淆等耗内存的构建步骤

额外优化建议 #

如果上述操作后还是内存不足构建失败，可将Flutter SDK降级到3.0.x LTS版本，新版本Flutter的构建内存占用远高于旧的稳定版，更适配低内存设备。

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