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

💡 核心信息
适用版本: Flutter 3.x+ | Xcode 15+ | macOS 13.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

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

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

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

3.2 检查版本信息

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

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

3.3 配置签名 (Xcode)

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

选择 Runner → Signing & Capabilities

确保 Automatically manage signing 已启用

选择您的 Apple ID 和 Team

▶️ 四、调试运行 (Debug)

1. 运行项目

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

🎁 五、正式打包 (Release)

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

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

赋予执行权限:

执行打包:

✅ 脚本执行后效果:

生成通用 DMG 文件

自动重命名为 壹信IM.dmg

保存至桌面

方式 B：手动命令行打包

📦 产物位置: build/macos/Build/Products/Release/壹信IM.app

💡 生成 DMG 文件:

❓ 六、常见问题 (FAQ)

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

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

macOS电脑打包教程

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

📑 目录导航#

🛠️ 一、环境准备#

1.1 必装软件清单#

1.2 Xcode 配置要求#

📦 二、项目初始化#

2.1 获取源代码#

2.2 安装依赖#

2.3 清理与预热 (推荐)#

⚙️ 三、关键配置核查#

3.1 检查 Bundle ID#

3.2 检查版本信息#

3.3 配置签名 (Xcode)#

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

1. 运行项目#

🎁 五、正式打包 (Release)#

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

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

❓ 六、常见问题 (FAQ)#

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