Avalonia怎么在macOS上打包应用 Avalonia macOS发布方法

在 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/ 目录,并在 中标记为 并设 CopyToOutputDirectoryPreserveNewest

执行打包命令

在项目根目录终端中运行:

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 集成。