1. 文档教程
壹信-开源即时通讯
  • 壹信 — 即时通讯系统
  • 项目源码结构与功能说明书
  • 功能核心分类明细
  • 客户端打包教程
  • Android安卓打包教程
  • iOS苹果打包教程
  • 苹果推送apns配置教程
  • macOS电脑打包教程
  • Windowsn桌面端打包教程
  • mac编译环境配置
  • windows编译环境配置
  • Docker部署后端教程
  • 用宝塔面板搭建服务端
  • API全局接口
  • 并发压力测试报告
  • 服务器配置推荐
  • 适用于上架的隐私协议
  • 端口说明
  • 更新日志
  • 法律声明
文档教程
文档教程
  1. 文档教程

macOS电脑打包教程

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

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

📑 目录导航#

1.
🛠️ 环境准备
2.
📦 项目初始化
3.
⚙️ 关键配置核查
4.
▶️ 调试运行 (Debug)
5.
🎁 正式打包 (Release)
6.
❓ 常见问题 (FAQ)

🛠️ 一、环境准备#

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

1.1 必装软件清单#

组件推荐版本说明
Xcode15.0 +App Store 下载
Command Line Tools15.0 +xcode-select --install
Flutter SDK3.24.0 +官方下载链接
CocoaPods1.14.0 +sudo gem install cocoapods

1.2 Xcode 配置要求#

1.
打开 Xcode → Preferences → Accounts
2.
添加您的 Apple ID (需有开发者账号)
3.
确保勾选 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)#

1.
打开 macos/Runner.xcworkspace (Xcode 项目)
2.
选择 Runner → Signing & Capabilities
3.
确保 Automatically manage signing 已启用
4.
选择您的 Apple ID 和 Team

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

1. 运行项目#

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

🎁 五、正式打包 (Release)#

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

项目根目录已内置优化脚本 build_macos.sh:
1.
赋予执行权限:
2.
执行打包:
✅ 脚本执行后效果:
生成通用 DMG 文件
自动重命名为 壹信IM.dmg
保存至桌面

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

📦 产物位置: build/macos/Build/Products/Release/壹信IM.app
💡 生成 DMG 文件:

❓ 六、常见问题 (FAQ)#


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

如有其他问题,请参考项目根目录 README.md 或联系技术团队。
修改于 2026-03-06 16:04:52
上一页
苹果推送apns配置教程
下一页
Windowsn桌面端打包教程
Built with