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

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"
   

5. 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.

6. 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ýší.

   

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.

   

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.

   

   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
   

3. V terminálu sestavte aplikaci a spusťte ji ve zvoleném simulátoru zadáním _DeviceName vlastnosti MSBuild pomocí -pmož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
   

4. 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ýší.

   

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:

   

   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.

5. V terminálu sestavte aplikaci a spusťte ji na zvoleném zařízení zadáním _DeviceName vlastnosti MSBuild pomocí -pmož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.