Avalonia macOS打包教程及.app创建方法

Avalonia在macOS上创建.app包需构建标准Bundle结构，配置Info.plist、图标及可执行权限；通过dotnet publish生成发布输出，手动组织MyApp.app目录结构，确保CFBundleExecutable与可执行名一致，最后用codesign签名并公证。

Avalonia在macOS上创建.app包，核心是构建符合Apple规范的Bundle结构，并正确配置Info.plist、图标、可执行权限等要素。不需要Xcode IDE，纯命令行即可完成，但必须在macOS系统（或WSL2+macOS交叉环境）中生成最终.app才能确保签名和运行正常。

准备发布输出（dotnet publish）

先在项目根目录执行跨平台发布，指定macOS运行时标识符：

• 若目标为Intel芯片：`dotnet publish -r osx-x64 -c Release --self-contained true`
• 若目标为Apple Silicon（M1/M2/M3）：`dotnet publish -r osx-arm64 -c Release --self-contained true`
• 输出路径通常为：bin/Release/net8.0/osx-x64/publish/（含MyApp.dll、Avalonia.dll等）

构建标准.app文件夹结构

手动创建或用脚本组织以下层级（以MyApp.app为例）：

• MyApp.app/Contents/Info.plist —— 必须存在，且字段完整
• MyApp.app/Contents/MacOS/MyApp —— 可执行入口（无.dll后缀），需chmod +x
• MyApp.app/Contents/Resources/MyApp.icns —— 图标文件（需提前转成icns格式）

注意：MyApp（可执行名）必须与CFBundleExecutable值完全一致，也应与.dll主程序集名同名（不含.dll）。

关键Info.plist配置项

使用文本编辑器或Xcode打开Info.plist，确保包含以下键值（部分为必需，部分提升兼容性）：

• CFBundleExecutable：如MyApp（对应Contents/MacOS/下的二进制名）
• CFBundleName 和 CFBundleDisplayName：显示名称，后者建议≤15字符
• CFBundleIdentifier：反向DNS格式唯一ID，如com.mycompany.myapp
• CFBundleVersion 与 CFBundleShortVersionString：分别填内部版本号（如1.0.0）和用户版号（如1.0）
• CFBundleIconFile：设为MyApp.icns（含扩展名）
• NSHighResolutionCapable：设为，启用Retina支持
• LSApplicationCategoryType（可选）：如public.app-category.utilities，影响Mac App Store分类

签名与公证（上线必备）

未签名的.app在macOS Catalina及以后默认被阻止运行：

• 用Apple Developer证书签名：codesign --force --deep --sign "Developer ID Application: Your Name" MyApp.app
• 验证签名：codesign --verify --verbose MyApp.app
• 上传公证：xcrun notarytool submit MyApp.app --keychain-profile "AC_PASSWORD" --wait
• 公证通过后 stapler 打包：xcrun stapler staple MyApp.app

若仅本地测试，可临时关闭Gatekeeper：sudo spctl --master-disable（不推荐长期使用）。

整个过程不依赖Xcode图形界面，但Xcode命令行工具（xcode-select --install）和Apple开发者账号是签名环节的硬性前提。打包完成后，双击.app即可运行，效果与原生macOS应用一致。