Uwaga
Visual Studio dla komputerów Mac ma zostać wycofany do 31 sierpnia 2024 r.Nowoczesne zasady cyklu życia firmy Microsoft. Visual Studio dla komputerów Mac 17.6 będzie nadal obsługiwany do 31 sierpnia 2024 r. wraz z aktualizacjami obsługi problemów z zabezpieczeniami i zaktualizowanymi platformami firmy Apple. Aby uzyskać więcej informacji, w tym alternatywne opcje programowania na komputerze Mac, zobacz Co się dzieje z Visual Studio dla komputerów Mac?.
Aby rozpocząć tworzenie natywnych aplikacji .NET MAUI dla wielu platform w systemie macOS, zainstaluj program Visual Studio 2022 dla komputerów Mac 17.6, wykonując kroki instalacji .
Wymagania wstępne
- Visual Studio 2022 dla komputerów Mac w wersji 17.6. Aby uzyskać informacje o obsługiwanych systemach operacyjnych, sprzęcie, obsługiwanych językach oraz dodatkowych wymaganiach i wskazówkach, zobacz Wymagania systemowe programu Visual Studio 2022 dla komputerów Mac.
Do kompilowania, podpisywania i wdrażania aplikacji MAUI platformy .NET dla systemu iOS lub macOS potrzebne są również następujące elementy:
Instalacja
Aby utworzyć aplikacje MAUI platformy .NET, potrzebne są najnowsze Visual Studio dla komputerów Mac:
Zainstaluj program Visual Studio 2022 dla komputerów Mac lub zmodyfikuj istniejącą instalację i upewnij się, że są zainstalowane następujące obciążenia:
- .NET
- .NET MAUI
- Android
- iOS
Ważne
W przypadku nowych instalacji programu Visual Studio 2022 dla komputerów Mac wybranie obciążenia .NET MAUI spowoduje automatyczne wybranie obciążeń systemu Android i iOS, które są obecnie wymagane do programowania w programie .NET MAUI.
Zainstaluj program .NET 8 za pośrednictwem autonomicznego instalatora.
Po zakończeniu instalowania platformy .NET 8 uruchom polecenie dotnet workload install maui
w terminalu.
Ważne
Aby użyć Visual Studio dla komputerów Mac z platformą .NET 8, włącz pole wyboru Preferencje > programu Visual Studio > Inne > funkcje > w wersji zapoznawczej Użyj zestawu .NET 8 SDK, jeśli jest zainstalowany (wymaga ponownego uruchomienia).
Jeśli masz problemy z siecią podczas instalowania w środowisku firmowym, zapoznaj się z instrukcjami dotyczącymi instalowania za zaporą lub serwerem proxy .
Instalacja za zaporą lub serwerem proxy
Aby zainstalować program Visual Studio 2022 dla komputerów Mac za zaporą, niektóre punkty końcowe muszą być dostępne, aby umożliwić pobieranie wymaganych narzędzi i aktualizacji oprogramowania. Aby uzyskać więcej informacji na temat konfigurowania sieci w celu umożliwienia dostępu do wymaganych punktów końcowych, zobacz Instalowanie i używanie Visual Studio dla komputerów Mac za zaporą lub serwerem proxy.
Uwaga
Obsługa interfejsu MAUI platformy .NET w programie Visual Studio Code jest nadal dostępna w wersji zapoznawczej. Wypróbuj i podziel się swoją opinią!
Instalowanie programu Visual Studio Code i rozszerzenia .NET MAUI
Zainstalowanie programu Visual Studio Code.
Na karcie Rozszerzenia wyszukaj ciąg ".NET MAUI" i zainstaluj rozszerzenie .NET MAUI. Rozszerzenie .NET MAUI automatycznie instaluje zestaw deweloperski języka C# i rozszerzenia języka C# , które są wymagane do uruchomienia rozszerzenia .NET MAUI.
Uwaga
Rozszerzenie .NET MAUI wymaga zestawu deweloperskiego języka C# i wstępnych rozszerzeń języka C#. Aby korzystać z funkcji rozszerzenia MAUI platformy .NET, musisz zalogować się do zestawu deweloperskiego języka C#. Zobacz ten wpis w blogu, aby uzyskać więcej informacji na temat zestawu Deweloperskiego języka C# i jego rodziny rozszerzeń.
Instalowanie obciążeń .NET i .NET MAUI
Zainstaluj program .NET 8.
W systemie Windows zaleca się używanie instalatora programu Visual Studio do zarządzania instalacjami obciążeń .NET i .NET MAUI. Instrukcje dotyczące korzystania z instalatora programu Visual Studio można znaleźć tutaj.
Zainstaluj obciążenie .NET MAUI.
W systemach Windows i macOS uruchom następujące polecenie w terminalu:
dotnet workload install maui
W systemie Linux uruchom następujące polecenie w terminalu:
dotnet workload install maui-android
Aby debugować aplikację .NET MAUI w programie Visual Studio Code, musisz mieć prawidłową platformę docelową dla systemu operacyjnego maszyny deweloperskiej:
System operacyjny |
Obsługiwane platformy docelowe |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS i macOS
Aby debugować element docelowy systemu iOS lub macOS w programie Visual Studio Code:
- Zainstaluj wersję środowiska Xcode wymaganą przez używaną wersję interfejsu MAUI platformy .NET. Aby uzyskać informacje, zobacz Wersje wydania. Najnowszą stabilną wersję programu Xcode można pobrać ze sklepu Mac App Store.
- Uruchom polecenie
xcode-select --install
w terminalu, aby uzyskać narzędzia wiersza polecenia Xcode.
Android
Aby debugować element docelowy systemu Android w programie Visual Studio Code:
- Zainstaluj zestaw Microsoft OpenJDK 17.
- Zainstaluj zestaw SDK systemu Android za pomocą jednego z następujących metod:
- (Zalecane) Utwórz nowy projekt .NET MAUI (
dotnet new maui
) i użyj elementu docelowego InstallAndroidDependencies.
- Zainstaluj za pomocą programu Visual Studio (tylko system Windows).
- Zainstaluj za pośrednictwem programu Android Studio.
- Zainstaluj za pośrednictwem preferowanego menedżera pakietów w systemie Linux.
Rozwiązywanie problemów
Podczas konfigurowania rozszerzenia .NET MAUI dla programu Visual Studio Code mogą wystąpić problemy. Jeśli nadal występują problemy po wykonaniu poniższych kroków rozwiązywania problemów, zgłoś problem.
Tworzenie projektu
Jeśli spróbujesz utworzyć nowy projekt, a eksplorator plików będzie wyświetlał się w nieskończonej pętli, być może nie wybierasz pustego folderu. Sprawdź, czy nie ma ukrytych plików ani folderów, utwórz nowy folder lub utwórz aplikację .NET MAUI z poziomu wiersza polecenia przy użyciu polecenia dotnet new maui
.
Korzystanie z elementu docelowego InstallAndroidDependencies
Platforma .NET 8 ma docelowy element docelowy kompilacji, który ułatwia skonfigurowanie środowiska systemu Android. Uruchom następujące polecenie w terminalu, aby skonfigurować maszynę i skonfigurować środowisko systemu Android:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
W powyższym poleceniu:
AndroidSdkDirectory="<AndroidSdkPath>"
: instaluje lub aktualizuje zależności systemu Android do określonej ścieżki bezwzględnej.
- Windows: sugerowany element AndroidSdkPath to
%LOCALAPPDATA%/Android/Sdk
.
- MacOS: sugerowany element AndroidSdkPath to
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: instaluje język Java w określonej ścieżce bezwzględnej.
AcceptAndroidSDKLicenses=True
: akceptuje wymagane licencje systemu Android na potrzeby programowania.
Wystąpił błąd, że nie można odnaleźć zestawu SDK systemu Android lub zestawu Java SDK
- Otwórz paletę poleceń (Ctrl/Cmd + Shift + P) i wyszukaj
.NET MAUI: Configure Android
polecenie . Wybierz zarówno pozycję "Ustaw ścieżkę zestawu ANDROID SDK", "Ustaw ścieżkę zestawu Android JDK" i sprawdź, czy wskazują instalacje każdego z nich.
- Folder zestawu SDK systemu Android powinien zawierać podfoldery, takie jak
build-tools
, cmdline-tools
i platform-tools
.
- Folder Java OpenJDK powinien zawierać podfoldery, takie jak
bin
, lib
i inne.
- W systemie Windows, jeśli zainstalujesz za pomocą programu Visual Studio, zestaw JAVA SDK będzie znajdować się w
C:\Program Files\Microsoft\
systemie , a zestaw SDK systemu Android będzie znajdować się w systemie C:\Program Files (x86)\Android\android-sdk
.
- Ustaw zmienną
JAVA_HOME
środowiskową na prawidłową ścieżkę Java OpenJDK.
- Ustaw zmienną
ANDROID_HOME
środowiskową na ścieżkę zestawu SDK systemu Android.
- Sprawdź minimalne wersje zainstalowanych zależności systemu Android:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- Platformy; android-34*
- .NET 8: narzędzia platformy = 34.0.5
Wystąpił błąd, że licencje systemu Android nie są akceptowane
W wierszu polecenia z podwyższonym poziomem uprawnień lub terminalu przejdź do folderu zestawu ANDROID SDK cmdline-tools/latest/bin/
, a następnie uruchom sdkmanager --licenses
polecenie , a następnie postępuj zgodnie z monitami interfejsu wiersza polecenia.
Moje zależności systemu Android nie są ładowane w Eksplorator rozwiązań, ale moja aplikacja jest w porządku
Jest to znany problem, jeśli zainstalujesz program %APPDATA%
w systemie Windows i zostanie rozwiązany w przyszłej wersji.
Konfiguracja systemu iOS/Xcode
- Jeśli wystąpi błąd wskazujący, że program Xcode nie został znaleziony, uruchom polecenie
xcode-select --install
w terminalu, a następnie sprawdź, czy xcode-select -p
wskazuje instalację programu Xcode.
- Jeśli nadal występują problemy, otwórz sam program Xcode, aby upewnić się, że ładuje się poprawnie. Po otwarciu programu Xcode przejdź do pozycji Xcode > Ustawienia Locations (Lokalizacje) > i sprawdź, czy pole Narzędzia wiersza polecenia wskazuje prawidłowy kod Xcode.
- Istnieje znany problem, który czasami trzeba dwukrotnie skompilować aplikację systemu iOS/macOS w celu jej wdrożenia. Ten problem zostanie rozwiązany w nadchodzącej wersji.
Problemy z debugowaniem
- Nie można uruchomić debugowania z wielu powodów. Jeśli w oknie Dane wyjściowe nie ma wyraźnego błędu, najpierw sprawdź, czy używasz konfiguracji uruchamiania "NET MAUI" w programie Visual Studio Code.
- Możesz wypróbować kompilację wiersza polecenia z poziomu terminalu, aby sprawdzić, czy błąd dotyczy kodu, czy rozszerzenia MAUI platformy .NET. Możesz na przykład uruchomić polecenie
dotnet build -f:net8.0-android
, aby sprawdzić, czy kompilacja systemu Android powiedzie się poza programem Visual Studio Code. Jeśli ta kompilacja powiedzie się, zgłoś problem
Znane ograniczenia
To rozszerzenie jest nadal w wczesnej wersji zapoznawczej, dlatego istnieje wiele znanych ograniczeń. Przekaż nam swoją opinię na temat innych funkcji, które chcesz zobaczyć, ponieważ kontynuujemy tworzenie tego nowego środowiska.
- Możliwości edycji XAML są bardzo lekkie — można uzyskać podstawowe wyróżnianie składni i autouzupełnianie. Eksplorujemy sposób ulepszania środowiska XAML w przyszłej wersji.
- Obecnie nie można przełączyć platformy docelowej dla funkcji IntelliSense (spowoduje to wyświetlenie wyróżniania składni tylko dla pierwszej platformy docelowej wymienionej w pliku csproj). Ta funkcja jest w toku.
- Pliki XAML i .NET Przeładowywanie na gorąco nie są obecnie obsługiwane.
- To rozszerzenie nie zostało jeszcze w pełni przetestowane przy użyciu najnowszych wersji beta systemów iOS i Xcode.
Przekaż nam swoją opinię na temat innych funkcji, które chcesz zobaczyć, ponieważ kontynuujemy tworzenie nowego środowiska.
Przekaż opinię
Przeczytaj często zadawane pytania dotyczące zestawu deweloperskiego języka C# i sprawdź istniejące znane problemy przed zgłoszeniem nowego problemu lub sugestii. Sugestie i problemy można zgłaszać w programie Visual Studio Code za pośrednictwem okna dialogowego Zgłaszanie problemów z raportem pomocy>. Upewnij się, że wybierzesz pozycję "Rozszerzenie", a następnie rozszerzenie .NET MAUI na liście rozwijanej.