Instalace

Vývoj nativních multiplatformních aplikací .NET multiplatformních aplikací (.NET MAUI) vyžaduje Visual Studio 2022 17.12 nebo novější nebo nejnovější Visual Studio Code s rozšířením .NET MAUI.

Visual Studio

Pokud chcete začít vyvíjet nativní multiplatformní aplikace .NET MAUI ve Windows, nainstalujte sadu Visual Studio 2022 17.12 nebo novější podle pokynů pro instalaci .

Požadavky

• Visual Studio 2022 17.12 nebo novější Informace o podporovaných operačních systémech, hardwaru, podporovaných jazycích a dalších požadavcích a doprovodných materiálech najdete v tématu Požadavky na systém pro Visual Studio 2022.

Pokud chcete vytvářet, podepisovat a nasazovat aplikace .NET MAUI pro iOS a Mac Catalyst, budete také potřebovat:

• Mac, který je kompatibilní s Xcode. Další informace najdete v dokumentaci k minimálním požadavkům společnosti Apple.
• Konkrétní verze Xcode, která závisí na verzi rozhraní .NET MAUI, kterou používáte. Informace najdete v tématu Verze verzí.
• Apple ID a placená registrace programu Apple Developer Program. Apple ID se vyžaduje k nasazení aplikací do zařízení a k odesílání aplikací do Apple Storu.

Pokud chcete také nasadit ladicí buildy aplikace přímo z Windows do zařízení s iOSem s horkým restartováním, budete potřebovat:

• Účet Apple Developer a placená registrace programu Apple Developer Program.

Instalace

1. Pokud chcete vytvářet aplikace .NET MAUI, budete si muset stáhnout nejnovější verzi sady Visual Studio 2022:

   • Stáhnout Visual Studio 2022 Community

   • Stáhnout Visual Studio 2022 Professional

   • Stáhnout Visual Studio 2022 Enterprise

2. Nainstalujte sadu Visual Studio nebo upravte stávající instalaci prostřednictvím instalačního programu sady Visual Studio a nainstalujte sadu funkcí vývoje uživatelského rozhraní multiplatformních aplikací .NET s výchozími volitelnými možnostmi instalace:

   

Visual Studio Code

Pokud chcete začít vyvíjet nativní multiplatformní aplikace .NET MAUI na Windows, macOS nebo Linuxu, nainstalujte nejnovější Visual Studio Code podle instalačních kroků a.

Požadavky

K sestavení, podepsání a nasazení aplikací .NET MAUI pro iOS a Mac Catalyst budete potřebovat:

• Mac, který je kompatibilní s Xcode. Další informace najdete v dokumentaci k minimálním požadavkům společnosti Apple.
• Konkrétní verze Xcode, která závisí na verzi rozhraní .NET MAUI, kterou používáte. Informace najdete v tématu Verze verzí.
• Apple ID a placená registrace programu Apple Developer Program. Apple ID se vyžaduje k nasazení aplikací do zařízení a k odesílání aplikací do Apple Storu.

Instalace editoru Visual Studio Code

1. Pokud chcete vytvářet aplikace .NET MAUI, budete si muset stáhnout nejnovější verzi editoru Visual Studio Code:

   • Stáhnout Visual Studio Code

2. Nainstalujte Visual Studio Code. Podrobné pokyny k instalaci editoru Visual Studio Code najdete v tématu Visual Studio Code ve Windows, Visual Studio Code v systému macOSa Visual Studio Code v linuxovém.

Instalace rozšíření .NET MAUI

Než budete moct vytvářet aplikace .NET MAUI v editoru Visual Studio Code, budete muset nainstalovat rozšíření .NET MAUI:

1. Spusťte Visual Studio Code.

2. V editoru Visual Studio Code přejděte na kartu Rozšíření a vyhledejte ".NET MAUI". Potom vyberte rozšíření .NET MAUI a nainstalujte ho stisknutím tlačítka Nainstalovat:

   

   Rozšíření .NET MAUI automaticky nainstaluje rozšíření C# Dev Kit a C# , které jsou potřeba ke spuštění rozšíření .NET MAUI. Další informace o sadě C# Dev Kit naleznete v tématu C# Dev Kit for Visual Studio Code.

Připojte svůj účet k sadě C# Dev Kit

Použití sady C# Dev Kit vyžaduje, abyste se přihlásili pomocí účtu Microsoft, který má aktivní předplatné sady Visual Studio:

1. Na záložce Vítejte pro zahájení práce s .NET MAUI stiskněte tlačítko Připojit:

   

   Podle pokynů se přihlaste ke svému účtu Microsoft. Pro více informací si přečtěte Přihlášení do C# Dev Kit.

Další informace o licencování sady C# Dev Kit najdete v tématu nejčastější dotazy k sadě C# Dev Kit.

Nastavení prostředí .NET

K vývoji aplikací .NET MAUI budete potřebovat nainstalovanou sadu .NET SDK na svém počítači. Pokud na svém počítači nemáte nainstalovanou sadu .NET SDK, upřednostňovaný přístup k jeho instalaci ve Windows je prostřednictvím instalačního programu sady Visual Studio. Další informace naleznete v tématu Instalace.

Případně můžete sadu .NET SDK nainstalovat ručně:

1. Stáhněte instalační program .NET.

2. Nainstalujte sadu .NET SDK spuštěním instalačního programu .NET. Další informace najdete v tématu Instalace .NET ve Windows, Linuxu a macOS.

   Spropitné

   Na Linuxu můžete nainstalovat .NET SDK pomocí skriptové instalace podle pokynů.

Ověření, že je nainstalovaná sada .NET SDK:

1. Otevřete terminál.

2. V terminálu spusťte následující příkaz:

   dotnet --version
   

   Měla by se zobrazit verze sady .NET SDK, kterou jste nainstalovali.

   Poznámka:

   Před ověřením, že je nainstalovaná sada .NET SDK, může být nutné restartovat počítač.

Nastavení prostředí .NET MAUI

K vývoji aplikací .NET MAUI budete potřebovat nainstalovanou sadu .NET MAUI SDK. Pokud na svém počítači nemáte nainstalovanou sadu .NET MAUI SDK, upřednostňovaný přístup k jeho instalaci ve Windows je prostřednictvím instalačního programu sady Visual Studio. Další informace naleznete v tématu Instalace.

Alternativně můžete postupovat podle těchto kroků a ručně nainstalovat sadu .NET MAUI SDK:

1. Otevřete terminál.

2. V terminálu ve Windows spusťte následující příkaz:

   dotnet workload install maui
   

   V terminálu v macOS spusťte následující příkaz:

   sudo dotnet workload install maui
   

   V terminálu v Linuxu spusťte následující příkaz:

   dotnet workload install maui-android
   

Ověření, že je nainstalovaná sada .NET MAUI SDK:

1. Otevřete terminál.

2. V terminálu spusťte následující příkaz:

   dotnet workload list
   

   Na operačních systémech Windows a macOS byste měli vidět ID úlohy maui uvedené vedle nainstalované verze. Pokud jste ho ale nainstalovali prostřednictvím Instalační služby sady Visual Studio v systému Windows, jsou uvedené následující ID úloh:

   android
   maui-windows
   maccatalyst
   ios
   

   Na Linuxu byste měli vidět ID práce maui-android uvedené společně s instalovanou verzí.

Nastavení cílových platforem

Pokud chcete sestavit a ladit aplikaci .NET MAUI, budete muset mít platnou cílovou platformu vzhledem k operačnímu systému vašeho vývojového počítače. Následující tabulka uvádí podporované cílové platformy v jednotlivých operačních systémech:

Váš operační systém	Podporované cílové platformy
Windows	Windows, Android
macOS	Android, iOS, macOS
Operační systém Linux	Android

Vytvoření aplikace .NET MAUI pro Android a pro platformy Apple vyžaduje, abyste provedli další nastavení a konfiguraci.

Android

Proces nastavení počítače pro vývoj .NET MAUI v Androidu pomocí editoru Visual Studio Code je:

• Stáhněte a nainstalujte sadu Java SDK. Další informace najdete v tématu Stažení a instalace sady Java JDK.
• Stáhněte a nainstalujte sadu Android SDK. Další informace najdete v tématu Stažení a instalace sady Android SDK.
• Stáhněte a nainstalujte emulátor Androidu. Další informace najdete v tématu Stažení a instalace emulátoru androidu.

Stažení a instalace sady Java SDK

Pokud chcete stáhnout a nainstalovat sadu Java SDK a nakonfigurovat Visual Studio Code tak, aby ji používala:

1. Stáhněte a nainstalujte Microsoft OpenJDK 17. Informace o instalaci Microsoft Build of OpenJDK naleznete v tématu Instalace Microsoft Build of OpenJDK.

   Alternativně můžete místo ručního stahování a instalace sady Java SDK použít cíl sestavení InstallAndroidDependencies k instalaci sady Java SDK (a sady Android SDK). Další informace naleznete v tématu Použití cíle InstallAndroidDependencies.

   Důležitý

   Ujistěte se, že jste si poznamenali umístění, do kterého je nainstalovaná sada OpenJDK, protože je to nutné v dalším kroku.

2. Ujistěte se, že jste pomocí jednoho z následujících přístupů nakonfigurovali cestu k OpenJDK:

   1. Nastavte proměnnou prostředí JAVA_HOME tak, aby definovala cestu sady Java SDK pro váš počítač. Toto je doporučený přístup, který definuje cestu sady Java SDK na úrovni počítače.

      Poznámka:

      Pokud nainstalujete OpenJDK ve Windows pomocí MSI, můžete zvolit, aby instalační program nastavil proměnnou prostředí JAVA_HOME.

   2. V editoru Visual Studio Code stiskněte kombinaci kláves Ctrl+Shift+P ve Windows nebo Cmd+Shift+P v macOS a pak vyberte .NET MAUI: Nakonfigurujte Android a pak vyberte umístění sady Java SDK a nastavte cestu sady Java SDK na úrovni uživatele nebo pracovního prostoru.

   3. Nakonfigurujte cestu sady Java SDK v souboru .csproj nastavením vlastnosti $(JavaSdkDirectory) MSBuild na cestu OpenJDK. Tím se definuje cesta sady Java SDK na úrovni projektu.

Stažení a instalace sady Android SDK

Pokud chcete stáhnout a nainstalovat sadu Android SDK a nakonfigurovat Visual Studio Code tak, aby ji používala:

1. Stáhněte a nainstalujte sadu Android SDK pomocí jednoho z následujících přístupů:

   1. Stáhněte a nainstalujte sadu Android SDK vytvořením nového projektu .NET MAUI a pak použijte cíl sestavení InstallAndroidDependencies, který pomáhá nastavit vaše prostředí Androidu. Toto je doporučený přístup. Další informace naleznete v tématu Použití cíle InstallAndroidDependencies.
   2. Stáhněte a nainstalujte Android SDK ve Windows instalací vývojové úlohy .NET MAUI v sadě Visual Studio, a pak vytvoření a spuštění aplikace .NET MAUI na Androidu. Tento proces zajistí instalaci sady Android SDK a emulátoru Androidu.
   3. Stáhněte a nainstalujte sadu Android SDK prostřednictvím sady Android Studio. Další informace najdete v části Instalace Android Studio na webu developer.android.com.
   4. Stáhněte a nainstalujte sadu Android SDK prostřednictvím preferovaného správce balíčků v Linuxu.

2. Pomocí jednoho z následujících přístupů se ujistěte, že jste nakonfigurovali cestu k sadě Android SDK:

   1. Nastavte proměnnou prostředí ANDROID_HOME tak, aby definovala cestu sady Android SDK pro váš počítač. Toto je doporučený přístup, který definuje cestu sady Android SDK na úrovni počítače.
   2. V editoru Visual Studio Code stiskněte kombinaci kláves Ctrl+Shift+P ve Windows nebo Cmd+Shift+P v systému macOS a pak vyberte .NET MAUI: Nakonfigurujte Android a pak vyberte umístění sady Android SDK a nastavte cestu sady Android SDK na úrovni uživatele nebo pracovního prostoru.
   3. Cestu k sadě Android SDK v souboru .csproj nakonfigurujte nastavením vlastnosti $(AndroidSdkDirectory) MSBuild na cestu k sadě Android SDK. Tím se definuje cesta sady Android SDK na úrovni projektu.

3. V editoru Visual Studio Code ověřte, že je vaše prostředí Androidu správně nakonfigurované, a to stisknutím kombinace kláves Ctrl+Shift+P ve Windows nebo Cmd+Shift+P v systému macOS a následným výběrem možnosti .NET MAUI: Konfigurace Androidu a následným aktualizací prostředí Android. Všechny zjištěné chyby musí být vyřešeny:

   • Na paletě příkazů vyberte .NET MAUI: Nakonfigurujte Androidu a potom Vyberte umístění sady Android SDK a Vyberte umístění sady Android SDK a ověřte, že správně odkazují na instalace každého. Pokud nainstalujete sady SDK prostřednictvím sady Visual Studio, openJDK se bude nacházet v C:\Program Files\Microsoft a sada Android SDK bude umístěna v C:\Program Files (x86)\Android\android-sdk.
   • Ujistěte se, že složka sady Android SDK obsahuje podsložky, jako jsou nástroje sestavení, nástroje příkazového řádkua nástroje platformy.
   • Ujistěte se, že složka OpenJDK obsahuje podsložky, jako jsoubin, libatd.
   • Ujistěte se, že je proměnná prostředí ANDROID_HOME nastavená na cestu sady Android SDK.
   • Ujistěte se, že je proměnná prostředí JAVA_HOME nastavená na cestu ke knihovně Java SDK.
   • Pokud se licence pro Android nepřijaly, přejděte v terminálu se zvýšenými oprávněními do složky cmdline-tools/{version}/bin a spusťte sdkmanager --licenses a postupujte podle pokynů rozhraní příkazového řádku.

Použití cíle InstallAndroidDependencies

Doporučeným přístupem k instalaci požadovaných závislostí pro váš projekt .NET MAUI na Androidu je spuštění cíle MSBuild InstallAndroidDependencies. Tato úloha vám nainstaluje Android SDK, pokud ještě není nainstalovaná.

V terminálu vytvořte nový projekt .NET MAUI:

dotnet new maui -n "MyMauiApp"

V terminálu změňte adresář na MyMauiAppa při zadávání cíle sestavení InstallAndroidDependencies sestavte aplikaci:

cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True

Poznámka:

Cíl InstallAndroidDependencies MSBuild může také nainstalovat sadu Java SDK, pokud je zadána vlastnost JavaSdkDirectory MSBuild.

Ve výše uvedeném příkazu:

• -p:AndroidSdkDirectory="/path/to/sdk" nainstaluje nebo aktualizuje závislosti Androidu na zadanou absolutní cestu. Navrhované cesty jsou %LOCALAPPDATA%/Android/Sdk ve Windows a $HOME/Library/Android/sdk v systému macOS.
• -p:AcceptAndroidSDKLicenses=True přijímá požadované licence androidu pro vývoj.
• (volitelné) -p:JavaSdkDirectory="/path/to/sdk" nainstaluje sadu Java SDK do zadané absolutní cesty.

Snažte se vyhnout použití cest obsahujících mezery nebo jiné znaky než ASCII.

Stažení a instalace emulátoru Androidu

Stažení a instalace emulátoru Androidu, na kterém se mají aplikace spouštět:

1. V terminálu přejděte na {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/.

2. V terminálu pomocí příkazu sdkmanager stáhněte a nainstalujte emulátor Androidu:

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

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

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

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
   

   Poznámka:

   Výše uvedený příkaz předpokládá Apple Silicon Mac. Pro Intel Mac nahraďte arm64-v8ax86_64.

   Další informace o příkazu sdkmanager najdete v tématu sdkmanager na developer.android.com.

3. V terminálu pomocí příkazu avdmanager vytvořte nový emulátor Androidu:

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

   avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
   

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

   ./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
   

   Poznámka:

   Výše uvedený příkaz předpokládá Apple Silicon Mac. Pro Intel Mac nahraďte arm64-v8ax86_64.

   Další informace o příkazu avdmanager naleznete v tématu avdmanager na developer.android.com.

iOS a macOS

Nastavit Mac pro vývoj .NET MAUI pro systémy iOS a Mac Catalyst pomocí Visual Studio Code:

1. Nainstalujte verzi Xcode, kterou vyžaduje verze rozhraní .NET MAUI, kterou používáte. Informace najdete v tématu Verze verzí. Nejnovější stabilní verzi Xcode si můžete stáhnout z Apple App Storu.

2. V terminálu spuštěním následujícího příkazu získejte nástroje příkazového řádku Xcode:

   xcode-select --install
   

3. Spusťte Xcode a přijměte všechny licenční smlouvy. Pokud se simulátory nezačnou instalovat, přejděte na Xcode > Nastavení > Komponenty a nainstalujte vámi zvolená běhová prostředí simulátoru.

4. V editoru Visual Studio Code ověřte, že je prostředí Apple správně nakonfigurované, a to stisknutím kláves Cmd+Shift+P a následným výběrem možnosti .NET MAUI: Konfigurovat Apple a potom aktualizovat prostředí Apple. Všechny zjištěné chyby musí být vyřešeny:

   • Ujistěte se, že jste v terminálu spustili xcode-select --install.
   • Pokud se zobrazí chyba, že Xcode nebyl nalezen, spusťte xcode-select -p v terminálu a zkontrolujte, že vrací cestu k instalaci Xcode.
   • Otevřete Xcode, abyste se ujistili, že se správně načte, a přejděte do Xcode > Nastavení > Umístění a zkontrolujte, že pole Nástroje příkazového řádku směřuje na správnou instalaci Xcode.

Řešení problému

Pokud při instalaci rozšíření .NET MAUI v editoru Visual Studio Code narazíte na problémy, najdete další informace o problémech tak, že přejdete do okna Výstup (Ctrl+Shift+U ve Windows nebo Cmd+Shift+U v macOS) a v rozevíracím seznamu vyberete .NET MAUI .

Poskytnutí názorů

Pokud chcete poskytnout zpětnou vazbu k rozšíření .NET MAUI z editoru Visual Studio Code, přejděte do dialogového okna Nápověda > Nahlášení problému. Pak se ujistěte, že vyberete „Zpráva o chybě“ jako hodnotu pro rozevírací seznam , „A VS Code extension“ jako hodnotu pro rozevírací seznam Pro a „.NET MAUI“ jako hodnotu pro rozevírací seznam Rozšíření.

Visual Studio Code (experimentální)

Požadavky

K sestavení, podepsání a nasazení aplikací .NET MAUI pro iOS a Mac Catalyst budete potřebovat:

• Mac, který je kompatibilní s Xcode. Další informace najdete v dokumentaci k minimálním požadavkům společnosti Apple.
• Konkrétní verze Xcode, která závisí na verzi rozhraní .NET MAUI, kterou používáte. Informace najdete v tématu Verze verzí.
• Apple ID a placená registrace programu Apple Developer Program. Apple ID se vyžaduje k nasazení aplikací do zařízení a k odesílání aplikací do Apple Storu.

Pokud chcete začít vyvíjet nativní multiplatformní aplikace .NET MAUI na Windows, macOS nebo Linuxu, nainstalujte nejnovější Visual Studio Code podle instalačních kroků a.

Pokud chcete sestavit a ladit aplikaci .NET MAUI, budete muset mít platnou cílovou platformu vzhledem k operačnímu systému vašeho vývojového počítače. Následující tabulka uvádí podporované cílové platformy v jednotlivých operačních systémech:

Váš operační systém	Podporované cílové platformy
Windows	Windows, Android
macOS	Android, iOS, macOS
Operační systém Linux	Android

Instalace editoru Visual Studio Code

1. Pokud chcete vytvářet aplikace .NET MAUI, budete si muset stáhnout nejnovější verzi editoru Visual Studio Code:

   • Stáhnout Visual Studio Code

2. Nainstalujte Visual Studio Code. Podrobné pokyny k instalaci editoru Visual Studio Code najdete v tématu Visual Studio Code ve Windows, Visual Studio Code v systému macOSa Visual Studio Code v linuxovém.

Instalace rozšíření .NET MAUI

Než budete moct vytvářet aplikace .NET MAUI v editoru Visual Studio Code, budete muset nainstalovat rozšíření .NET MAUI:

1. Spusťte Visual Studio Code.

2. V editoru Visual Studio Code přejděte na kartu Rozšíření a vyhledejte ".NET MAUI". Potom vyberte rozšíření .NET MAUI a nainstalujte ho stisknutím tlačítka Nainstalovat:

   

   Rozšíření .NET MAUI automaticky nainstaluje rozšíření C# Dev Kit a C# , které jsou potřeba ke spuštění rozšíření .NET MAUI. Další informace o sadě C# Dev Kit naleznete v tématu C# Dev Kit for Visual Studio Code.

Postupujte podle kroků v návodu.

Jakmile nainstalujete rozšíření .NET MAUI, vítá vás návod .NET MAUI, "Začínáme s .NET MAUI".

Důležitý

Aby bylo možné získat přístup k vylepšenému prostředí nastavení, >Maui: Vylepšené nastavení prostředí instalace.

Klikněte a postupujte podle pokynů v každém kroku, abyste kompletně nastavili prostředí .NET MAUI a cílové platformy.

1. Připojení účtu k rozšíření C# Dev Kit
2. Nastavení prostředí .NET
3. Nastavení prostředí .NET MAUI
4. Nastavení prostředí pro iOS a macOS
5. Nastavení prostředí Androidu

Poznámka:

Budete muset být na Macu, abyste viděli a sledovali krok Nastavení prostředí pro iOS a macOS .

Krok Nastavení prostředí androidu nastaví vše, co potřebujete k úspěšnému nasazení s Androidem jako cílovou platformou, a krok Nastavení prostředí pro iOS a macOS nastaví vše, co potřebujete k úspěšnému s iOSem a Macem jako cílovými platformami.

Tento názorný postup je také přístupný z palety příkazů. Vyberte Vítejte: Otevřete návod... a pak začínáme s .NET MAUI.

Přístup k vylepšenému prostředí pro nastavení

1. V editoru Visual Studio Code stiskněte kombinaci kláves Ctrl+Shift+P ve Windows nebo Cmd+Shift+P v systému macOS vyberte Předvolby: Otevřít nastavení (UI).

   

2. Přejděte na Rozšíření > .NET MAUI a zkontrolujte konfiguraci Maui > : Vylepšené nastavení prostředí instalace .

   

3. Vraťte se do návodu Začínáme s .NET MAUI . Kromě dalších kroků v návodu se ujistěte, že vidíte nastavení prostředí Androidu .

   

Připojte svůj účet k sadě C# Dev Kit

Použití sady C# Dev Kit vyžaduje, abyste se přihlásili pomocí účtu Microsoft, který má aktivní předplatné sady Visual Studio:

1. Na záložce Vítejte pro zahájení práce s .NET MAUI stiskněte tlačítko Připojit:

   

   Podle pokynů se přihlaste ke svému účtu Microsoft. Pro více informací si přečtěte Přihlášení do C# Dev Kit.

Další informace o licencování sady C# Dev Kit najdete v tématu nejčastější dotazy k sadě C# Dev Kit.

Nastavení prostředí .NET

K vývoji aplikací .NET MAUI budete potřebovat nainstalovanou sadu .NET SDK na svém počítači. Pokud na svém počítači nemáte nainstalovanou sadu .NET SDK, upřednostňovaný přístup k jeho instalaci ve Windows je prostřednictvím instalačního programu sady Visual Studio. Další informace naleznete v tématu Instalace.

Případně můžete sadu .NET SDK nainstalovat ručně:

1. Stáhněte instalační program .NET.

2. Nainstalujte sadu .NET SDK spuštěním instalačního programu .NET. Další informace najdete v tématu Instalace .NET ve Windows, Linuxu a macOS.

   Spropitné

   Na Linuxu můžete nainstalovat .NET SDK pomocí skriptové instalace podle pokynů.

Ověření, že je nainstalovaná sada .NET SDK:

1. Otevřete terminál.

2. V terminálu spusťte následující příkaz:

   dotnet --version
   

   Měla by se zobrazit verze sady .NET SDK, kterou jste nainstalovali.

   Poznámka:

   Před ověřením, že je nainstalovaná sada .NET SDK, může být nutné restartovat počítač.

Nastavení prostředí .NET MAUI

K vývoji aplikací .NET MAUI budete potřebovat nainstalovanou sadu .NET MAUI SDK. Pokud na svém počítači nemáte nainstalovanou sadu .NET MAUI SDK, upřednostňovaný přístup k jeho instalaci ve Windows je prostřednictvím instalačního programu sady Visual Studio. Další informace naleznete v tématu Instalace.

Alternativně můžete postupovat podle těchto kroků a ručně nainstalovat sadu .NET MAUI SDK:

1. Otevřete terminál.

2. V terminálu ve Windows spusťte následující příkaz:

   dotnet workload install maui
   

   V terminálu v macOS spusťte následující příkaz:

   sudo dotnet workload install maui
   

   V terminálu v Linuxu spusťte následující příkaz:

   dotnet workload install maui-android
   

Ověření, že je nainstalovaná sada .NET MAUI SDK:

1. Otevřete terminál.

2. V terminálu spusťte následující příkaz:

   dotnet workload list
   

   Na operačních systémech Windows a macOS byste měli vidět ID úlohy maui uvedené vedle nainstalované verze. Pokud jste ho ale nainstalovali prostřednictvím Instalační služby sady Visual Studio v systému Windows, jsou uvedené následující ID úloh:

   android
   maui-windows
   maccatalyst
   ios
   

   Na Linuxu byste měli vidět ID práce maui-android uvedené společně s instalovanou verzí.

Nastavení prostředí Androidu

Pokud chcete nastavit vývojové prostředí Androidu, stačí kliknout na tlačítko Konfigurovat prostředí Android v kroku Nastavení prostředí androidu a zadat úplný tok získávání Androidu.

Proces instalace Androidu analyzuje vaše závislosti na Androidu a umožní instalaci všech potřebných komponent.

• Android SDK a Java SDK: Jsou vyžadovány komponenty Android SDK a Java SDK.

  • Proces stahování Androidu vás vyzve k přímé instalaci těchto komponent nebo k výběru již existující instalace, kterou můžete mít.

    

  • Další konfiguraci instalace sady SDK a sady JDK najdete v pokynech k ruční instalaci a konfiguraci Androidu.

• Emulátor Androidu: Instalace emulátoru Androidu se doporučuje a vyžaduje se v případě absence fyzického zařízení.

  • Tok získání Androidu vás vyzve k přímé instalaci výchozího emulátoru.

    

  • Pokud chcete emulátory konfigurovat dál, postupujte podle pokynů a nainstalujte emulátor Androidu ručně.

Důležitý

Licence pro Android bude potřeba ručně zkontrolovat a přijmout v terminálu. Po zobrazení výzvy zkontrolujte jednotlivé licence. Pokud chcete přijmout, zadejte y a stiskněte Enter.

Jakmile je vaše prostředí Androidu správně nakonfigurované, zobrazí se oznámení: "Vaše prostředí Android pro .NET MAUI je všechno nastavené!".

Další podrobnosti o stavu prostředí Androidu najdete v podokně Výstup.

Nastavení prostředí pro iOS a macOS

Nastavit Mac pro vývoj .NET MAUI pro systémy iOS a Mac Catalyst pomocí Visual Studio Code:

1. Nainstalujte verzi Xcode, kterou vyžaduje verze rozhraní .NET MAUI, kterou používáte. Informace najdete v tématu Verze verzí. Nejnovější stabilní verzi Xcode si můžete stáhnout z Apple App Storu.

2. V terminálu spuštěním následujícího příkazu získejte nástroje příkazového řádku Xcode:

   xcode-select --install
   

3. Spusťte Xcode a přijměte všechny licenční smlouvy. Pokud se simulátory nezačnou instalovat, přejděte na Xcode > Nastavení > Komponenty a nainstalujte vámi zvolená běhová prostředí simulátoru.

4. V editoru Visual Studio Code ověřte, že je prostředí Xcode nakonfigurované jednoduše kliknutím na Konfigurovat prostředí iOS a macOS v kroku Nastavení prostředí iOS a macOS .

Všechny zjištěné chyby musí být vyřešeny:

• Ujistěte se, že jste v terminálu spustili xcode-select --install.
• Pokud se zobrazí chyba, že Xcode nebyl nalezen, spusťte xcode-select -p v terminálu a zkontrolujte, že vrací cestu k instalaci Xcode.
• Otevřete Xcode, abyste se ujistili, že se správně načte, a přejděte do Xcode > Nastavení > Umístění a zkontrolujte, že pole Nástroje příkazového řádku směřuje na správnou instalaci Xcode.

Jakmile je vaše prostředí Xcode správně nakonfigurované, zobrazí se oznámení: "Vaše prostředí iOS a macOS pro .NET MAUI je všechno nastavené!".

Poskytnutí názorů

Pokud chcete poskytnout zpětnou vazbu k rozšíření .NET MAUI z editoru Visual Studio Code, přejděte do dialogového okna Nápověda > Nahlášení problému. Pak se ujistěte, že vyberete „Zpráva o chybě“ jako hodnotu pro rozevírací seznam , „A VS Code extension“ jako hodnotu pro rozevírací seznam Pro a „.NET MAUI“ jako hodnotu pro rozevírací seznam Rozšíření.

Další kroky

Pokud chcete zjistit, jak vytvořit a spustit první aplikaci .NET MAUI v sadě Visual Studio 2022 ve Windows nebo Visual Studio Code, klikněte na tlačítko níže.

Vytvořte svou první aplikaci