夜雨聆风学习资料网

ARTICLE · 1220464

Flutter iOS 运行实操全记录

Flutter iOS 运行实操全记录
之前写了 Flutter 开发如何做基础配置,还写了安卓如何打包,今天就来总结一下 IOS 版本如何运行。
一. 根目录生成 ios 文件夹
在项目根目录下运行以下命令即可自动生成 ios/ 文件夹(iOS 平台的原生壳工程:包含 Xcode 项目配置、Info.plist、Podfile 等):
flutter create --platforms=ios .
注意:最后这个 . 一定不要忘记,否则就会报错
末尾那个点号 .,它告诉 Flutter 在当前目录进行修复/补充平台文件。
不加点的话,Flutter 把它当成了"创建一个新项目"的请求,但你没给项目名(输出目录),所以报了 No option specified for the output directory。
加上 . 之后就是"在当前已存在的项目里补充 iOS 平台支持"的意思。
成功运行后,会生产ios文件夹,项目目录如下:
二.  VSCode 安装 Flutter 插件
1. 安装 SDK
在macOS上打开VSCode,安装flutter插件
随意打开一个flutter项目,会提示安装Flutter SDK
2. 安装项目依赖
打开自己要开发的Flutter项目,运行flutter pub get下载依赖
flutter pub get

报错:VM initialization failed: Current Mac OS X version 12.0 is lower than minimum supported version 14.0

版本号不对应,手动切换 Flutter SDK 版本

# 1. 找到你当前的 Flutter SDK 位置which flutter# 比如输出:/Users/you/development/flutter/bin/flutter# 2. 进入 Flutter SDK 根目录(把 bin/flutter 去掉)cd /Users/you/development/flutter# 3. 查看当前版本cat bin/internal/engine.version 2>/dev/null || git log --oneline -1# 4. 查看有哪些版本可用git fetch --tagsgit tag -l "3.22*"git tag -l "3.24*"# 5. 切到最后一个支持 macOS 12 的版本(3.22.5 比较稳)git checkout 3.22.5# 6. 清理缓存flutter clean 2>/dev/nullrm -rf bin/cache# 7. 让 Flutter 自己重新下载 dart 和 engineflutter --version# 8. 回项目执行cd your_flutter_projectflutter pub get
如果还会报版本不匹配的错,比如:

which requires SDK version >=3.5.0 <4.0.0, version solving failed.

修改pubspec.yaml这个文件里的版本号,修改之后

再运行下面的命令就可以了

flutter pub get

三.VSCode 中运行项目

查看模拟器的设备列表,确认机子上是否已经安装了iPhone的模拟器
xcrun simctl list devices available
VSCode选择iOS的模拟器
按 Cmd + Shift + P,输入 Flutter: Select Device,选中刚启动的 iPhone,如果没有看到,可以点击添加ios。
如果没有模拟器可以选择,就点击开启
就会在VSCode的右下角显示正在连接中
右下角显示模拟器之后
就可以在终端输入运行命令了
flutter run

四.XCode 中运行项目

1. XCode 打开自己要开发的Flutter项目
选择项目根目录的ios/Runner.xcworkspace。
2. 选择模拟器
点击屏幕顶部菜单栏的 Product,选择 Scheme,这里通常会显示可用的 Scheme(如 Runner),点击选中它:
点击 Product > Destination,选择你想运行的 iPhone 模拟器型号
查看模拟器的设备列表,确认机子上是否已经安装了iPhone的模拟器
xcrun simctl list devices available

也可以在Xcode里选择window下面的devices and simulators, 点击打开查看模拟器列表

找到想要使用的模拟器之后,点击运行

五、报错处理
1. 报错:unable to open configuration settings file:
这说明 ios/Flutter/Debug.xcconfig 或它里面引用的 Generated.xcconfig 文件缺失或路径无效。这通常发生在项目刚克隆下来,或者执行了 flutter clean 之后 。
重新生成 Flutter 配置文件
在终端进入项目根目录,依次执行以下命令,强制 Flutter 重新生成缺失的配置和依赖 :
flutter cleanflutter pub get
完成后,务必先尝试用命令行运行一次:
flutter run
如果能成功在模拟器启动,说明依赖生成正常,后续可以在 Xcode 中打开了。
2. 报错:Missing package product 'FlutterGeneratedPluginSwiftPackage':
这是 Flutter 较新版本引入 Swift Package Manager (SPM) 管理依赖后的机制。报错说明 Xcode 找不到这个自动生成的本地 Swift 包
Flutter 开发相关文章推荐:
Flutter Android 正式版打包全记录:从签名配置到 release 构建
Flutter 安卓真机终于跑通了!完整流程 + 踩坑报错全记录
Flutter 运行常用命令速查:从启动项目到真机调试,一篇搞定
零基础学 Flutter:一篇搞定开发环境配置

关注我,前端/全栈开发少走弯路、高效摸鱼~

如果你觉得文章内容有用,请记得点赞、收藏、转发。


👋 关于我

19 年开发背景,现在独立接项目、做分享。记录真实过程,分享真实经验,不贩卖焦虑。

技术交流群:点击下方二维码拉你进群

相关学习资料