Vytvořte svou první aplikaci

V tomto kurzu se dozvíte, jak vytvořit a spustit první aplikaci .NET s více platformami (.NET MAUI) v sadě Visual Studio 2022 ve Windows nebo sadě Visual Studio 2022 pro Mac. 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í architekturua 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 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 pro Mac

Poznámka:

Visual Studio pro Mac plánujeme do 31. srpna 2024 v souladu s Moderní zásady životního cyklu Od Microsoftu Visual Studio pro Mac 17.6 bude nadále podporován až do 31. srpna 2024 s servisními aktualizacemi problémů se zabezpečením a aktualizovanými platformami od Společnosti Apple. Další informace, včetně alternativních možností vývoje na Macu, najdete v tématu Co se děje s Visual Studio pro Mac?.

Požadavky

• Visual Studio 2022 pro Mac 17.6 s nainstalovanými úlohami .NET, .NET MAUI, Android a iOS Další informace naleznete v tématu Instalace.

Důležité

Pokud chcete používat Visual Studio pro Mac s .NET 8, povolte visual Studio > Preferences > Other Preview Features (Ostatní > funkce > Preview), pokud je nainstalovaná (vyžaduje restartování), použijte sadu .NET 8 SDK.

Vytvořit aplikaci

V tomto kurzu vytvoříte svou první aplikaci .NET MAUI v sadě Visual Studio 2022 pro Mac a spustíte ji na zvolené platformě:

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

   

2. V okně Zvolit šablonu pro nový projekt vyberte MultiplatformNí > aplikace, vyberte šablonu aplikace .NET MAUI a klikněte na tlačítko Pokračovat :

   

3. V okně Konfigurovat novou aplikaci .NET MAUI zvolte verzi rozhraní .NET, na kterou chcete cílit, a klikněte na tlačítko Pokračovat :

   

4. V okně Konfigurovat novou aplikaci .NET MAUI zadejte jako název projektu MyMauiApp , vyberte vhodné umístění pro projekt a klikněte na tlačítko Vytvořit :

   

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

   

6. Visual Studio 2022 pro Mac zobrazí informační panel, pokud váš Mac nemá součásti sady Android SDK. Kliknutím na tlačítko Nainstalovat nainstalujte sadu Android SDK:

   

7. V okně sady Android SDK zaškrtněte políčko Stáhnout a nainstalovat závislosti Androidu automaticky a klikněte na tlačítko Stáhnout a nainstalovat:

   

8. V okně Přijetí licence klikněte na tlačítko Přijmout :

   

   Počkejte, až sada Visual Studio 2022 pro Mac stáhne sadu Android SDK:

9. Na panelu nástrojů sady Visual Studio 2022 pro Mac změňte cíl ladění na Android Emulator:

   

10. Na panelu nástrojů sady Visual Studio 2022 pro Mac stisknutím tlačítka Přehrát sestavte aplikaci a pokuste se ji spustit:

    

    Visual Studio 2022 pro Mac vytvoří aplikaci a pak vytvoří výchozí emulátor Androidu.

11. V okně Nové zařízení klikněte na tlačítko Vytvořit :

    

12. V okně Přijetí licence klikněte na tlačítko Přijmout :

    

    Počkejte na stažení a instalaci emulátoru Androidu v sadě Visual Studio 2022 pro Mac.

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

    

14. Na panelu nástrojů sady Visual Studio 2022 pro Mac změňte cíl ladění na Pixel 5 – API 34 (API 34):

    

15. Na panelu nástrojů sady Visual Studio 2022 pro Mac spusťte aplikaci v emulátoru Androidu stisknutím tlačítka Přehrát :

    

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

16. 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čítka se zvýší:

    

6. Na panelu nástrojů sady Visual Studio 2022 pro Mac se ujistěte, že je cíl ladění nastavený na simulátor iOS:

   

7. Na panelu nástrojů sady Visual Studio 2022 pro Mac stisknutím tlačítka Přehrát spusťte aplikaci ve zvoleném simulátoru iOS:

   

   Visual Studio 2022 pro Mac spustí simulátor iOS, sestaví aplikaci a nasadí aplikaci do simulátoru.

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čítka se zvýší:

   

6. Na panelu nástrojů sady Visual Studio 2022 pro Mac se ujistěte, že je cíl ladění nastavený na My Mac (MacCatalyst):

   

7. V sadě Visual Studio 2022 pro Mac klikněte pravým tlačítkem myši na projekt MyMauiApp a vyberte Upravit soubor projektu. Potom v editoru souborů projektu vložte následující KÓD XML před první <ItemGroup>:

   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-maccatalyst|AnyCPU'">
       <RuntimeIdentifiers>maccatalyst-x64;maccatalyst-arm64</RuntimeIdentifiers>
   </PropertyGroup>
   

8. Na panelu nástrojů sady Visual Studio 2022 pro Mac spusťte aplikaci na Macu stisknutím tlačítka Přehrát :

   

   Visual Studio 2022 pro Mac sestaví a nasadí aplikaci.

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čítka se zvýší:

   

Aplikace .NET MAUI, které cílí na Windows, je možné spouštět a ladit pouze pomocí sady Visual Studio 2022.

Visual Studio Code (Preview)

Poznámka:

Podpora .NET MAUI v editoru Visual Studio Code je stále ve verzi Preview. Vyzkoušejte si to a podělte se o svůj názor.

Instalace rozšíření

Postupujte podle pokynů a nastavte rozšíření .NET MAUI pro Visual Studio Code.

Vytvoření aplikace

Vytvoření nové aplikace .NET MAUI:

1. Klepněte na tlačítko Vytvořit projekt .NET v Průzkumníku, NEBOCTRL/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.

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

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í

Klikněte na symbol { } složených závorek v pravém dolním rohu editoru Visual Studio Code. Tady můžete změnit spouštěcí projekt, změnit cíl ladění na cokoli platného na vývojovém počítači a připnout buď nastavení na stavový řádek editoru Visual Studio Code:

Můžete také nastavit spouštěný projekt a cíl ladění na paletě příkazů pomocí CTRL/CMD+SHIFT+P a hledání ".NET MAUI".

Ve výchozím nastavení můžete nasadit na místní počítač s macOS nebo windows. V systému macOS můžete také nasadit do simulátorů iOSu.

Pokud chcete používat emulátory Androidu, postupujte takto:

1. Přejděte v terminálu na <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/latest/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.

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. Případně můžete spustit F5 ladicí relaci. Pokud vás Visual Studio Code vyzve k výběru ladicího programu, ujistěte se, že jste vybrali .NET MAUI.

Ladicí program automaticky zvolí cíl ladění a spouštěný 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íží, podívat se na 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.