跳到主要内容

ios项目构建

如果你不使用 CI 工具而是通过 Xcode 的可视化界面进行构建和发布 iOS 应用，流程将稍有不同。你可以直接在打包机上运行 Xcode 并进行构建。以下是详细步骤：

步骤 1：在打包机上配置开发环境​

确保打包机已经配置好以下环境：

  1. macOS：确保打包机运行的是 macOS。
  2. Xcode：安装最新版本的 Xcode，并确保你有 Apple 开发者帐户的凭证。
  3. Flutter SDK：在打包机上安装 Flutter SDK。
  4. CocoaPods：确保安装了 CocoaPods，用于管理 iOS 依赖。

步骤 2：在打包机上运行 Flutter 项目​

  1. 克隆项目代码：将 Flutter 项目代码克隆到打包机上。

    git clone https://your-repo-url.git
    cd your-project-directory

  2. 安装 Flutter 依赖：在项目根目录下运行以下命令，安装 Flutter 依赖。

    flutter pub get

  3. 安装 iOS 依赖：切换到 ios 目录并运行 CocoaPods 安装命令。

    cd ios
    pod install
    cd ..

步骤 3：在 Xcode 中配置项目​

  1. 打开 Xcode 项目：在 Xcode 中打开你的 .xcworkspace 文件，而不是 .xcodeproj 文件，因为 .xcworkspace 文件包含了 CocoaPods 管理的依赖。

    open ios/Runner.xcworkspace

  2. 配置项目设置：

    • 选择你的项目，然后选择目标（Target）。
    • 在“General”标签下，确保所有信息（如 Display Name、Bundle Identifier、Version 和 Build）都已正确填写。
    • 在“Signing & Capabilities”标签下，确保已选择正确的开发者帐户，并启用了自动签名（Automatically manage signing）。

  3. 选择构建配置：

    • 从 Xcode 菜单栏中选择 Product -> Scheme -> Edit Scheme。
    • 在弹出的窗口中，选择“Run”选项卡，然后选择“Release”作为构建配置。

步骤 4：构建归档文件​

  • 从 Xcode 菜单栏中选择 Product -> Archive。
  • Xcode 将构建并归档你的项目。构建完成后，Organizer 窗口将自动打开，显示你的归档文件。

如果要查看历史的归档，可以通过 Window -> Organizer 唤起

步骤 5：导出 IPA 文件​

  • 在 Organizer 窗口中选择刚刚创建的归档文件，然后点击“Distribute App”。
  • 选择“Ad Hoc”或“App Store”作为发布方式，然后点击“Next”。
  • 选择正确的签名证书和配置文件，然后点击“Next”。
  • 在接下来的步骤中，按照提示进行操作，最终会生成 IPA 文件并保存到你的指定位置。

完整流程概述​

  1. 准备打包机：确保打包机上安装了 macOS、Xcode、Flutter SDK 和 CocoaPods。
  2. 克隆项目：将项目代码克隆到打包机上，并安装所有依赖。
  3. 配置 Xcode 项目：在 Xcode 中打开 .xcworkspace 文件，并配置项目设置和签名。
  4. 构建归档：使用 Xcode 的 Archive 功能构建项目。
  5. 导出 IPA：通过 Organizer 导出 IPA 文件。

重要提示​

  • 签名证书和配置文件：确保你的 Apple 开发者帐户中的签名证书和配置文件在打包机上可用。你可能需要导出这些证书和配置文件，并导入到打包机上的 Xcode 中。
  • Xcode 版本：确保打包机上的 Xcode 版本与你本地开发环境中的版本一致，以避免兼容性问题。
  • 网络连接：确保打包机有良好的网络连接，以便安装依赖和进行代码签名验证。

通过这些步骤，你可以在不使用 CI 工具的情况下，通过 Xcode 可视化界面构建和发布你的 Flutter iOS 应用。