当前位置： 首页 > news >正文

聊聊 Flutter 在 iOS 真机 Debug 运行出现 Timed out *** to update 的问题

news 2025/7/27 5:39:33

最近刚好有人在问，他的 Flutter 项目在升级之后出现 Error starting debug session in Xcode: Timed out waiting for CONFIGURATION_BUILD_DIR to update 问题，也就是真机 Debug 时始终运行不了的问题：

其实这已经是一个老问题了，这个问题不只是 Flutter 会出现，在 React Native 平台也会有，因为本质上 Xcode 15+ 的升级带来的变动，最明显标志就是，如果你直接在 Xcode 直接运行这个 Flutter 项目是可以正常运行的话，那么 99% 就是因为 Xcode 15+ 上 ios-deploy 的“废弃”引起的问题。

ios-deploy 是一个通过对苹果私有框架进行逆向，提供了无需打开 Xcode.app 就可以在物理 iOS 设备上安装和调试应用的第三方框架，而对于 Flutter 而言， flutter run 命令的一键式启动，在很大程度上依赖 ios-deploy ，以及至关重要的一步：在设备上启动 debugserver 进程。

当然，虽然 ios-deploy 不能用了，但是苹果提供了官方的替代方案：devicectl 命令行工具，不过虽然它能够安装应用（例如 devicectl device install app ），但它缺少了在设备上启动 debugserver 并将附加到目标进程的支持，这对于 Flutter Debug 时的 JIT 和 hotload 非常重要。

详细原因可见：《Flutter 又双叒叕可以在 iOS 26 的真机上 hotload》 ，而针对 devicectl 可以从下方的 React Native CLI 变动中看到，针对真机按照，现在 React Native 也采用了 devicectl 的方式：image-20250717131819323

所以，虽然有 devicectl ，但是 Flutter 的 JIT 离不开 debugserver 的权限支持，所以 Flutter 官方针对 Xcode 15 的场景进行了一些临时处理，当开发者运行 flutter run 时，流程会是：

  • 使用 xcodebuild 构建应用
  • 启动 Xcode.app
  • 利用脚本让 Xcode 在连接的设备上运行 App
  • 等待 Xcode 建立调试会话，将 Flutter 工具的守护进程连接到 Dart VM 的 Observatory 端口

简单说，就是需要安装 Xcode 并且运行时会弹出 Xcode 窗口，还需要用户在 macOS 的“系统设置 > 隐私与安全性 > 自动化”中给予相应的权限 ：

而问题主要也是出现在这里，很多开发者发现，Flutter run 并没有拉起 Xcode ，或者拉起后依然出现超时等情况，这也是这个方案最大的问题：

目前看来，这还和用户当前项目的环境有关系，正常来说这个流程是不会有问题的，但是结果来看并不是大家都“正常”，所以根据已有信息看，遇到这类问题一般的做法有：

  • flutter clean 清除掉已有的可能存在问题的 build
  • 手动启动 Xcode 减少等到时间
  • 通过 Xcode 直接运行判断项目本身兼容存在问题，如果可以运行，说明是 Flutter 命令行问题
  • 关闭 Wi-Fi，有时候即使 iPhone 通过 USB 数据线连接到 Mac，Xcode 也可能优先选择通过 Wi-Fi 进行调试连接
  • 执行 flutter run 命令运行
  • 如果还不行，可以尝试 Xcode 直接运行，然后执行 flutter attatch 尝试连接 Dart VM Observatory 服务
  • 再不行，只能模拟器开发，然后 release 运行真机测试

而针对这个问题，其实苹果也发现了，所以 Xcode 16 增加了 devicectl 和 Xcode 的命令行调试器 lldb 协同工作的支持，虽然 devicectl 单独无法启动 debugserver，但它可以和 Xcode 的命令行调试器 lldb 协同工作：

所以针对这个问题，Flutter 计划也是有在 Xcode 16 做新的调整的计划，通过新的 devicectl + lldb 集成到 flutter run 命令来回归已有的流程，但是因为涉及变动很多，暂时看起来还没什么进展：

主要是 Xcode automation in CI 也不是完全不能用····

最后总结下，这个问题的核心就是，你用 Xcode 能不能运行，如果可以，就可以尝试使用 flutter attatch ，或者 flutter run 之前先打开 Xcode ，并且确保 Xcode 开启了自动签名之类的必备条件，最好关闭手机 Wi-Fi 来排除问题。

最极端的情况下，可能会需要你 flutter clean 和 rm -r ~/Library/Developer/Xcode/iOS\ DeviceSupport 清除设备当前授权。

参考链接

https://github.com/flutter/flutter/issues/172095

https://github.com/flutter/flutter/issues/133465

https://github.com/flutter/flutter/issues/144218

https://github.com/flutter/flutter/issues/42969#issuecomment-3057078316

http://www.dtcms.com/a/293637.html

相关文章：

  • GEMINUS 和 Move to Understand a 3D Scene
  • Redis的key过期策略
  • 4.3 激活函数的目的
  • LLM 幻觉一般是由于什么产生的，在模型什么部位产生
  • 计算机组成原理——数据的表示和运算2
  • 手机开启16k Page Size
  • J2EE模式---服务定位器模式
  • JavaEE Spring框架的概述与对比无框架下的优势
  • 关于原车一键启动升级手机控车的核心信息及注意事项
  • 第五章第一节 EXTI 外部中断
  • Adobe全系列下载 官方原版补丁
  • 【Spark征服之路-3.8-Spark-SQL核心编程（七）】
  • 2025獬豸杯WP
  • 用Phi-3 Mini微调实现英文到尤达语翻译
  • 软硬件协同仿真和验证的标准接口协议SCE-MI简介
  • 避坑指南：Windows 11中 Docker 数据卷的存放位置
  • vue+element-ui实现主子表
  • Vue3 面试题及详细答案120道（61-75 ）
  • 力扣146:LRU缓存
  • 使用阿里云 ESA 边缘函数转发代理 docker registry
  • 利用aruco标定板标定相机
  • 电商通用话术模板搭建指南：高效转化，服务升级
  • macOS配置maven及报错处理：zsh: permission denied: mvn
  • Transformer输入部分实现
  • 学习 Flutter（五）：玩安卓项目实战 - 下
  • springcloud环境和工程搭建
  • 数组算法之【数组中第K个最大元素】
  • RK3568笔记九十：基于web显示RTSP流
  • 【第三章自定义检视面板_创建自定义编辑器_如何创建自定义PropertyDrawer(9/9)】
  • SQL 中 CASE WHEN 及 SELECT CASE WHEN 的用法