Aby rozpocząć tworzenie natywnych, międzyplatformowych aplikacji .NET MAUI w systemach Windows, macOS lub Linux, zainstaluj najnowszą wersję programu Visual Studio Code, wykonując kroki instalacji.
Wymagania wstępne
Do kompilowania, podpisywania i wdrażania aplikacji MAUI platformy .NET dla systemu iOS potrzebne są następujące elementy:
Instalacja
Aby utworzyć aplikacje MAUI platformy .NET, należy zainstalować najnowszą wersję programu Visual Studio Code.
W programie 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 MAUI platformy .NET wymaga zestawów deweloperskich języka C# i rozszerzeń języka C#. Aby korzystać z funkcji rozszerzenia MAUI platformy .NET, musisz zalogować się do zestawu deweloperskiego języka C#. Aby uzyskać więcej informacji, zobacz ten wpis w blogu, aby dowiedzieć się więcej o zestawie deweloperskim języka C# i jego rodzinie rozszerzeń.
Instalowanie obciążeń .NET i .NET MAUI
Zainstaluj program .NET 9.
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.
W systemie Linux zainstaluj się przy użyciu skryptowych instrukcji instalacji.
Zainstaluj obciążenie .NET MAUI.
W systemie Windows, chyba że jest zainstalowany za pośrednictwem instalatora programu Visual Studio, uruchom następujące polecenie w terminalu:
dotnet workload install maui
W systemie macOS uruchom następujące polecenie w terminalu:
sudo 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ą względem systemu operacyjnego maszyny deweloperskiej. Uwzględnienie nieprawidłowych platform docelowych uniemożliwi kompilowanie projektu. Platformy docelowe można zarządzać w pliku projektu aplikacji (csproj):
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>net9.0-android;net9.0-ios;net9.0-maccatalyst</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net9.0-windows10.0.19041.0</TargetFrameworks>
| 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 Apple App Store.
- Uruchom polecenie
xcode-select --install w terminalu, aby uzyskać narzędzia wiersza polecenia Xcode.
- Otwórz program Xcode i upewnij się, że akceptujesz wszelkie umowy licencyjne.
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. Aby wyświetlić szczegółowe informacje o błędach związanych z rozszerzeniem, przejdź do okna Dane wyjściowe (CTRL/CMD + Shift + u ) i wybierz pozycję .NET MAUI na liście rozwijanej. Zapoznaj się z poniższymi sekcjami, aby rozwiązać problem. Jeśli nadal występują problemy po wykonaniu 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 9 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:net9.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 znaleziono 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-toolsi platform-tools.
- Folder Java OpenJDK powinien zawierać podfoldery, takie jak
bin, libi 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 9: 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, że nie znaleziono środowiska Xcode, uruchom polecenie
xcode-select --install w terminalu, a następnie sprawdź, czy xcode-select -p wskazuje instalację środowiska 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 Lokalizacje ustawień > programu Xcode > 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 języka C# w programie Visual Studio Code.
- Jeśli używasz starszej wersji platformy .NET, debuger języka C# nie jest obsługiwany w przypadku aplikacji .NET MAUI. Możesz użyć starszej konfiguracji debugowania .NET MAUI, usuwając zaznaczenie ustawienia rozszerzenia MAUI > Configuration > Experimental > Use VSDbg.
- 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:net9.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
- 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. Aby uzyskać wyróżnianie składni dla innych obiektów docelowych (np. Android zamiast systemu iOS), można zmienić kolejność struktur docelowych w pliku projektu.
- Program .NET Przeładowywanie na gorąco jest obecnie w wersji zapoznawczej w zestawie deweloperskim języka C#.
Przekaż nam swoją opinię na temat innych funkcji, które chcesz zobaczyć, ponieważ kontynuujemy tworzenie nowego środowiska.
Przekazywanie opinii
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.
