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?.
Pokud chcete začít vyvíjet nativní multiplatformní aplikace .NET MAUI v systému macOS, nainstalujte Visual Studio 2022 pro Mac 17.6 podle pokynů pro instalaci .
Požadavky
- Visual Studio 2022 pro Mac 17.6 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 for Mac.
Pokud chcete vytvářet, podepisovat a nasazovat aplikace .NET MAUI pro iOS nebo macOS, 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.
Instalace
K vytváření aplikací .NET MAUI budete potřebovat nejnovější Visual Studio pro Mac:
Nainstalujte sadu Visual Studio 2022 pro Mac nebo upravte stávající instalaci a ujistěte se, že jsou nainstalované následující úlohy:
- .NET
- .NET MAUI
- Android
- iOS
Důležité
U nových instalací sady Visual Studio 2022 pro Mac se výběrem úlohy .NET MAUI automaticky vyberou úlohy Android a iOS, které jsou aktuálně potřeba pro vývoj .NET MAUI.
Nainstalujte .NET 8 prostřednictvím samostatného instalačního programu.
Po dokončení instalace .NET 8 spusťte dotnet workload install maui
v terminálu.
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.
Pokud máte potíže se sítí při instalaci v podnikovém prostředí, projděte si pokyny k instalaci za bránou firewall nebo proxy serverem .
Instalace za bránou firewall nebo proxy serverem
Pokud chcete nainstalovat Visual Studio 2022 pro Mac za bránou firewall, musí být některé koncové body přístupné, aby bylo možné stahovat požadované nástroje a aktualizace pro váš software. Další informace o konfiguraci sítě tak, aby umožňovala přístup k požadovaným koncovým bodům, najdete v tématu Instalace a použití Visual Studio pro Mac za bránou firewall nebo proxy serverem.
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 editoru Visual Studio Code a rozšíření .NET MAUI
Nainstalujte Visual Studio Code.
Na kartě Rozšíření vyhledejte ".NET MAUI" a nainstalujte rozšíření .NET MAUI. 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.
Instalace úloh .NET a .NET MAUI
Nainstalujte .NET 8.
Ve Windows se doporučuje použít instalační program sady Visual Studio ke správě .NET a instalací úloh .NET MAUI. Pokyny k používání instalačního programu sady Visual Studio najdete tady.
Nainstalujte úlohu .NET MAUI.
V systému Windows a macOS spusťte v terminálu následující příkaz:
dotnet workload install maui
V Linuxu spusťte v terminálu následující příkaz:
dotnet workload install maui-android
Pokud chcete ladit aplikaci .NET MAUI v editoru Visual Studio Code, musíte mít platnou cílovou platformu pro operační systém vývojového počítače:
Váš operační systém |
Podporované cílové platformy |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS a macOS
Ladění cíle pro iOS nebo macOS v editoru Visual Studio Code:
- 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 Mac App Storu.
- Spuštěním
xcode-select --install
v terminálu získejte nástroje příkazového řádku Xcode.
Android
Ladění cíle androidu v editoru Visual Studio Code:
- Nainstalujte Microsoft OpenJDK 17.
- Nainstalujte sadu Android SDK pomocí jednoho z následujících přístupů:
- (Doporučeno) Vytvořte nový projekt .NET MAUI (
dotnet new maui
) a použijte cíl InstallAndroidDependencies.
- Instalace prostřednictvím sady Visual Studio (jenom Windows)
- Nainstalujte si ho přes Android Studio.
- Nainstalujte si ho prostřednictvím preferovaného správce balíčků v Linuxu.
Řešení problému
Při nastavování rozšíření .NET MAUI pro Visual Studio Code může docházet k problémům. Pokud problémy přetrvávají i po provedení následujících kroků pro řešení potíží, nahlašte problém.
Vytvoření projektu
Pokud se pokusíte vytvořit nový projekt a Průzkumník souborů se stále vyskočí v nekonečné smyčce, možná nevyberete prázdnou složku. Zkontrolujte, jestli nejsou žádné skryté soubory nebo složky, vytvořte novou složku nebo vytvořte aplikaci .NET MAUI z příkazového řádku pomocí dotnet new maui
.
Použití cíle InstallAndroidDependencies
.NET 8 má cíl sestavení, který vám pomůže nastavit prostředí Androidu za vás. Spuštěním následujícího příkazu v terminálu nakonfigurujte počítač a nastavte prostředí Android:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
Ve výše uvedeném příkazu:
AndroidSdkDirectory="<AndroidSdkPath>"
: Nainstaluje nebo aktualizuje závislosti Androidu na zadanou absolutní cestu.
- Windows: Navrhovaný AndroidSdkPath je
%LOCALAPPDATA%/Android/Sdk
.
- MacOS: Navrhovaný AndroidSdkPath je
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: Nainstaluje Javu na zadanou absolutní cestu.
AcceptAndroidSDKLicenses=True
: přijímá požadované licence androidu pro vývoj.
Došlo k chybě, že se nenašla sada Android SDK nebo Java SDK.
- Otevřete paletu příkazů (Ctrl/Cmd + Shift + P) a vyhledejte
.NET MAUI: Configure Android
příkaz. Vyberte "Nastavit cestu sady Android SDK" a "Nastavit cestu sady Android JDK" a ověřte, že odkazují na instalace každého.
- Složka sady Android SDK by měla obsahovat podsložky, jako
build-tools
je například , cmdline-tools
a platform-tools
.
- Složka Java OpenJDK by měla obsahovat podsložky, například
bin
, lib
a další.
- Pokud nainstalujete prostřednictvím sady Visual Studio, sada Java SDK bude v
C:\Program Files\Microsoft\
systému Windows a sada Android SDK bude v C:\Program Files (x86)\Android\android-sdk
.
- Nastavte proměnnou
JAVA_HOME
prostředí na platnou cestu Java OpenJDK.
- Nastavte proměnnou
ANDROID_HOME
prostředí na cestu sady Android SDK.
- Zkontrolujte minimální verze nainstalovaných závislostí Androidu:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- Platformy; android-34*
- .NET 8: platform-tools = 34.0.5
Došlo k chybě, že se licence androidu nepřijímají.
V příkazovém řádku nebo terminálu se zvýšenými oprávněními přejděte do složky sady Android SDK cmdline-tools/latest/bin/
a spusťte sdkmanager --licenses
ho podle pokynů rozhraní příkazového řádku.
Moje závislosti pro Android se nenačítají v Průzkumník řešení, ale moje aplikace je v pořádku
Jedná se o známý problém, pokud nainstalujete do %APPDATA%
Windows a opravíte ho v budoucí verzi.
Nastavení iOS/Xcode
- Pokud se zobrazí chyba, že Xcode nebyl nalezen, spusťte
xcode-select --install
v terminálu a zkontrolujte, jestli xcode-select -p
odkazuje na instalaci Xcode.
- Pokud stále dochází k problémům, otevřete samotný Xcode a ujistěte se, že se správně načte. Jakmile je Xcode otevřený, přejděte na Xcode > Nastavení > Umístění a zkontrolujte, že pole Nástroje příkazového řádku ukazuje na správný Xcode.
- Existuje známý problém, kdy někdy musíte vytvořit aplikaci pro iOS/macOS dvakrát, aby se nasadilo. Tuto chybu opravíme v příští verzi.
Problémy s laděním
- Ladění se nedá spustit z několika důvodů. Pokud v okně Výstup není jasná chyba, nejprve pečlivě zkontrolujte, jestli používáte konfiguraci spuštění .NET MAUI v editoru Visual Studio Code.
- Můžete zkusit sestavení příkazového řádku z terminálu a zjistit, jestli je chyba s kódem nebo rozšířením .NET MAUI. Můžete například spustit
dotnet build -f:net8.0-android
a zjistit, jestli se sestavení Pro Android úspěšně spustí mimo Visual Studio Code. Pokud je sestavení úspěšné, nahlaste problém .
Známá omezení
Toto rozšíření je stále ve verzi Preview, takže existuje řada známých omezení. Sdělte nám prosím svůj názor na další funkce, které byste rádi viděli, když budeme pokračovat v vytváření tohoto nového prostředí.
- Možnosti úprav XAML jsou velmi jednoduché – získáte základní zvýrazňování syntaxe a automatické dokončování. Zkoumáme, jak v budoucí verzi vylepšit prostředí XAML.
- V současné době nemůžete přepnout cílovou architekturu pro IntelliSense (zobrazí se zvýraznění syntaxe pouze pro první cílovou architekturu uvedenou v souboru .csproj). Tato funkce probíhá.
- Opětovné načítání za provozu XAML a .NET se v současné době nepodporují.
- Toto rozšíření ještě nebylo plně testováno s nejnovějšími beta verzemi pro iOS a Xcode.
Sdělte nám prosím svůj názor na další funkce, které byste rádi viděli, když budeme pokračovat v vytváření tohoto nového prostředí.
Zadání zpětné vazby
Přečtěte si nejčastější dotazy k sadě C# Dev Kit a před vytvořením nového problému nebo návrhu zkontrolujte existující známé problémy. Návrhy a problémy můžete v editoru Visual Studio Code vytvořit prostřednictvím dialogového okna Problém se sestavou nápovědy>. Ujistěte se, že v rozevíracím seznamu vyberete "Rozšíření", pak rozšíření .NET MAUI.