sdkmanager
to narzędzie wiersza poleceń, które umożliwia wyświetlanie, instalowanie, aktualizowanie i odinstalowywanie pakietów dla pakietu SDK Androida. Jeśli używasz Androida Studio, nie musisz korzystać z tego narzędzia. Możesz zarządzać pakietami SDK w środowisku IDE.
Narzędzie sdkmanager
jest dostępne w pakiecie Android SDK Command-Line Tools.
Aby zainstalować wersję narzędzi wiersza poleceń za pomocą Menedżera SDK, wykonaj te czynności:
- Pobierz najnowszy pakiet narzędzi wiersza poleceń ze strony Android Studio i rozpakuj go.
- Przenieś rozpakowany katalog
cmdline-tools
do nowego katalogu, np. android_sdk. Ten nowy katalog to katalog pakietu Android SDK. - W rozpakowanym katalogu
cmdline-tools
utwórz podkatalog o nazwielatest
. - Przenieś oryginalną zawartość katalogu
cmdline-tools
, w tym kataloglib
, katalogbin
, plikNOTICE.txt
i pliksource.properties
, do nowo utworzonego katalogulatest
. Teraz możesz używać narzędzi wiersza poleceń z tej lokalizacji. (Opcjonalnie) Aby zainstalować poprzednią wersję narzędzi wiersza poleceń, uruchom to polecenie:
Zastąpandroid_sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;version"
version
wersją, którą chcesz zainstalować, np.5.0
.
Wykorzystanie
Za pomocą sdkmanager
możesz wyświetlać zainstalowane i dostępne pakiety, instalować pakiety i aktualizować pakiety. Więcej informacji znajdziesz w sekcjach poniżej.
Lista zainstalowanych i dostępnych pakietów
Aby wyświetlić listę zainstalowanych i dostępnych pakietów, użyj tej składni:
sdkmanager --list [options] \ [--channel=channel_id] // Channels: 0 (stable), 1 (beta), 2 (dev), or 3 (canary)
Użyj opcji channel
, aby uwzględnić pakiet z kanału do poziomu channel_id
włącznie. Na przykład możesz określić kanał Canary, aby wyświetlić listę pakietów ze wszystkich kanałów.
Instalowanie pakietów
Aby zainstalować pakiety, użyj tej składni:
sdkmanager packages [options]
Argument packages to ścieżka w stylu pakietu SDK, jak pokazano w przypadku polecenia --list
, ujęta w cudzysłów. Na przykład "build-tools;35.0.0"
lub "platforms;android-33"
.
Możesz przekazać wiele ścieżek pakietów, rozdzielając je spacjami, ale każda z nich musi być ujęta w własny zestaw cudzysłowów. Na przykład poniżej opisano sposób instalowania najnowszych narzędzi platformy i narzędzi SDK dla interfejsu API na poziomie 33:
sdkmanager "platform-tools" "platforms;android-33"
Możesz też przekazać plik tekstowy, który określa wszystkie pakiety:
sdkmanager --package_file=package_file [options]
Argument package_file to lokalizacja pliku tekstowego, w którym każdy wiersz jest ścieżką w stylu pakietu SDK do pakietu do zainstalowania (bez cudzysłowów).
Aby odinstalować pakiet, dodaj flagę --uninstall
:
sdkmanager --uninstall packages [options] sdkmanager --uninstall --package_file=package_file [options]
Aby zainstalować CMake lub NDK, użyj tej składni:
sdkmanager --install ["ndk;major.minor.build[suffix]" | "cmake;major.minor.micro.build"] [--channel=channel_id] // NDK channels: 0 (stable), 1 (beta), or 3 (canary)
Aby na przykład zainstalować określoną wersję NDK niezależnie od tego, na jakim kanale się obecnie znajduje, użyj tego polecenia:
sdkmanager --install "ndk;21.3.6528147" --channel=3 // Install the NDK from the canary channel (or below) sdkmanager --install "cmake;10.24988404" // Install a specific version of CMake
Aktualizowanie wszystkich zainstalowanych pakietów
Aby zaktualizować wszystkie zainstalowane pakiety, użyj tej składni:
sdkmanager --update [options]
Akceptowanie licencji
Musisz zaakceptować niezbędną licencję dla każdego zainstalowanego pakietu. Ten krok jest wykonywany podczas instalacji pakietów w Android Studio.
Jeśli nie masz zainstalowanego środowiska Android Studio lub jest ono przeznaczone na serwer CI albo inne urządzenie z systemem Linux bez zainstalowanego graficznego interfejsu użytkownika, wykonaj te czynności w wierszu poleceń:
sdkmanager --licenses
Spowoduje to wyświetlenie prośby o zaakceptowanie licencji, które nie zostały jeszcze zaakceptowane.
Opcje
Tabela poniżej zawiera listę opcji dostępnych w przypadku poleceń wymienionych w poprzedniej sekcji:
Option | Opis |
---|---|
--sdk_root=path
|
Użyj podanej ścieżki SDK zamiast ścieżki SDK zawierającej to narzędzie. |
--channel=channel_id
|
Uwzględnij pakiety w kanałach do channel_id włącznie. Dostępne kanały to:
|
--include_obsolete
|
uwzględniać przestarzałe pakiety na liście pakietów lub w aktualizacjach pakietów;
Do użytku tylko z --list i --update .
|
--no_https
|
Wymuszanie używania protokołu HTTP zamiast HTTPS we wszystkich połączeniach. |
--newer
|
Użyj --list , aby wyświetlić tylko nowe lub aktualizowalne pakiety.
|
--verbose
|
Tryb szczegółowych danych wyjściowych. Wyświetlane są błędy, ostrzeżenia i komunikaty informacyjne. |
--proxy={http | socks}
|
Połącz się przez serwer proxy danego typu: http w przypadku protokołów wysokiego poziomu, takich jak HTTP lub FTP, lub socks w przypadku serwera proxy SOCKS (V4 lub V5).
|
--proxy_host={IP_address | DNS_address}
|
Adres IP lub DNS serwera proxy, którego chcesz użyć. |
--proxy_port=port_number
|
Numer portu serwera proxy, z którym chcesz się połączyć. |