在 macOS 上打包 Avalonia 应用需通过 dotnet CLI 与 Dotnet.Bundle 工具链生成规范 .app 包:先配置 .csproj 添加 Bundle 元信息及图标,再执行 publish 命令生成 MyApp.app;随后用 codesign 签名、notarytool 公证并 stapler 钉住票证,最终可选打包为 DMG 镜像。

在 macOS 上打包 Avalonia 应用,核心是生成符合 Apple 生态规范的 .app 包,并完成签名与公证(Gatekeeper 要求)。整个流程不依赖 Xcode 图形界面,主要靠 dotnet CLI + Dotnet.Bundle 工具链完成。
配置项目文件(.csproj)
这是打包前提,必须显式声明 macOS 专用属性:
- 添加
Dotnet.Bundle包引用: - 在
中设置 Bundle 元信息(关键字段不能遗漏):MyApp MyApp com.example.myapp 1.0.0 1.0 APPL MyApp AppIcon.icns NSApplication true - 确保
AppIcon.icns文件已放入项目根目录或Resources/目录,并在中标记为或并设CopyToOutputDirectory为PreserveNewest
执行打包命令
在项目根目录终端中运行:
dotnet publish -c Release -r osx-x64 --self-contained true -p:PublishTrimmed=true -p:PublishSingleFile=false
注意:
– -r osx-x64(Intel)或 -r osx-arm64(Apple Silicon)需按目标机器匹配;
– PublishSingleFile=false 是推荐选项,因 macOS Bundle 要求结构化目录(含 Contents/ 子目录),单文件模式不兼容;
– 输出路径默认为 bin/Release/net8.0/osx-x64/publish/,其中会生成 MyApp.app 文件夹。
签名与公证(上架/分发必需)
未签名的 .app 在 macOS 10.15+ 无法启动(“已损坏”提示):
-
代码签名:使用 Apple 开发者证书(需加入 Apple Developer Program):
codesign --force --deep --sign "Developer ID Application: Your Name (ABC123)" --options runtime MyApp.app -
公证(Notarization):上传到 Apple 服务验证安全策略:
xcrun notarytool submit MyApp.app --keychain-profile "AC_PASSWORD" --wait
(需提前配置notarytool凭据) -
Stapling(钉住公证票证):
xcrun stapler staple MyApp.app
可选:制作 DMG 安装镜像
提升用户安装体验,可用脚本自动化生成带拖拽图标的 DMG:
- 准备背景图、应用图标、别名(指向 Applications)
- 使用
hdiutil创建并配置:hdiutil create -volname "MyApp" -srcfolder "MyApp.app" -ov -format UDZO MyApp.dmg - 更完整方案可参考 Avalonia 官方示例中的
bundle.sh脚本(支持自动检测芯片架构)
完成签名和 stapling 后,双击即可正常运行,且能通过 Gatekeeper 验证。整个流程无需 Visual Studio 或 Rider,纯命令行驱动,适合 CI/CD 集成。









