跳到主内容

设置 iOS 开发环境

配置您的开发环境,以运行、构建和部署 Flutter 应用到 iOS 设备。

了解如何配置您的开发环境,以运行、构建和部署 Flutter 应用到 iOS 设备。

设置 iOS 工具链

#

使用 Xcode,您可以在 iOS 物理设备或 iOS 模拟器上运行 Flutter 应用。

  1. 安装 Xcode

    如果您尚未这样做,请安装并设置最新版本的 Xcode

    如果您已经安装了 Xcode,请使用您最初使用的安装方法将其更新到最新版本。

  2. 设置 Xcode 命令行工具

    要配置 Xcode 命令行工具以使用您安装的 Xcode 版本,请在您首选的终端中运行以下命令

    sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'
    

    如果您从其他地方下载了 Xcode 或需要使用不同的版本,请将 /Applications/Xcode.app 替换为相应的路径。

  3. 同意 Xcode 许可协议

    在您设置 Xcode 并配置其命令行工具后,请同意 Xcode 许可协议。

    1. 打开您偏好的终端。

    2. 运行以下命令以查看并签署 Xcode 许可协议。

      sudo xcodebuild -license
      
    3. 阅读并同意所有必要的许可协议。

      在同意每项许可协议的条款之前,请仔细阅读。

  4. 下载先决条件工具

    要下载 iOS 平台支持和最新的 iOS 模拟器运行时,请在您首选的终端中运行以下命令。

    xcodebuild -downloadPlatform iOS
    
  5. 安装 Rosetta

    如果您正在使用 Apple Silicon (ARM) Mac,请安装 Rosetta 2

    sudo softwareupdate --install-rosetta --agree-to-license
    
  6. 安装 CocoaPods

    为了支持使用原生 iOS 或 macOS 代码的 Flutter 插件,请安装最新版本的 CocoaPods

    请按照 CocoaPods 安装指南 安装 CocoaPods。

    如果您已经安装了 CocoaPods,请按照 CocoaPods 更新指南 更新它。

设置 iOS 设备

#

我们建议从 iOS 模拟器开始,因为它比物理 iOS 设备更容易设置。但是,您也应该在实际物理设备上测试您的应用。

使用以下命令启动 iOS 模拟器

open -a Simulator

如果您需要安装不同操作系统版本的模拟器,请查看 Apple Developer 网站上的 下载和安装额外的 Xcode 组件

设置您想要测试的每个 iOS 设备。

  1. 配置您的物理 iOS 设备

    1. 将您的 iOS 设备连接到 Mac 上的 USB 端口。

    2. 首次将 iOS 设备连接到 Mac 时,您的设备会显示 信任此电脑? 对话框。

    3. 点击 信任

      Trust Mac

  2. 配置您的物理 iOS 设备

    Apple 要求在设备上启用 开发者模式,以防止恶意软件。

    1. 点击 设置 > 隐私与安全性 > 开发者模式

    2. 点击切换 开发者模式开启

    3. 重启设备。

    4. 开启开发者模式? 对话框出现时,点击 开启

  3. 创建开发者代码签名证书

    要将您的应用发送到物理 iOS 设备,即使只是为了测试,您必须在您的 Mac 和设备之间建立信任。除了在弹出窗口中信任设备之外,您还必须将已签名的开发者证书上传到您的设备。

    要创建已签名的开发证书,您需要一个 Apple ID。如果您没有,请 创建一个。您还必须注册 Apple Developer Program 并创建一个 Apple Developer 帐户。如果您只是测试您的应用在 iOS 设备上,个人 Apple Developer 帐户是免费的并且可以正常工作。

  4. 准备设备

    1. 设置 下找到 VPN 与设备管理 菜单。

      将您的证书切换到 启用

    2. 开发者应用 标题下,您应该找到您的证书。

    3. 点击证书。

    4. 点击 信任“<证书>”

    5. 当对话框显示时,点击 信任

      如果出现 codesign 想要访问密钥... 对话框

      1. 输入您的 macOS 密码。

      2. 点击 始终允许


开始 iOS 开发

#

恭喜。 现在您已经设置了 Flutter 的 iOS 开发环境,您可以继续您的 Flutter 学习之旅,同时在 iOS 上进行测试,或开始改进与 iOS 的集成。