使用 .NET CLI 生成 Mac Catalyst 应用

本教程介绍如何使用 macOS 上的 .NET 命令行接口 (CLI) 在 Mac Catalyst 上创建和运行 .NET Multi-platform App UI (.NET MAUI) 应用:

  1. 若要创建 .NET MAUI 应用,需要为最新的.NET 运行时下载并运行安装程序。 你还需要下载并安装最新版本的 Xcode,该版本也可从 Mac 上的 App Store 应用获得。

  2. 在 Mac 上,打开终端,并检查是否已安装最新 .NET 运行时:

    dotnet --version
    
  3. 终端中,安装 .NET MAUI 的最新公共版本:

    sudo dotnet workload install maui --source https://api.nuget.org/v3/index.json
    

    此命令将安装最新发布的 .NET MAUI 版本,包括所需的平台 SDK。

  4. 终端中,使用 .NET CLI 创建新的 .NET MAUI 应用:

    dotnet new maui -n "MyMauiApp"
    
  1. 终端中,将目录更改为 MyMauiApp,然后生成并运行应用:

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

    dotnet build 命令将还原项目依赖项、生成应用并启动它。

    如果看到生成错误和关于无法找到 Xcode 应用捆绑包的警告,则可能需要运行以下命令:

    xcode-select --reset
    
  2. 在正在运行的应用中,按“单击我”按钮多次,并观察按钮单击次数是否递增。

    在 Mac 上运行的 .NET MAUI 应用。

使用特定版本的 Xcode 进行生成

如果在 Mac 上安装了多个版本的 Xcode,则可以指定生成应用时应使用哪个 Xcode 版本。 有许多方法可用于实现此目的,但建议的方法是将 MD_APPLE_SDK_ROOT 环境变量设置为 Xcode 版本的路径。

警告

不建议使用 xcode-select -s 设置 Xcode 的版本。

若要在当前终端会话的持续时间内设置 MD_APPLE_SDK_ROOT 环境变量:

  1. 打开“终端”应用程序

  2. 键入以下命令,替换为你的 Xcode 版本,然后按 Enter:

    export MD_APPLE_SDK_ROOT=/Applications/Xcode_14.1.0.app
    

如果要永久性设置此环境变量,则可以将 export 命令添加到你的 shell 配置文件,例如 .zprofile。