macOS平台.NET MAUI开发入门：从设置到应用发布-优快云博客

macOS平台.NET MAUI开发入门：从设置到应用发布

【免费下载链接】maui dotnet/maui: .NET MAUI (Multi-platform App UI) 是.NET生态下的一个统一跨平台应用程序开发框架，允许开发者使用C#和.NET编写原生移动和桌面应用，支持iOS、Android、Windows等操作系统。项目地址: https://gitcode.com/GitHub_Trending/ma/maui

.NET MAUI（Multi-platform App UI）是.NET生态下的统一跨平台应用开发框架，允许开发者使用C#和.NET编写原生移动和桌面应用，支持iOS、Android、Windows及macOS等操作系统。本文将详细介绍在macOS平台上搭建.NET MAUI开发环境并完成应用发布的完整流程，帮助开发者快速掌握跨平台应用开发的关键步骤。

开发环境准备

系统要求

macOS开发环境需满足以下基本要求：

macOS 13 (Ventura) 或更高版本
Xcode 15 或更高版本（用于iOS和macOS应用构建）
.NET SDK 8.0 或更高版本

工具链安装

1. 安装.NET SDK

通过终端执行以下命令安装最新版.NET SDK：

brew install dotnet-sdk

安装完成后，验证版本信息：

dotnet --version

2. 安装MAUI工作负载

.NET MAUI开发需要特定的工作负载支持，执行以下命令安装：

dotnet workload install maui-desktop

该命令将安装macOS平台所需的所有MAUI组件，包括Mac Catalyst支持。工作负载详情可参考src/Workload/README.md。

3. 配置Visual Studio Code

安装Visual Studio Code：从官网下载并安装
安装MAUI扩展：在VS Code中搜索并安装**.NET MAUI Dev Kit**扩展
安装C#扩展：确保C#开发支持正常工作

项目创建与运行

使用模板创建项目

基本命令创建

通过终端执行以下命令创建新的MAUI项目：

dotnet new maui -n MyFirstMauiApp
cd MyFirstMauiApp

模板参数说明

MAUI提供多种项目模板，可通过-t参数指定：

maui：默认MAUI应用模板
maui-blazor：Blazor混合应用模板
maui-library：类库项目模板

详细模板参数可参考src/Templates/README.md。

运行macOS应用

在项目目录中执行以下命令启动应用：

dotnet build -t:Run -f net8.0-maccatalyst

首次运行会自动生成并配置macOS应用所需的签名和权限文件。

应用调试与测试

调试配置

在VS Code中打开项目，配置.vscode/launch.json文件：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "MacCatalyst",
            "type": "maui",
            "request": "launch",
            "preLaunchTask": "maui: Build",
            "targetFramework": "net8.0-maccatalyst"
        }
    ]
}

测试框架集成

MAUI提供完整的测试支持，可通过以下命令运行单元测试：

dotnet test -f net8.0-maccatalyst

测试相关配置可参考src/Controls/tests/ManualTests/README.md。

应用打包与发布

构建发布版本

执行以下命令生成macOS应用包：

dotnet publish -f net8.0-maccatalyst -c Release -o ./publish

生成的应用包位于publish目录下，文件扩展名为.app。

代码签名配置

macOS应用发布需要Apple开发者账号签名，在项目文件中添加签名配置：

<PropertyGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">
    <CodeSigningKey>Developer ID Application: Your Name (ABC123XYZ)</CodeSigningKey>
    <CodesignProvision>Automatic</CodesignProvision>
</PropertyGroup>

发布到Mac App Store

生成.pkg安装包：

productbuild --component ./publish/MyFirstMauiApp.app /Applications --sign "Developer ID Installer: Your Name (ABC123XYZ)" MyFirstMauiApp.pkg

使用Transporter应用上传至App Store Connect
在App Store Connect中完成应用信息填写和提交审核

常见问题解决

工作负载安装失败

若出现工作负载安装错误，可尝试清理缓存后重新安装：

dotnet workload clean
dotnet workload install maui-desktop --ignore-failed-sources

模拟器运行问题

确保Xcode已安装必要的模拟器运行时：

xcodebuild -installComponents

截图测试验证

MAUI提供UI自动化测试功能，截图验证流程可参考docs/assets/VerifyScreenshotsPart1.png至docs/assets/VerifyScreenshotsPart5.png系列图示。

总结

通过本文介绍的步骤，开发者可以在macOS平台快速搭建起完整的.NET MAUI开发环境，从项目创建、调试到最终发布全流程。MAUI框架的跨平台特性使得一套代码可同时运行在iOS、Android和桌面平台，极大提升了开发效率。更多高级特性和最佳实践可参考官方文档和示例项目：

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考