🍎 壹信 IM · iOS 环境配置与打包指南

💡 核心信息
适用版本: Xcode 15+ | iOS 15.0+
最后更新: 2026-03-07
架构目标: arm64 (Universal)
适用系统: macOS (M1/M2/M3 芯片推荐)

📑 目录导航

🛠️ 环境准备

📦 项目初始化

🛠️ 一、环境准备

在开始之前，请确保您的 Mac 已安装以下核心组件。

1.1 必装软件清单

组件	推荐版本	说明
Xcode	`15.0` +	App Store 下载
Command Line Tools	`15.0` +	`xcode-select --install`
Flutter SDK	`3.24.0` +	官方下载链接
CocoaPods	`1.14.0` +	`sudo gem install cocoapods`

1.2 Xcode 配置要求

打开 Xcode → Preferences → Accounts

添加您的 Apple ID (需有开发者账号)

确保勾选 Automatically manage signing (推荐)

📦 二、项目初始化

2.1 获取源代码

2.2 安装依赖

2.3 清理与预热 (推荐)

⚙️ 三、关键配置核查

3.1 检查 Bundle ID

打开 ios/Runner/Info.plist，确认以下配置：

<key>CFBundleIdentifier</key>
<string>com.yixin.im</string> <!-- 必须唯一，建议使用反向域名格式 -->

💡 提示: 需在 Apple Developer 中注册该 Bundle ID

3.2 检查版本信息

打开 ios/Runner/Info.plist，确认版本号：

<key>CFBundleShortVersionString</key>
<string>1.0.0</string> <!-- 语义化版本号 -->
<key>CFBundleVersion</key>
<string>1</string>

3.3 配置签名 (Xcode)

打开 ios/Runner.xcworkspace (Xcode 项目)

选择 Runner → Signing & Capabilities

确保 Automatically manage signing 已启用

选择您的 Apple ID 和 Team

▶️ 四、调试运行 (Debug)

1. 连接 iOS 设备

通过 USB 连接 iPhone 或 iPad

在 Xcode 中选择设备作为目标

2. 运行项目

⚠️ 重要提醒: 需要设备已信任开发证书（首次运行时 Xcode 会提示）

🎁 五、正式打包 (Release)

方式 A：使用自动化脚本 (推荐)

项目根目录已内置优化脚本 build_ipa.sh：

赋予执行权限:

执行打包:

✅ 脚本执行后效果:

生成通用 IPA 文件

自动重命名为 壹信IM.ipa

保存至桌面

方式 B：手动命令行打包

💡 配置 exportOptions.plist (在 ios/ 目录下):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>method</key>
    <string>app-store</string> <!-- 或 'ad-hoc' / 'enterprise' -->
    <key>provisioningProfiles</key>
    <dict>
        <key>com.yixin.im</key>
        <string>com.yixin.im_ProvisioningProfile</string>
    </dict>
</dict>
</plist>

📦 产物位置: build/ios/ipa/壹信IM.ipa

❓ 六、常见问题 (FAQ)

🎉 恭喜！您已成功完成壹信 IM 的 iOS 环境配置与打包。

如有其他问题，请参考项目根目录 README.md 或联系技术团队。

iOS苹果打包教程

🍎 壹信 IM · iOS 环境配置与打包指南#

📑 目录导航#

🛠️ 一、环境准备#

1.1 必装软件清单#

1.2 Xcode 配置要求#

📦 二、项目初始化#

2.1 获取源代码#

2.2 安装依赖#

2.3 清理与预热 (推荐)#

⚙️ 三、关键配置核查#

3.1 检查 Bundle ID#

3.2 检查版本信息#

3.3 配置签名 (Xcode)#

▶️ 四、调试运行 (Debug)#

1. 连接 iOS 设备#

2. 运行项目#

🎁 五、正式打包 (Release)#

方式 A：使用自动化脚本 (推荐)#

方式 B：手动命令行打包#

❓ 六、常见问题 (FAQ)#

🎉 恭喜！您已成功完成壹信 IM 的 iOS 环境配置与打包。#