.NET MAUI 教程 - 使用 C# 生成第一个多平台应用

下载并安装

下载并安装 Visual Studio 2022。

下载 Visual Studio 2022

在安装过程中,应选择 .NET Multi-Platform App UI 开发工作负载。使用上面的链接时应预先正确选择所有先决条件,如下图所示:

Visual Studio 安装程序与已选择 .NET 工作负载的移动开发

已有 Visual Studio 2022?

如果已有 Visual Studio 2022,请确保它处于最新状态,并且已安装所需的工作负载:

  • 选择 Windows 徽标键,键入 Visual Studio 安装程序,然后按“输入”。
  • 如果出现提示,则请允许安装程序进行自我更新。
  • 如果 Visual Studio 2022 的更新可用,则将显示“更新”按钮。选择它以在修改安装之前进行更新。本教程仅适用于 Visual Studio 2022 17.12 及更高版本。
  • 找到 Visual Studio 2022 安装并选择 修改
  • 选择 .NET Multi-Platform App UI 开发
  • 选择修改按钮。
  1. 下载并安装 .NET SDK。下载完成后,启动下载项以开始安装。

    下载 .NET 9 SDK x64 (Intel)
    下载 .NET 9 SDK Arm64 (Apple Silicon)

    如果使用的是带有 Apple M1 或 M2 芯片的 Mac,则需要安装 Arm64 版本的 SDK。

  2. 下载和安装 VS Code:

    下载 VS Code

  3. 打开 VS Code,并在 VS Code 的左侧活动栏中选择“扩展”按钮。在搜索栏中键入“MAUI”,选择 .NET MAUI,然后选择 .NET MAUI 扩展页上的“安装”按钮。

    VS Code 的 MAUI 扩展

    此扩展附带 C# 开发工具包和 C# 扩展,这些是运行 .NET MAUI 扩展所必需的。

    VS Code 的 MAUI 扩展依赖项

  4. 运行以下命令,以打开新终端并安装 .NET MAUI 工作负载

    Terminal
    sudo dotnet workload install maui

    如果安装成功,则应该会看到类似于以下内容的输出:

    Terminal
    Successfully installed workload maui

检查是否已正确安装所有内容

设置环境后,打开新的 VS Code 终端。在工具栏中,选择“终端”,然后选择“新终端”。

VS Code 新终端

在终端中,运行以下命令来检查安装。

Terminal
dotnet workload list

在 VS Code 终端中运行 dotnet 工作负载列表命令

如果安装成功,则应该会看到类似于以下内容的输出:

Terminal
Installed Workload Id      Manifest Version      Installation Source
--------------------------------------------------------------------
maui                       8.0.82/8.0.100        SDK 8.0.400

Use `dotnet workload search` to find additional workloads to install.

遇到错误?

如果收到“未将 "dotnet" 识别为内部或外部命令”错误,请确保已打开新的 VS Code 终端。如果重启 VS Code 或重启计算机没有解决问题,请使用页面底部的“我遇到了问题”按钮以获取解决问题的帮助。

安装 Xcode

要生成.NET MAUI 应用,还需要:

  1. Xcode 最新版本

    要查找与 .NET MAUI 兼容的最新版本的 Xcode,请查看此版本参考。转到“Apple 工具”列以查找兼容的 Xcode 的最新版本。

  2. 一个 Apple ID

    如果你没有 Apple ID,可以在 https://appleid.apple.com 创建一个。安装和登录 Xcode 需要 Apple ID。

  3. 安装 Xcode 后,必须打开 Xcode 并同意许可协议,然后安装可选组件(如果出现提示)。

  4. 当系统询问要面向哪些平台进行开发时,请选择平台 macOS 和 iOS,然后选择“下载并安装”

    要求安装 macOS 和 iOS 平台的 Xcode 提示

  5. 运行以下命令,以打开新终端并安装 Xcode 命令行开发人员工具

    Terminal
    xcode-select --install

    当系统提示安装 Xcode 命令行开发人员工具时,请选择“安装”。最后,请同意许可协议

    要求安装命令行开发人员工具的 Xcode 提示

如果一切正常,请选择下面的 继续 按钮以转到下一步。

继续