Freigeben über


Erstellen einer Mac Catalyst-App mit .NET CLI

In diesem Lernprogramm erfahren Sie, wie Sie eine .NET Multi-Platform App UI(.NET MAUI)-App auf Mac Catalyst mit .NET Command Line Interface (CLI) unter macOS erstellen und ausführen:

  1. Zum Erstellen von .NET MAUI-Apps müssen Sie das Installationsprogramm für die neueste .NET-Runtime herunterladen und ausführen. Sie müssen außerdem die Xcode-Version installieren, die von Ihrer verwendeten .NET MAUI-Version benötigt wird. Weitere Informationen finden Sie unter Releaseversionen.

  2. Öffnen Sie auf Ihrem Mac Terminal und überprüfen Sie, ob Sie die neueste .NET-Laufzeitumgebung installiert haben:

    dotnet --version
    
  3. Installieren Sie in Terminal den neuesten öffentlichen Build von .NET MAUI:

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

    Dieser Befehl installiert die neueste veröffentlichte Version von .NET MAUI, einschließlich der erforderlichen Plattform-SDKs.

  4. Erstellen Sie in Terminal eine neue .NET MAUI-App mit .NET CLI:

    dotnet new maui -n "MyMauiApp"
    
  1. In Terminal ändern Sie das Verzeichnis zu MyMauiApp und erstellen und starten die App:

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

    Der dotnet build-Befehl stellt die Projektabhängigkeiten wieder her, erstellt die Anwendung und startet sie.

    Falls ein Buildfehler und eine Warnung angezeigt wird, dass das Xcode-App-Bündel nicht gefunden wurde, müssen Sie möglicherweise den folgenden Befehl ausführen:

    xcode-select --reset
    
  2. Drücken Sie in der ausgeführten App mehrmals auf die Schaltfläche Click me, und beobachten Sie, dass die Anzahl der Schaltflächenklicks erhöht wird.

    .NET MAUI-App, die auf dem Mac ausgeführt wird.

Erstellen von Apps mit einer bestimmten Version von Xcode

Wenn auf Ihrem Mac mehrere Xcode-Versionen installiert sind, können Sie angeben, welche Xcode-Version beim Erstellen der App verwendet werden soll. Es gibt eine Reihe von Ansätzen, mit denen dies erreicht werden kann, aber der empfohlene Ansatz besteht darin, die MD_APPLE_SDK_ROOT-Umgebungsvariable auf den Pfad der Xcode-Version festzulegen.

Warnung

Die Verwendung von xcode-select -s zum Festlegen der zu verwendenden Xcode-Version wird nicht empfohlen.

So legen Sie die Umgebungsvariable MD_APPLE_SDK_ROOT für die Dauer der aktuellen Terminalsitzung fest:

  1. Öffnen Sie die Terminalanwendung.

  2. Geben Sie den folgenden Befehl ein, und geben Sie dabei Ihre Version von Xcode an. Drücken Sie dann die EINGABETASTE:

    export MD_APPLE_SDK_ROOT=/Applications/Xcode_14.1.0.app
    

Wenn Sie diese Umgebungsvariable dauerhaft festlegen möchten, können Sie dem Shellprofil den Befehl export hinzufügen, z. B. als .zprofile.