Vytvořte svou první aplikaci

V tomto kurzu se dozvíte, jak vytvořit a spustit první aplikaci .NET Multi-Platform App UI (.NET MAUI) v sadě Visual Studio 2022 ve Windows nebo Visual Studio Code ve Windows, macOS nebo Linuxu. Pomůže vám to zajistit správné nastavení vývojového prostředí.

Visual Studio

Požadavky

• Visual Studio 2022 17.8 nebo novější s nainstalovanou úlohou uživatelského rozhraní pro více platforem .NET Další informace naleznete v tématu Instalace.

Vytvořit aplikaci

V tomto kurzu vytvoříte svou první aplikaci .NET MAUI v sadě Visual Studio 2022 a spustíte ji v emulátoru Androidu:

Vývoj aplikací .NET MAUI pro iOS ve Windows vyžaduje hostitele buildu Pro Mac. Pokud konkrétně nepotřebujete cílit na iOS a nemáte Mac, zvažte místo toho, jak začít s Androidem nebo Windows.

V tomto kurzu vytvoříte svou první aplikaci .NET MAUI v sadě Visual Studio a spustíte ji v simulátoru iOS:

V tomto kurzu vytvoříte svou první aplikaci .NET MAUI v sadě Visual Studio 2022 a spustíte ji ve Windows:

1. Spusťte Visual Studio 2022. V úvodním okně klikněte na Vytvořit nový projekt a vytvořte nový projekt:

   

2. V okně Vytvořit nový projekt vyberte MAUI v rozevíracím seznamu Všechny typy projektů, vyberte šablonu aplikace .NET MAUI a klikněte na tlačítko Další:

   

3. V okně Konfigurovat nový projekt pojmenujte projekt, zvolte pro něj vhodné umístění a klikněte na tlačítko Další:

   

4. V okně Další informace zvolte verzi rozhraní .NET, na kterou chcete cílit, a klikněte na tlačítko Vytvořit:

   

5. Počkejte, až se projekt vytvoří a obnoví se jeho závislosti:

   

6. Na panelu nástrojů sady Visual Studio pomocí rozevíracího seznamu Cíl ladění vyberte emulátory Androidu a potom položku Android Emulator:

   

7. Na panelu nástrojů sady Visual Studio stiskněte tlačítko Android Emulator :

   

   Visual Studio začne instalovat výchozí sadu Android SDK a Android Emulator.

8. V okně Android SDK – Licenční smlouva stiskněte tlačítko Přijmout :

   

9. V okně Android SDK – Licenční smlouva stiskněte tlačítko Přijmout :

   

10. V dialogovém okně Řízení uživatelských účtů stiskněte tlačítko Ano:

    

11. V okně Přijetí licence stiskněte tlačítko Přijmout:

    

    Počkejte, až sada Visual Studio stáhne sadu Android SDK a Android Emulator.

12. Na panelu nástrojů sady Visual Studio stiskněte tlačítko Android Emulator :

    

    Visual Studio začne vytvářet výchozí emulátor Androidu.

13. V dialogovém okně Řízení uživatelských účtů stiskněte tlačítko Ano:

    

14. V okně Nové zařízení stiskněte tlačítko Vytvořit :

    

    Počkejte, až visual Studio stáhne, rozbalí a vytvoří emulátor Androidu.

15. Zavřete okno Správce zařízení Androidu:

    

16. Na panelu nástrojů sady Visual Studio stisknutím tlačítka Pixel 5 – API 34 (Android 14.0 – API 33) sestavte a spusťte aplikaci:

    

    Visual Studio spustí emulátor Androidu, sestaví aplikaci a nasadí ji do emulátoru.

    Upozorňující

    Aby se maximalizoval výkon emulátoru Androidu, musí být povolená hardwarová akcelerace. Pokud to neuděláte, dojde k velmi pomalému spuštění emulátoru. Další informace naleznete v tématu Jak povolit hardwarovou akceleraci pomocí emulátorů Androidu (Hyper-V &AEHD).

17. V běžící aplikaci v emulátoru Androidu několikrát stiskněte tlačítko Kliknout na mě a všimněte si, že počet kliknutí na tlačítko se zvýší.

    

Řešení problému

Pokud se vaší aplikaci nepodaří zkompilovat, projděte si řešení známých problémů, které můžou mít řešení vašeho problému. Pokud problém souvisí s emulátorem Androidu, přečtěte si téma Řešení potíží s emulátorem Androidu.

6. Na panelu nástrojů sady Visual Studio vyberte v rozevíracím seznamu Cíl ladění architekturu a potom položku net8.0-windows:

   

7. Na panelu nástrojů sady Visual Studio stisknutím tlačítka Počítače s Windows sestavte a spusťte aplikaci:

   

   Pokud jste nepovolili vývojářský režim, Visual Studio vás vyzve k jeho povolení. V dialogovém okně Povolit vývojářský režim pro Windows kliknutím na nastavení pro vývojáře otevřete aplikaci Nastavení:

   

   V aplikaci Nastavení zapněte vývojářský režim a přijměte právní omezení:

   

   Zavřete aplikaci Nastavení a potom zavřete dialogové okno Povolit vývojářský režim pro Windows .

8. V běžící aplikaci několikrát stiskněte tlačítko Kliknout na mě a všimněte si, že počet kliknutí na tlačítko se zvýší:

   

Řešení problému

Pokud se vaší aplikaci nepodaří zkompilovat, projděte si řešení známých problémů, které můžou mít řešení vašeho problému.

6. V sadě Visual Studio spárujte integrované vývojové prostředí (IDE) s hostitelem sestavení mac. Další informace najdete v tématu Párování s Macem pro vývoj pro iOS.

7. Na panelu nástrojů sady Visual Studio vyberte pomocí rozevíracího seznamu Cíl ladění simulátory iOS a pak konkrétní simulátor iOS:

   

8. Na panelu nástrojů sady Visual Studio stiskněte tlačítko Start pro vybraný simulátor iOS a sestavte a spusťte aplikaci:

   

   Visual Studio sestaví aplikaci, spustí vzdálený simulátor iOS pro Windows a nasadí aplikaci do vzdáleného simulátoru. Další informace o vzdáleném simulátoru iOS pro Windows naleznete v tématu Vzdálený simulátor iOS pro Windows.

9. V běžící aplikaci několikrát stiskněte tlačítko Kliknout na mě a všimněte si, že počet kliknutí na tlačítko se zvýší.

   

Řešení problému

Pokud se vaší aplikaci nepodaří zkompilovat, projděte si řešení známých problémů, které můžou mít řešení vašeho problému.

Aplikace .NET MAUI, které cílí na Mac Catalyst, je možné spustit a ladit pouze pomocí sady Visual Studio 2022 pro Mac.

Visual Studio Code

Požadavky

• Visual Studio Code s nainstalovaným rozšířením .NET MAUI Další informace naleznete v tématu Instalace.

Vytvořit aplikaci

Vytvoření nové aplikace .NET MAUI:

1. Spusťte editor Visual Studio Code. V Průzkumníku klikněte v Průzkumníku na vytvořit projekt .NET. Alternativně vyberte CTRL/CMD+SHIFT+P .NET: Nový projekt....
2. Vyberte aplikaci .NET MAUI nebo aplikaci .NET MAUI Blazor.
3. Vyberte prázdnou složku. Pokud se průzkumník souborů znovu otevře, složka není prázdná.
4. Pojmenujte projekt.
5. Ujistěte se, že se projekt úspěšně načte v Průzkumník řešení, a pak otevřete soubor C# nebo XAML.

Poznámka:

V editoru Visual Studio Code můžete také otevřít existující projekt .NET MAUI prostřednictvím nabídky Otevřít soubor > ... .

Aplikaci byste teď měli vidět v Průzkumník řešení sady C# Dev Kit v editoru Visual Studio Code. Vzhledem k tomu, že rozšíření .NET MAUI závisí na sadě C# Dev Kit, můžete použít všechny její funkce společně s rozšířením .NET MAUI.

Volba cílového zařízení

Pokud chcete vybrat cílové zařízení, klikněte na symbol složených závorek { } v pravém dolním rohu editoru Visual Studio Code. Tento symbol můžete použít ke změně spouštěcího projektu, změně cíle ladění na cokoli platného na vývojovém počítači a připnutí libovolného nastavení na stavový řádek editoru Visual Studio Code:

Spouštěcí projekt a cíl ladění můžete také nastavit na paletě příkazů pomocí ctrl/CMD+SHIFT+P a vyhledat ".NET MAUI".

Bez dalších kroků můžete nasadit na místní vývojový počítač (počítač s Windows nebo macOS s Xcode).

Cílení na Android

Pokud chcete používat emulátory Androidu, nainstalujte a vytvořte emulátor pomocí následujícího postupu:

1. Přejděte v terminálu na <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/adresu .

2. Slouží sdkmanager k instalaci emulátoru.

   Ve Windows spusťte v terminálu následující příkazy:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   V systému macOS spusťte v terminálu následující příkazy:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Poznámka:

   Uvozovky kolem argumentů příkazového sdkmanager řádku jsou důležité.

3. Pak můžete vytvořit nový emulátor na příkazovém řádku pomocí avdmanager androidu.

   Ve Windows spusťte v terminálu následující příkazy:

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   V systému macOS spusťte v terminálu následující příkazy:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Poznámka:

   Uvozovky kolem argumentů příkazového avdmanager řádku jsou důležité.

Můžete také ladit na fyzických zařízeních s Androidem.

Cílení na iOS

Simulátory iOS jsou integrované do Xcode. Pokud chcete stáhnout simulátory, ujistěte se, že je vybraná možnost pro jejich instalaci při prvním spuštění Xcode, nebo přejděte na platformy nastavení > Xcode > a zvolte modul runtime simulátoru, který chcete nainstalovat.

Pokud chcete ladit pomocí zařízení s iOSem, před pokusem o ladění postupujte takto:

1. Zadejte Apple ID v účtu nastavení > Xcode>.
2. Pokud patříte do programu Apple Developer Program, zaregistrujte zařízení u svého týmu.
3. Na zařízení povolte režim vývojáře, jak je popsáno v části Povolení vývojářského režimu na zařízení. Při prvním spuštění aplikace se na zařízení může zobrazit automaticky otevírané okno – ujistěte se, že vyberete Povolit.

Ladění aplikace

Pokud chcete ladit aplikaci, přejděte do nabídky Spustit a ladit editoru Visual Studio Code a vyberte tlačítko Spustit a ladit. Další možností je spustit ladicí relaci pomocí klávesy F5 . Pokud vás Visual Studio Code vyzve k výběru ladicího programu, ujistěte se, že vyberete jazyk C#.

Poznámka:

Ve verzích Preview rozšíření byl ladicí program uveden jako .NET MAUI. Ve stabilní verzi byla tato konfigurace nahrazena jazykem C#.

Ladicí program automaticky zvolí cíl ladění a spouštěcí projekt, který jste nastavili v nabídce složených závorek { } . Pokud jste nic nevybrali, zobrazí se výzva k výběru cíle ladění.

Jakmile aplikace spustí ladění, můžete pomocí integrovaných nástrojů pro ladění editoru Visual Studio Code nastavit zarážky, krok v celém kódu a provádět další kroky.

Další informace

Pokud máte problémy s rozšířením, můžete postupovat podle kroků pro řešení potíží, zobrazit známé problémy nebo poskytnout zpětnou vazbu.

Další kroky

V tomto kurzu jste se naučili, jak vytvořit a spustit první aplikaci .NET Pro víceplatformní aplikace (.NET MAUI).

Pokud se chcete naučit základy vytváření aplikace pomocí .NET MAUI, přečtěte si téma Vytvoření aplikace .NET MAUI. Případně si můžete pro kompletní školicí kurz .NET MAUI prohlédnout si téma Vytváření mobilních a desktopových aplikací pomocí .NET MAUI.