Udostępnij przez


Instalowanie platformy .NET dla zależności systemu Android

Aby skompilować aplikacje platformy .NET dla systemu Android, należy zainstalować zestaw SDK systemu Android i zestaw JAVA SDK.

Używanie elementu docelowego "InstallAndroidDependencies"

Najprostszym sposobem zainstalowania wymaganych zależności dla aplikacji systemu Android jest uruchomienie polecenia InstallAndroidDependencies Docelowy program MSBuild.

Ten cel przeanalizuje projekt aplikacji i zainstaluje dokładne składniki, które są potrzebne. Jeśli zaktualizujesz projekt tak, aby był przeznaczony dla nowego interfejsu API systemu Android, musisz ponownie uruchomić ten element docelowy, aby upewnić się, że uzyskasz wymagane składniki.

Jeśli na przykład uaktualniasz projekt do docelowego interfejsu API 34 z interfejsu API 32, masz zainstalowany tylko interfejs API 32. Uruchomienie celu InstallAndroidDependencies spowoduje zainstalowanie API 34.

Jeśli w ogóle nie masz zainstalowanego zestawu SDK systemu Android, ten element docelowy może również obsługiwać instalowanie zestawu SDK na czystej maszynie. Miejsce docelowe instalacji można zmienić, ustawiając AndroidSdkDirectory właściwość MSBuild. Zainstaluje również zestaw SDK Javy, jeśli zostanie podana JavaSdkDirectory właściwość MSBuild.

dotnet build -t:InstallAndroidDependencies -f net8.0-android -p:AndroidSdkDirectory=c:\work\android-sdk -p:JavaSdkDirectory=c:\work\jdk -p:AcceptAndroidSdkLicenses=True

Poniżej przedstawiono wszystkie argumenty, które będą używane przez obiekt docelowy podczas instalowania zależności:

  • -p:AndroidSdkDirectory="<PATH>" instaluje lub aktualizuje zależności systemu Android do określonej ścieżki.
    Uwaga: należy użyć ścieżki bezwzględnej; Deweloperzy systemu Unix nie powinni używać tyldy (~), ponieważ nie jest ona rozszerzana w przypadku użycia w argumencie wiersza polecenia.

  • -p:JavaSdkDirectory="<PATH>" instaluje język Java w określonej ścieżce.
    Uwaga: należy użyć ścieżki bezwzględnej; deweloperzy systemu Unix nie powinni używać tyldy (~), ponieważ nie jest ona rozszerzana, gdy jest używana jako argument wiersza polecenia.

  • -p:AcceptAndroidSDKLicenses=True akceptuje niezbędne licencje systemu Android na potrzeby programowania.

Uwaga / Notatka

Aby ułatwić programowanie, spróbuj unikać używania ścieżek zawierających spacje lub znaki inne niż ASCII.

Ręczne instalowanie zestawu Microsoft JDK

Aby utworzyć platformę .NET dla aplikacji lub bibliotek systemu Android, musisz mieć zainstalowaną wersję zestawu Java Development Kit. Zalecamy użycie zestawu Microsoft Open JDK. Ten zestaw został przetestowany pod kątem kompilacji platformy .NET dla systemu Android:

  1. Pobierz Microsoft OpenJDK 11.

Ręczne instalowanie zestawu Android SDK

Uwaga / Notatka

W systemie Windows najpierw musisz zainstalować zestaw JDK.

Konieczne może być ręczne zainstalowanie zestawu SDK systemu Android:

  1. Przejdź do pobierania programu Android Studio.
    Przewiń w dół do sekcji "Tylko narzędzia wiersza polecenia" i pobierz plik zip odpowiedni dla Twojego systemu operacyjnego.

  2. Utwórz android-sdk katalog gdzieś na dysku twardym. Aby ułatwić sobie życie, utwórz go blisko katalogu głównego dysku. Na przykład: c:\android-sdk.

  3. Wyodrębnij pliki z pliku zip do tego katalogu. Należy utworzyć strukturę folderów, na przykład android-sdk\cmdline-tools

  4. Otwórz terminal lub wiersz polecenia.

  5. Przejdź do katalogu android-sdk\cmdline-tools\bin w katalogu, który utworzyłeś.

  6. Uruchom polecenie , sdkmanager aby zainstalować żądane składniki.

  7. Ustaw zmienną środowiskową $ANDROID_HOME na ścieżkę zestawu SDK systemu Android:

$env:ANDROID_HOME = "C:\android-sdk"

Aby na przykład zainstalować najnowszą platformę i narzędzia platformy, użyj:

sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0" "emulator" "system-images;android-34;default;x86_64" "cmdline-tools;11.0" --sdk_root=c:\android-sdk

Należy pamiętać, że cudzysłowy powinny być hojnie używane do zamykania średnika ;, który jest częścią nazw składników.

Zostanie wyświetlony monit o zaakceptowanie licencji, po której zostanie zainstalowany zestaw SDK systemu Android.

Możesz użyć sdkmanager polecenia , aby zainstalować dodatkowe składniki. Możesz użyć argumentu --list , aby uzyskać listę wszystkich dostępnych składników. Następnie możesz przejrzeć listę i znaleźć potrzebne składniki.

sdkmanager --list

Przydatne są następujące typy składników:

  • platforms;android-XX: Instaluje platformę android-XX w zestawie SDK. Zastąp XX poziomem interfejsu API wybranej platformy. Na przykład platforms;android-30 zainstaluje interfejs API systemu Android 30, podczas gdy platforms;android-21 zainstaluje interfejs API systemu Android 21.

  • system-images;android-XX;default;x86_64: instaluje obraz emulatora dla określonego poziomu interfejsu API. Można x86_64 je wymieniać na różne ABI, takie jak x86, arm64-v8a i x86_64. Odzwierciedlają one ABI instalowanego obrazu. Może to być przydatne, jeśli masz problemy z określonymi usługami ABI.

Dobrym rozwiązaniem jest również ustawienie zmiennej ANDROID_HOME środowiskowej, ponieważ pozwala to na korzystanie z niektórych narzędzi z wiersza polecenia.

  1. W zależności od platformy uruchom odpowiedni instalator.

  2. Dobrym rozwiązaniem jest również ustawienie zmiennej środowiskowej JAVA_HOME . Umożliwi to użycie zestawu JDK z wiersza polecenia lub terminalu.