Freigeben über

Erstellen einer iOS-App mit .NET CLI

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie eine .NET Multi-Platform App UI (.NET MAUI)-App auf iOS mithilfe der .NET-Befehlszeilenschnittstelle (CLI) auf macOS erstellen und ausführen:

  1. Um .NET MAUI-Apps zu erstellen, müssen Sie das Installationsprogramm für die neueste .NET-Laufzeitumgebung 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. Wechseln Sie in Terminal in das Verzeichnis MyMauiApp und erstellen und starten Sie die App:

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

    Der Befehl dotnet build stellt das Projekt und die Abhängigkeiten wieder her, erstellt die App und startet sie im Standardsimulator.

  2. Drücken Sie im Standardsimulator mehrmals die Schaltfläche Klicken und achten Sie darauf, dass die Anzahl der Schaltflächenklicks aufsteigend gezählt wird.

    .NET MAUI-App, die im iOS-Standardsimulator 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.

Starten der App in einem bestimmten Simulator

Eine .NET MAUI iOS-App kann auf einem bestimmten iOS-Simulator von einem Mac aus gestartet werden. Dazu muss die eindeutige Geräte-ID (UDID) angegeben werden:

  1. Öffnen Sie auf Ihrem Mac Xcode, wählen Sie den Menüpunkt Windows >Geräte und Simulatoren und dann die Registerkarte Simulatoren aus.

    Screenshot der Registerkarte für Xcode-Simulatoren.

  2. Klicken Sie mit der rechten Maustaste auf den ausgewählten Simulator und wählen Sie Kopieren des Bezeichners, um die UDID in die Zwischenablage zu kopieren.

    Screenshot der Menüoption zum Kopieren der ID in Xcode.

    Sie können auch eine Liste der UDID-Werte anzeigen, indem Sie den Befehl simctl list ausführen:

    /Applications/Xcode.app/Contents/Developer/usr/bin/simctl list

  1. Erstellen Sie in Terminal die App, und führen Sie sie auf Ihrem ausgewählten Simulator aus, indem Sie die MSBuild-Eigenschaft _DeviceName mithilfe der MSBuild-Option -p angeben:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=MY_SPECIFIC_UDID

    Verwenden Sie beispielsweise den folgenden Befehl, um die App zu erstellen und sie auf dem iPhone 13 Pro Simulator auszuführen:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=E25BBE37-69BA-4720-B6FD-D54C97791E79

  2. Drücken Sie in dem von Ihnen gewählten Simulator mehrmals die Schaltfläche Klicken und achten Sie darauf, dass die Anzahl der Schaltflächenklicks aufsteigen gezählt wird.

    .NET MAUI-App, die im iPhone 13 Pro-Simulator ausgeführt wird.

Starten der App auf einem Gerät

Ein Gerät muss bereitgestellt werden, bevor eine iOS-App darauf installiert werden kann. Weitere Informationen finden Sie unter Gerätebereitstellung für iOS. Sobald ein Gerät bereitgestellt wurde, kann eine .NET MAUI iOS-App auf dem Gerät von einem Mac aus gestartet werden. Dazu muss die eindeutige Geräte-ID (UDID) angegeben werden:

  1. Verbinden Sie Ihr Gerät mit einem USB-Kabel mit Ihrem lokalen Mac.

  2. Öffnen Sie Xcode, und navigieren Sie zu Fenster >Geräte und Simulatoren.

  3. Wählen Sie in Xcode die Registerkarte Geräte und wählen Sie das Gerät aus der Liste der verbundenen Geräte aus.

  4. Kopieren Sie in Xcode den Bezeichner-Wert in die Zwischenablage:

    Xcode-Fenster mit Geräten und Simulatoren und hervorgehobenem iOS-Bezeichner

    Alternativ können Sie auch mit der rechten Maustaste auf Ihr Gerät klicken und Kopieren des Bezeichners auswählen, um die UDID in die Zwischenablage zu kopieren.

  1. Erstellen Sie in Terminal die App, und führen Sie sie auf Ihrem ausgewählten Gerät aus, indem Sie die MSBuild-Eigenschaft _DeviceName mithilfe der MSBuild-Option -p angeben:

    dotnet build -t:Run -f net8.0-ios -p:RuntimeIdentifier=ios-arm64 -p:_DeviceName=MY_SPECIFIC_UDID

    Ersetzen Sie MY_SPECIFIC_UDID durch den Gerätebezeichner, den Sie in die Zwischenablage kopiert haben.