💻 壹信 IM Mac 环境配置详细指南#

💡 核心信息

适用系统: macOS Ventura 13.0+ (建议 Monterey 12.6+ 或 Sonoma 14.0+)

适用版本: Flutter 3.24.0+ | Xcode 15.0+

最后更新: 2026-03-07

编译目标: x64 (Apple Silicon 或 Intel)

所需内存: 16GB+

所需存储: 50GB+

📌 一、系统准备与检查#

1.1 系统要求确认#

🛠️ 二、必备软件安装详细指南#

2.1 Homebrew (包管理器)#

2.1.1 安装 Homebrew#

2.1.2 配置 Homebrew#

2.2 Xcode (开发工具)#

2.2.1 安装 Xcode#

2.3 Flutter SDK (最核心组件)#

2.3.1 下载与安装#

2.4 Java Development Kit (JDK 17)#

2.4.1 安装 JDK 17#

2.5 Android Studio (可选，如需编译 Android)#

2.5.1 安装 Android Studio#

⚙️ 三、Flutter 环境详细配置#

3.1 启用 macOS 支持#

Enabled macOS support for Flutter.

3.2 验证 Flutter 环境#

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.0, on macOS 14.0 23A344 darwin-arm64, locale en-US)
[✓] Android toolchain - develop for Android devices
[✓] Xcode - develop for iOS and macOS (Xcode 15.0)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2022.3.1)
[✓] VS Code (version 1.77.3)
[✓] Connected device (2 available)
[✓] macOS support - develop for macOS desktop

3.3 安装 Flutter 依赖#

🧪 四、验证编译环境（详细步骤）#

4.1 创建测试项目#

4.2 编译测试项目#

4.3 运行测试应用#

❓ 五、常见问题与详细解决方案#

5.1 问题: flutter doctor 显示 "Xcode not installed"#

5.2 问题: flutter build macos 提示 "CocoaPods not installed"#

5.3 问题: flutter build macos 提示 "CMake not found"#

5.4 问题: "The application has failed to start because its side-by-side configuration is incorrect"#

5.5 问题: flutter pub get 失败#

📌 六、壹信 IM 项目编译详细步骤#

6.1 进入项目目录#

6.2 配置项目#

6.3 编译项目#

6.4 运行项目#

🎉 七、编译完成验证#

7.1 验证编译产物#

7.2 运行编译后的可执行文件#

💡 八、高级配置建议#

8.1 配置 VS Code 作为开发环境#

{
  "dart.sdkPath": "~/Development/flutter",
  "flutter.sdkPath": "~/Development/flutter"
}

8.2 配置代码自动格式化#

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "dart-code.dart-code",
  "dart.formatOnSave": true
}

📌 九、总结#

安全提示: 首次运行应用时，系统可能会提示 "未知发布者"，请在"系统设置" → "安全性与隐私" → "通用" 中信任应用，否则应用无法运行。

📎 附录：环境配置检查清单#

✅ 最终验证#

Building macOS application...
✓ Built build/macos/Build/Products/Release/yixinim.app.