1. 项目背景与痛点分析Flutter作为跨平台开发框架在移动端已经相当成熟但桌面端的打包流程却一直是个痛点。特别是MacOS平台从代码编译到最终生成用户可直接安装的dmg文件需要经历多个繁琐步骤。传统方式需要开发者手动执行以下操作运行flutter build macos --release生成.app文件打开磁盘工具手动创建dmg镜像配置镜像参数和背景图手动拖拽.app文件到镜像中设置应用程序链接位置这个过程不仅耗时而且容易出错。我在实际项目中发现每次发版都要重复这些操作浪费了大量时间。更糟的是不同开发者打包出来的dmg文件参数可能不一致导致用户体验参差不齐。2. 解决方案设计思路2.1 核心工具选型经过调研我选择了create-dmg作为基础工具链原因有三它是专为MacOS设计的命令行工具完美支持.app到.dmg的转换可以通过Homebrew一键安装维护方便提供丰富的参数配置可以精确控制dmg文件的各项属性2.2 自动化流程设计整个打包流程被设计为四个阶段环境准备阶段检查create-dmg是否安装创建输出目录构建阶段清理旧构建产物执行Flutter release构建配置读取阶段从pubspec.yaml读取版本号定位.app文件路径打包阶段调用create-dmg生成最终dmg文件3. 详细实现步骤3.1 环境准备首先需要安装create-dmg工具brew install create-dmg然后在项目根目录创建packages文件夹放入以下文件generate_mac_dmg(主脚本)installer_background.png(dmg背景图)给脚本添加执行权限chmod x generate_mac_dmg3.2 脚本核心逻辑解析脚本的核心代码如下#!/bin/sh # 获取项目版本号 fullVersion$(grep -i version: pubspec.yaml) buildName$(echo $fullVersion | cut -d -f 2 | cut -d -f 1) buildNumber$(echo $fullVersion | cut -d -f 2) # 执行Flutter构建 flutter clean flutter build macos --release # 定位.app文件 cd ./build/macos/Build/Products/Release appPath$(find . -type d -name *.app) internalAppName$(basename $appPath .app) # 生成dmg文件名 fileName${internalAppName}_macos_${buildName}_${buildNumber}.dmg # 调用create-dmg打包 create-dmg \ --volname ${internalAppName}安装器 \ --background ../installer_background.png \ --window-pos 200 120 \ --window-size 800 450 \ --icon-size 100 \ --icon ${internalAppName}.app 240 190 \ --hide-extension ${internalAppName}.app \ --app-drop-link 550 190 \ ./$fileName \ ../../build/macos/Build/Products/Release3.3 create-dmg参数详解关键参数说明--volname设置磁盘映像挂载时显示的名称--background指定背景图片路径建议使用800x450尺寸--window-pos和--window-size设置窗口位置和大小--icon-size设置图标大小建议100px--icon设置.app文件的位置和坐标--app-drop-link设置应用程序链接的位置4. 实战经验与优化建议4.1 常见问题排查create-dmg命令未找到解决方案brew update brew install create-dmg背景图片不显示确保图片格式为PNG路径正确没有透明通道版本号读取错误检查pubspec.yaml格式version: 1.0.014.2 高级定制技巧自定义图标位置 调整--icon和--app-drop-link的坐标参数建议使用以下公式计算x坐标 (窗口宽度 - 图标宽度) / 2 y坐标 (窗口高度 - 图标高度) / 2 - 30多语言支持 可以修改脚本根据系统语言动态设置volnameif [[ $LANG zh_* ]]; then volname安装程序 else volnameInstaller fi自动化版本号 结合CI工具可以自动递增buildNumberbuildNumber$(($buildNumber 1)) sed -i s/version: .*/version: $buildName$buildNumber/ pubspec.yaml5. 集成到CI/CD流程5.1 GitHub Actions配置示例name: MacOS Build on: [push] jobs: build: runs-on: macos-latest steps: - uses: actions/checkoutv2 - name: Install create-dmg run: brew install create-dmg - name: Run build script run: | cd packages ./generate_mac_dmg - name: Upload artifact uses: actions/upload-artifactv2 with: name: macos-build path: packages/products/*.dmg5.2 本地开发优化建议在本地添加pre-commit钩子确保每次提交前版本号已更新#!/bin/sh # .git/hooks/pre-commit # 自动递增build number fullVersion$(grep -i version: pubspec.yaml) buildName$(echo $fullVersion | cut -d -f 2 | cut -d -f 1) buildNumber$(echo $fullVersion | cut -d -f 2) newBuildNumber$(($buildNumber 1)) sed -i s/version: .*/version: $buildName$newBuildNumber/ pubspec.yaml git add pubspec.yaml6. 方案优势与局限性6.1 主要优势一键化操作双击脚本即可完成全流程版本自动管理直接从pubspec.yaml读取版本信息一致性保证每次打包参数固定产出统一可扩展性强易于集成到自动化流程中6.2 当前局限依赖Homebrew环境背景图片需要预先准备窗口参数需要手动调整适配不同项目在实际项目中这个方案已经帮助我们节省了90%的打包时间特别适合需要频繁迭代的Flutter桌面端项目。通过简单的参数调整也可以适配各种不同的UI需求。