跨平台开发 / 系统课时

配置 iOS 开发环境

配置 iOS 开发环境

本篇解决 Flutter 开发者在 macOS 上准备 iOS 开发环境的问题,完成 Xcode、CocoaPods 和设备签名配置后,可以稳定运行 Flutter 应用到模拟器或真实 iPhone 设备。

学习目标

  • 理解 Flutter iOS 构建链路中 Xcode、CocoaPods 和签名的职责
  • 掌握 macOS 下安装并验证 iOS 开发依赖的方法
  • 能够处理真机运行时常见的签名配置问题

理解 Flutter iOS 开发依赖

Flutter 项目本身负责跨平台界面和业务代码,但 iOS 应用最终需要通过 Xcode 的构建工具链生成。Xcode 提供 iOS SDK、模拟器、编译器以及签名能力,是 Flutter iOS 开发不可缺少的基础环境。

CocoaPods 用于管理 iOS 原生依赖。当 Flutter 插件包含 Objective-C 或 Swift 代码时,插件依赖通常会通过 Pod 安装到 iOS 工程中。

安装并检查开发工具

在 macOS 上先安装 Xcode,并通过命令行工具完成基础配置。

bash
xcode-select --install
flutter doctor -v

预期输出

text
Flutter 检查结果中显示 Xcode 已安装,并列出 iOS toolchain 状态。

如果首次打开 Xcode,需要接受许可协议并安装对应组件。可以执行:

bash
sudo xcodebuild -license accept

预期输出

text
Xcode license agreement accepted.

配置 CocoaPods

Flutter iOS 项目通常会在 ios 目录中使用 Pod 管理原生依赖。安装 CocoaPods 后,可以进入项目目录执行依赖安装。

bash
cd <PATH>
cd ios
pod install

预期结果

text
Pod installation completed successfully.

如果项目没有原生插件依赖,也可能不需要额外安装 Pod,但多数真实项目都会使用 Flutter 插件,因此建议提前准备。

准备真机签名

模拟器运行不需要 Apple 设备签名,但真机安装必须配置开发者账号和签名证书。

打开 Xcode 中的 iOS 工程:

bash
open ios/Runner.xcworkspace

预期结果

text
Xcode 打开 Runner 工程,可以进入 Signing & Capabilities 页面配置 Team。

在 Signing & Capabilities 中选择开发团队后,Xcode 会自动管理部分证书和 Provisioning Profile。实际项目中需要保证 Bundle Identifier 唯一,否则可能出现签名冲突。

常见环境问题

如果 flutter doctor 提示 CocoaPods 异常,通常需要检查 Pod 安装状态;如果真机无法启动,则优先检查开发者账号、设备信任和签名配置,而不是修改 Flutter 代码。

完成环境准备后,可以使用 flutter devices 查看 Flutter 是否识别模拟器或连接的 iPhone,再进入应用运行阶段。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 iOS 开发环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通