Sdílet prostřednictvím

Vytvoření aplikace pro iOS pomocí .NET CLI

  • Článek

V tomto kurzu se dozvíte, jak vytvořit a spustit aplikaci .NET Pro víceplatformní aplikace (.NET MAUI) v iOSu pomocí rozhraní příkazového řádku .NET (CLI) v systému macOS:

  1. Pokud chcete vytvářet aplikace .NET MAUI, budete si muset stáhnout a spustit instalační program pro nejnovější modul runtime .NET. Budete také muset stáhnout a nainstalovat verzi Xcode, kterou vyžaduje verze .NET MAUI, kterou používáte. Informace najdete v tématu Verze verzí.

  2. Na počítači Mac otevřete Terminál a zkontrolujte, že máte nainstalovaný nejnovější modul runtime .NET:

    dotnet --version

  3. V terminálu nainstalujte nejnovější veřejný build .NET MAUI:

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

    Tento příkaz nainstaluje nejnovější vydanou verzi rozhraní .NET MAUI, včetně požadovaných sad SDK platformy.

  4. V terminálu vytvořte novou aplikaci .NET MAUI pomocí rozhraní příkazového řádku .NET:

    dotnet new maui -n "MyMauiApp"

  1. V terminálu změňte adresář na MyMauiApp a sestavte a spusťte aplikaci:

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

    Příkaz dotnet build obnoví projekt závislostí, sestaví aplikaci a spustí ho ve výchozím simulátoru.

  2. Ve výchozím simulátoru několikrát stiskněte tlačítko Kliknout na mě a všimněte si, že počet kliknutí na tlačítko se zvýší.

    Aplikace .NET MAUI spuštěná ve výchozím simulátoru iOS

Sestavení s konkrétní verzí Xcode

Pokud máte na Macu nainstalovaných více verzí Xcode, je možné určit, jakou verzi Xcode se má použít při sestavování aplikace. K tomu je možné použít řadu přístupů, ale doporučeným přístupem je nastavit MD_APPLE_SDK_ROOT proměnnou prostředí na cestu verze Xcode.

Upozorňující

Použití xcode-select -s k nastavení verze Xcode, která se má použít, se nedoporučuje.

MD_APPLE_SDK_ROOT Nastavení proměnné prostředí po dobu trvání aktuální relace terminálu:

  1. Otevřete terminálovou aplikaci.

  2. Zadejte následující příkaz, nahraďte svoji verzi Xcode a stiskněte Enter:

    export MD_APPLE_SDK_ROOT=/Applications/Xcode_14.1.0.app

Pokud chcete tuto proměnnou prostředí nastavit trvale, můžete příkaz přidat export do profilu prostředí, například .zprofile.

Spuštění aplikace v konkrétním simulátoru

Aplikaci .NET MAUI pro iOS je možné spustit na konkrétním simulátoru iOSu z Macu tím, že poskytne své jedinečné ID zařízení (UDID):

  1. Na macu otevřete Xcode, vyberte položku nabídky Zařízení a simulátory windows > a potom kartu Simulátory.

    Snímek obrazovky s kartou Simulátory Xcode

  2. Klikněte pravým tlačítkem myši na zvolený simulátor a vyberte Kopírovat identifikátor a zkopírujte identifikátor UDID do schránky.

    Snímek obrazovky s možností nabídky kopírovat identifikátor v Xcode

    Případně můžete načíst seznam hodnot UDID spuštěním simctl list příkazu:

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

  1. V terminálu sestavte aplikaci a spusťte ji ve zvoleném simulátoru zadáním _DeviceName vlastnosti MSBuild pomocí -p možnosti MSBuild:

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

    Například pomocí následujícího příkazu sestavte aplikaci a spusťte ji v simulátoru iPhone 13 Pro:

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

  2. Ve zvoleném simulátoru několikrát stiskněte tlačítko Kliknout na mě a všimněte si, že počet kliknutí na tlačítko se zvýší.

    Aplikace .NET MAUI spuštěná v simulátoru iPhone 13 Pro

Spuštění aplikace na zařízení

Před nasazením aplikace pro iOS do zařízení musí být zřízeno zařízení. Další informace najdete v tématu Zřizování zařízení pro iOS. Po zřízení zařízení se na zařízení z Macu dá spustit aplikace .NET MAUI pro iOS tím, že poskytne jedinečné ID zařízení (UDID):

  1. Připojte zařízení k místnímu Macu pomocí kabelu USB.

  2. Otevřete Xcode a přejděte do okna > Zařízení a simulátory.

  3. V Xcode vyberte kartu Zařízení a ze seznamu připojených zařízení vyberte zařízení.

  4. V Xcode zkopírujte hodnotu Identifikátor do schránky:

    Zařízení Xcode a okno simulátoru se zvýrazněným umístěním řetězce identifikátoru iOS

    Případně klikněte pravým tlačítkem myši na zařízení a vyberte Kopírovat identifikátor a zkopírujte identifikátor UDID do schránky.

  1. V terminálu sestavte aplikaci a spusťte ji na zvoleném zařízení zadáním _DeviceName vlastnosti MSBuild pomocí -p možnosti MSBuild:

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

    Nahraďte "MY_SPECIFIC_UDID" identifikátorem zařízení, který jste zkopírovali do schránky.