You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多
文档控制台
免费开始使用

Flutter应用可在模拟器正常运行但真机安装阶段卡住的问题求助

Flutter真机安装卡住?试试这些排查方案!

我之前也碰到过一模一样的问题!真机安装卡在Installing build/app/outputs/flutter-apk/app.apk...这步真的很闹心,给你列几个我亲测有效的解决办法:

1. 先确认USB连接的基础设置

  • 确保手机的USB调试已经开启,连接电脑时一定要选择「文件传输(MTP)」模式,别选仅充电;
  • 第一次连接电脑时,手机大概率会弹出「允许此设备调试?」的授权弹窗,别漏看!一定要点「允许」,如果没弹出来,拔掉USB线重新插一次试试。

2. 清理项目缓存与旧安装包

  • 先把手机上已安装的同应用彻底卸载,包括残留的缓存数据;
  • 在项目根目录执行以下命令清理Flutter缓存:
    flutter clean
    flutter pub get
    
  • 之后再重新运行flutter run

3. 检查ADB连接状态

  • 打开终端执行adb devices,查看你的设备是否在列表中,状态是否为device(如果显示unauthorizedoffline就有问题);
  • 若显示unauthorized,重启ADB服务:
    adb kill-server
    adb start-server
    
  • 要是还是不行,换一根质量好点的USB线——很多便宜线只能充电,没法传输数据。

4. 调整Android端配置

  • 打开android/app/build.gradle,把minSdkVersion调整到21及以上(部分新设备对低版本SDK兼容性较差);
  • 确保android/build.gradle里的Gradle版本和Android Gradle Plugin版本匹配,比如使用Gradle 7.4 + AGP 7.1.3这种稳定组合。

5. 手动安装APK排查问题

既然已经成功构建了app-debug.apk(路径:build/app/outputs/flutter-apk/app-debug.apk),可以把这个文件传到手机上手动点击安装,看看会不会弹出具体错误提示(比如解析失败、权限不足等),能帮你快速定位核心问题。

6. 检查开发者选项的特殊权限

  • 进入手机开发者选项,确认「USB安装」开关已打开;
  • 有些手机需要开启「安装未知应用」权限,给电脑对应的ADB应用授权,才能通过adb安装应用。

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

火山引擎 最新活动