Ha natív, platformfüggetlen .NET MAUI-alkalmazásokat szeretne fejleszteni Windows, macOS vagy Linux rendszeren, telepítse a legújabb Visual Studio Code-ot a telepítési lépéseit követve.
Előfeltételek
A .NET MAUI-alkalmazások iOS-hez és Mac Catalysthoz való létrehozásához, aláírásához és üzembe helyezéséhez a következőkre lesz szüksége:
A Visual Studio Code telepítése
A .NET MAUI-alkalmazások létrehozásához le kell töltenie a Visual Studio Code legújabb verzióját:
Telepítse a Visual Studio Code-ot. A Visual Studio Code telepítésére vonatkozó részletes útmutatásért lásd: Visual Studio Code Windows, Visual Studio Code macOSrendszeren, és Visual Studio Code Linux.
A .NET MAUI-bővítmény telepítése
Ahhoz, hogy .NET MAUI-alkalmazásokat hozhasson létre a Visual Studio Code-ban, telepítenie kell a .NET MAUI-bővítményt:
Indítsa el a Visual Studio Code-ot.
A Visual Studio Code-ban lépjen a Bővítmények lapra, és keressen rá a ".NET MAUI" kifejezésre. Ezután válassza ki a .NET MAUI bővítményt, és telepítse a Telepítés gomb megnyomásával:
A .NET MAUI-bővítmény automatikusan telepíti a C# Dev Kit és C# bővítményeket, amelyek a .NET MAUI-bővítmény futtatásához szükségesek. További információ a C# Dev Kitről: C# Dev Kit for Visual Studio Code.
A fiók csatlakoztatása a C# Dev Kithez
A C# Dev Kit használatához egy aktív Visual Studio-előfizetéssel rendelkező Microsoft-fiókkal kell bejelentkeznie:
A .NET MAUI használatának megkezdéséhez az Üdvözlő lapon nyomja le a Csatlakozás gombot:
Az utasításokat követve jelentkezzen be Microsoft-fiókjába. További információ: Bejelentkezés a C# Dev Kit.
A C# Dev Kit licenceléssel kapcsolatos további információkért lásd C# Dev Kittel kapcsolatos gyakori kérdéseket.
A .NET-környezet beállítása
A .NET MAUI-alkalmazások fejlesztéséhez telepítenie kell a .NET SDK-t a gépére. Ha nem telepítette a .NET SDK-t a gépére, a windowsos telepítés előnyben részesített módszere a Visual Studio Installer. További információkért lásd: Telepítés.
Másik lehetőségként a .NET SDK manuális telepítéséhez:
Töltse le a .NET-telepítő.
Telepítse a .NET SDK-t a .NET-telepítő futtatásával. További információ: .NET telepítése Windows, Linux és macOS rendszeren.
A .NET SDK telepítésének ellenőrzése:
Nyisson meg egy terminált.
Futtassa a következő parancsot a terminálban:
dotnet --version
Látnia kell a telepített .NET SDK verzióját.
Jegyzet
Előfordulhat, hogy a .NET SDK telepítése előtt újra kell indítani a gépet.
A .NET MAUI-környezet beállítása
A .NET MAUI-alkalmazások fejlesztéséhez telepítenie kell a .NET MAUI SDK-t a gépére. Ha nem telepítette a .NET MAUI SDK-t a gépére, a Windowsra való telepítés előnyben részesített módszere a Visual Studio Installer. További információkért lásd: Telepítés.
Másik lehetőségként a .NET MAUI SDK manuális telepítéséhez:
Nyisson meg egy terminált.
A Windows terminálon futtassa a következő parancsot:
dotnet workload install maui
Futtassa a következő parancsot a macOS terminálban:
sudo dotnet workload install maui
Linux-terminálon futtassa a következő parancsot:
dotnet workload install maui-android
A .NET MAUI SDK telepítésének ellenőrzése:
Nyisson meg egy terminált.
Futtassa a következő parancsot a terminálban:
dotnet workload list
Windows és macOS rendszeren a telepített verzió mellett meg kell jelennie a maui
számítási feladat azonosítójának. Ha azonban windowsos Visual Studio Installeren keresztül telepítette, a következő számítási feladatok azonosítói jelennek meg:
android
maui-windows
maccatalyst
ios
Linuxon a telepített verzió mellett meg kell jelennie a maui-android
számítási feladat azonosítójának.
A .NET MAUI-alkalmazások létrehozásához és hibakereséséhez érvényes célplatformra van szükség a fejlesztőgép operációs rendszeréhez képest. Az alábbi táblázat felsorolja a támogatott célplatformokat az egyes operációs rendszereken:
Az operációs rendszer |
Támogatott célplatformok |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
A .NET MAUI-alkalmazás androidos és Apple-platformokon történő létrehozásához további beállításokat és konfigurációt kell végrehajtania.
Android
A .NET MAUI androidos fejlesztéséhez Visual Studio Code-dal a következőképpen állíthatja be a gépét:
A Java SDK letöltése és telepítése
A Java SDK letöltéséhez és telepítéséhez, valamint a Visual Studio Code használatára való konfigurálásához:
Töltse le és telepítse Microsoft OpenJDK 17. Az OpenJDK telepítésével kapcsolatos információkért lásd: Az OpenJDK Microsoft-buildjének telepítése.
Másik lehetőségként a Java SDK manuális letöltése és telepítése helyett használhatja a InstallAndroidDependencies
buildcélt a Java SDK (és az Android SDK) telepítéséhez. További információért lásd azpontot, az InstallAndroidDependencies cél használatával kapcsolatban.
Fontos
Ügyeljen arra, hogy jegyezze fel azt a helyet, amelyre az OpenJDK telepítve van, mivel erre a következő lépésben szükség van.
Győződjön meg arról, hogy az Alábbi módszerek egyikével konfigurálta az OpenJDK elérési útját:
Állítsa be a JAVA_HOME
környezeti változót a gép Java SDK-elérési útjának meghatározásához. Ez az ajánlott megközelítés, amely a Java SDK elérési útját határozza meg a gép szintjén.
Jegyzet
Ha msi-n keresztül telepíti az OpenJDK-t Windows rendszeren, akkor a telepítőben beállíthatja a JAVA_HOME
környezeti változót.
A Visual Studio Code-ban nyomja le a CTRL+SHIFT+P windowsos vagy CMD+SHIFT+P macOS rendszeren, majd válassza a .NET MAUI: Android-konfigurálása, majd Java SDK-hely kiválasztása a Java SDK elérési útjának beállításához a felhasználó/munkaterület szintjén.
Konfigurálja a Java SDK elérési útját a .csproj fájlban úgy, hogy az $(JavaSdkDirectory)
MSBuild tulajdonságot az OpenJDK elérési útra állítja. Ez a projekt szintjén határozza meg a Java SDK elérési útját.
Az Android SDK letöltése és telepítése
Az Android SDK letöltéséhez és telepítéséhez, valamint a Visual Studio Code használatára konfigurálásához:
Töltse le és telepítse az Android SDK-t az alábbi módszerek egyikével:
- Töltse le és telepítse az Android SDK-t egy új .NET MAUI-projekt létrehozásával, majd használja a
InstallAndroidDependencies
buildcélt, amely segít az Android-környezet beállításában. Ez az ajánlott megközelítés. További információért lásd azpontot, az InstallAndroidDependencies cél használatával kapcsolatban.
- Töltse le és telepítse az Android SDK-t Windows rendszeren, telepítse a .NET MAUI fejlesztési számítási feladatát a Visual Studio, majd hozzon létre és futtasson egy .NET MAUI-alkalmazást androidos. Ez a folyamat biztosítja, hogy az Android SDK és az Android emulátor telepítve legyen.
- Töltse le és telepítse az Android SDK-t az Android Studióban. A további információkért lásd a developer.android.com oldalon a Android Studio telepítése részt.
- Töltse le és telepítse az Android SDK-t az előnyben részesített csomagkezelőn keresztül Linuxon.
Győződjön meg arról, hogy konfigurálta az Android SDK elérési útját az alábbi módszerek egyikével:
- Állítsa be a
ANDROID_HOME
környezeti változót a gép Android SDK-elérési útjának meghatározásához. Ez az ajánlott megközelítés, amely meghatározza az Android SDK elérési útját a gép szintjén.
- A Visual Studio Code-ban nyomja le a CTRL+SHIFT+P windowsos vagy CMD+SHIFT+P macOS rendszeren, majd válassza a .NET MAUI: Az Androidkonfigurálása lehetőséget, majd Android SDK-hely kiválasztása az Android SDK elérési útjának beállításához a felhasználó/munkaterület szintjén.
- Konfigurálja az Android SDK elérési útját a .csproj fájlban úgy, hogy az
$(AndroidSdkDirectory)
MSBuild tulajdonságot az Android SDK elérési útjára állítja. Ez a projekt szintjén határozza meg az Android SDK elérési útját.
Visual Studio Code-ban ellenőrizze, hogy az Android környezet megfelelően van-e konfigurálva azáltal, hogy megnyomja Windows rendszeren a CTRL+SHIFT+P, macOS rendszeren pedig a CMD+SHIFT+P billentyűkombinációt, majd válassza a .NET MAUI: Android konfigurálása, aztán pedig az Android környezet frissítése lehetőséget. Minden észlelt hibát meg kell oldani:
- A parancskatalógusban válassza a .NET MAUI: Android konfigurálása lehetőséget, majd a Android SDK-hely kiválasztása és a Android SDK-hely kiválasztása lehetőségeket, és ellenőrizze, hogy mindegyik helyesen mutat-e az egyes telepítésekre. Windows rendszeren, ha a Visual Studióval telepíti az SDK-kat, az OpenJDK C:\Program Files\Microsoft, az Android SDK pedig C:\Program Files (x86)\Android\android-sdk.
- Győződjön meg arról, hogy az Android SDK-mappában vannak almappák, például buildeszközök, parancsmag-eszközökés platformeszközök.
- Győződjön meg arról, hogy az OpenJDK mappában vannak almappák, például tároló, libstb.
- Győződjön meg arról, hogy a
ANDROID_HOME
környezeti változó az Android SDK elérési útjára van állítva.
- Győződjön meg arról, hogy a
JAVA_HOME
környezeti változó a Java SDK elérési útjára van állítva.
- Ha az Android-licenceket nem fogadták el, egy emelt szintű terminálon lépjen az Android SDK cmdline-tools/{version}/bin mappájához, és futtassa a
sdkmanager --licenses
, majd kövesse a parancssori felületre vonatkozó utasításokat.
Az InstallAndroidDependencies célpont használata
A .NET MAUI-projekthez szükséges függőségek androidos telepítésének ajánlott módszere az InstallAndroidDependencies MSBuild-cél futtatása. Ez a célkitűzés telepíti az Android SDK-t önnek, ha még nincs telepítve.
Egy terminálban hozzon létre egy új .NET MAUI-projektet:
dotnet new maui -n "MyMauiApp"
Nyisson meg egy terminált, módosítsa a könyvtárat a MyMauiAppkönyvtárra, és hozza létre az alkalmazást, miközben megadja a InstallAndroidDependencies
build célt.
cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True
Jegyzet
A InstallAndroidDependencies
MSBuild célpont segítségével telepíthető a Java SDK, ha meg van adva a JavaSdkDirectory
MSBuild tulajdonság.
A fenti parancsban:
-
-p:AndroidSdkDirectory="/path/to/sdk"
telepíti vagy frissíti az Android-függőségeket a megadott abszolút elérési útra. A javasolt elérési utak a Windows %LOCALAPPDATA%/Android/Sdk, macOS rendszeren pedig $HOME/Library/Android/sdk.
-
-p:AcceptAndroidSDKLicenses=True
elfogadja a fejlesztéshez szükséges Android-licenceket.
- (nem kötelező)
-p:JavaSdkDirectory="/path/to/sdk"
telepíti a Java SDK-t a megadott abszolút elérési útra.
Próbálja meg elkerülni a szóközöket vagy nem ASCII-karaktereket tartalmazó elérési utak használatát.
Android emulátor letöltése és telepítése
Android emulátor letöltése és telepítése az alkalmazások futtatásához:
A terminálban navigáljon a(z) {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/könyvtárba.
Egy terminálban az sdkmanager
paranccsal töltse le és telepítse az Android emulátort:
Windows rendszeren futtassa a következő parancsokat:
sdkmanager --install emulator
sdkmanager --install "system-images;android-35;google_apis;x86_64"
MacOS rendszeren futtassa a következő parancsokat:
./sdkmanager --install emulator
./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
Jegyzet
A fenti parancs egy Apple Silicon Mac-et feltételez. Intel Mac esetén cserélje le a arm64-v8a
x86_64
.
A sdkmanager
parancsról további információt az developer.android.com sdkmanager című témakörben talál.
Egy terminálban a avdmanager
paranccsal hozzon létre egy új Android-emulátort:
Windows rendszeren futtassa a következő parancsokat:
avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
MacOS rendszeren futtassa a következő parancsokat:
./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
Jegyzet
A fenti parancs egy Apple Silicon Mac-et feltételez. Intel Mac esetén cserélje le a arm64-v8a
x86_64
.
A avdmanager
parancsról további információt az developer.android.com avdmanager című témakörben talál.
iOS és macOS
Mac for .NET MAUI-fejlesztés beállítása iOS és Mac Catalyst rendszeren a Visual Studio Code-tal:
Telepítse a használt .NET MAUI verziójához szükséges Xcode-verziót. Információért lásd: Kiadási verziók. A legújabb stabil Xcode-kiadás letölthető az Apple App Store.
Egy terminálban futtassa a következő parancsot az Xcode parancssori eszközeinek beszerzéséhez:
xcode-select --install
Indítsa el az Xcode-ot, és fogadja el a licencszerződéseket. Ha a szimulátorok nem kezdik el a telepítést, lépjen Xcode > Beállítások > Összetevők, és telepítse a kiválasztott szimulátor-futtatókörnyezeteket.
A Visual Studio Code-ban ellenőrizze, hogy az Apple-környezet megfelelően van-e konfigurálva, nyomja le CMD+SHIFT+P, majd válassza .NET MAUI: Az Applekonfigurálása lehetőséget, majd Az Apple-környezet frissítése. Minden észlelt hibát meg kell oldani:
- Győződjön meg róla, hogy lefuttatta a(z)
xcode-select --install
-t egy terminálban.
- Ha hibaüzenetet kap arról, hogy az Xcode nem található, futtassa a
xcode-select -p
egy terminálban, és ellenőrizze, hogy az az Xcode telepítésének elérési útját adja-e vissza.
- Nyissa meg az Xcode-ot, hogy biztosan megfelelően legyen betöltve, majd lépjen Xcode > Beállítások > Hely területre, és ellenőrizze, hogy a parancssori eszközök mező a megfelelő Xcode-telepítésre mutat-e.
Hibaelhárítás
Ha problémákba ütközik a .NET MAUI-bővítmény telepítésekor a Visual Studio Code keretrendszerben, további információkat a problémákról a Kimeneti ablakra (CTRL+SHIFT+U Windows rendszeren vagy CMD+SHIFT+U macOS rendszeren) navigálva találhat, majd a legördülő menüben válassza a .NET MAUI-t.
Visszajelzés küldése
Ha visszajelzést szeretne küldeni a .NET MAUI-bővítményről a Visual Studio Code-ból, lépjen a Súgó > jelentéssel kapcsolatos probléma párbeszédpanelre. Ezután válassza a "Hibajelentés" értéket a Ez a legördülő listában, az "A VS Code-bővítmény" értéket a For legördülő listában, és a ".NET MAUI" értéket a Bővítmény legördülő listában: