menedżer pakietu SDK

sdkmanager to narzędzie wiersza poleceń, które umożliwia wyświetlanie, instalowanie, aktualizowanie i odinstalowywanie pakietów pakietu SDK Androida. Jeśli używasz Android Studio, nie musisz korzystać z tego narzędzia. Możesz zamiast tego zarządzać pakietami SDK w IDE.

Narzędzie sdkmanager jest dostępne w pakiecie Android SDK Command-Line Tools. Aby za pomocą Menedżera pakietu SDK zainstalować wersję narzędzi wiersza poleceń, wykonaj te czynności:

  1. Pobierz najnowszy pakiet narzędzi wiersza poleceń ze strony Android Studio i rozpakuj go.
  2. Przenieś rozpakowany katalog cmdline-tools do nowego katalogu, np. android_sdk. Ten nowy katalog to katalog pakietu Android SDK.
  3. W rozpakowanym katalogu cmdline-tools utwórz podkatalog o nazwie latest.
  4. Przenieś oryginalną zawartość katalogu cmdline-tools, w tym katalog lib, bin, plik NOTICE.txt i plik source.properties, do nowo utworzonego katalogu latest. Teraz możesz używać narzędzi wiersza poleceń z tej lokalizacji.

  5. (Opcjonalnie) Aby zainstalować poprzednią wersję narzędzi wiersza poleceń, uruchom to polecenie:

    android_sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;version"
    Zamiast version wpisz wersję, którą chcesz zainstalować, na przykład 5.0.

Wykorzystanie

Za pomocą sdkmanager możesz wyświetlić listę zainstalowanych i dostępnych pakietów, zainstalować pakiety oraz zaktualizować pakiety. Więcej informacji znajdziesz w następnych sekcjach.

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)

Aby uwzględnić pakiet z kanału do channel_id, użyj opcji channel. Możesz na przykład określić kanał Canary, aby wyświetlić pakiety 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 SDK, jak pokazano w przykazie --list, otoczona cudzysłowami. Na przykład "build-tools;34.0.0" lub "platforms;android-33".

Możesz podać wiele ścieżek pakietów, rozdzielając je spacjami, ale każda z nich musi być ujęta w cudzysłowie. Oto przykładowy sposób instalowania najnowszych narzędzi platformy i narzędzi pakietu SDK na potrzeby interfejsu API na poziomie 33:

sdkmanager "platform-tools" "platforms;android-33"

Możesz też przekazać plik tekstowy z listą wszystkich pakietów:

sdkmanager --package_file=package_file [options]

Argument package_file to lokalizacja pliku tekstowego, w którym każdy wiersz to ścieżka do zainstalowania pakietu w formacie zgodnym z pakietem SDK (bez cudzysłowów).

Aby odinstalować, 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 zainstalować określoną wersję NDK niezależnie od tego, na którym kanale jest obecnie dostępna, 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 występuje podczas procesu instalacji, gdy instalujesz pakiety w Android Studio.

Jeśli nie masz zainstalowanego Android Studio lub jest ono przeznaczone na serwer CI lub inne urządzenie bezprzewodowe z systemem Linux bez zainstalowanego interfejsu graficznego, wykonaj te czynności w linii poleceń:

sdkmanager --licenses

Spowoduje to wyświetlenie prośby o zaakceptowanie wszystkich licencji, które nie zostały jeszcze zaakceptowane.

Opcje

Tabela poniżej zawiera listę dostępnych opcji dla poleceń wymienionych w poprzedniej sekcji:

Option Opis
--sdk_root=path Zamiast pakietu SDK zawierającego to narzędzie użyj ścieżki do określonego pakietu SDK.
--channel=channel_id Uwzględnij pakiety w kanałach do poziomu channel_id włącznie. Dostępne kanały:

0 (stabilna), 1 (beta), 2 (deweloperska) i 3 (Canary).

--include_obsolete Uwzględnij przestarzałe pakiety w specyfikacji lub aktualizacjach pakietów. Do użytku tylko z usługami --list i --update.
--no_https Wymuszenie korzystania przez wszystkie połączenia z protokołem HTTP zamiast HTTPS.
--newer W przypadku --list wyświetlaj tylko nowe lub aktualizowane pakiety.
--verbose Tryb szczegółowego wyjścia. Drukowanie błędów, ostrzeżeń i komunikatów informacyjnych.
--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 adres DNS serwera proxy, którego chcesz użyć.
--proxy_port=port_number Numer portu serwera proxy, z którym chcesz się połączyć.