将 App 安装到 iPhone 真机上测试

在 macOS 上使用 Flutter 开发 iOS 应用时，将 App 安装到 iPhone 真机上测试是一个非常常见的需求。下面是完整的 Flutter + Xcode 配合 iPhone 真机调试流程，适用于 macOS + Xcode + iPhone 的开发环境。

📱 一、前提条件

🔌 二、连接 iPhone 并启用开发者模式

步骤 1：启用 iPhone 开发者选项

1. 在 iPhone 上打开：

   设置 > 关于本机 > 开发者选项
   

   如果没有看到“开发者选项”，请先多次点击：

   设置 > 关于本机 > 版本号
   

2. 在“开发者选项”中，确保以下开关开启：

   • UI 检查器与辅助功能检查器
   • 调试服务器监听端口

🛠️ 三、在 Xcode 中设置签名并信任电脑

步骤 1：打开 Flutter 项目的 iOS 部分

open ios/Runner.xcworkspace

⚠️ 一定要打开 .xcworkspace 文件，而不是 .xcodeproj，否则 CocoaPods 插件不会生效。

步骤 2：设置 Team（Apple ID）

1. 在 Xcode 中选择 Runner target。

2. 进入 Signing & Capabilities 标签页。

3. 设置你的 Apple ID 为 Development Team：

   Team: Your Name (Personal Team)
   

4. 勾选：

   Automatically manage signing
   

步骤 3：信任电脑（首次连接需要）

• 当你第一次连接 iPhone 到 Mac 时，iPhone 会弹出提示：

  是否允许此电脑进行调试？
  

• 选择 “信任”，然后解锁手机并确认。

🧪 四、运行真机调试

方法 1：使用 Flutter 命令行运行

flutter run

或指定设备：

flutter devices
flutter run -d <设备名>

例如：

flutter run -d iPhone

如果一切正常，你会看到：

Installing and launching...
✓ Installed on device.

方法 2：使用 Xcode 直接运行

1. 在 Xcode 中选择目标设备为你连接的 iPhone。
2. 点击 ▶ Run 按钮。
3. App 会自动安装并启动。

📦 五、常见问题与解决方法

❗ 1. “No profiles for ‘com.example.myapp’ were found”

• ✅ 解决方法：

  • 确保你已经登录了 Apple ID 到 Xcode。

  • 使用免费 Apple ID 也可以运行真机调试（仅限开发用途）。

  • 若提示错误，可尝试删除 ios/ 文件夹并重新生成：

    rm -rf ios/
    flutter create .
    cd ios && pod install && cd ..
    

❗ 2. “Install Failed – Code Signing Error”

• ✅ 解决方法：
  • 确保 Signing & Capabilities 中的 Bundle ID 是唯一的。
  • 确保你选择了正确的 Team。
  • 如果你使用的是付费开发者账号，请确保该 Bundle ID 已注册。

❗ 3. iPhone 提示 “未受信任的企业级开发者”

• ✅ 解决方法：
  • 打开 iPhone 设置 → 通用 → 关于本机 → 设备管理 → 信任你的开发者证书。

📲 六、如何查看日志和调试

方法 1：使用 Flutter 查看日志

flutter run

终端会输出 Dart 层的所有日志信息。

方法 2：使用 Xcode 查看详细日志

1. 打开 Xcode → Window > Devices and Simulators
2. 选择你的 iPhone 设备 → 查看 Console 输出日志

🧩 七、关于 Apple Developer Program（开发者计划）

✅ 总结操作流程

📌 小贴士

• ✅ 免费 Apple ID 可以真机调试，但不能发布 App。
• ✅ 如果你以后想发布 App，建议加入 Apple Developer Program
• ✅ 修改 App 名称和图标见我之前的回答 👉 iOS 图标和名称设置指南