menedżer pakietu SDK

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

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

  1. Pobierz najnowszy pakiet „tylko narzędzia wiersza poleceń” ze strony pobierania w Android Studio i rozpakuj go.
  2. Przenieś rozpakowany katalog cmdline-tools do nowego katalogu, np. android_sdk. Ten nowy katalog to katalog z pakietem Android SDK.
  3. W rozpakowanym katalogu cmdline-tools utwórz podkatalog o nazwie latest.
  4. Przenieś zawartość oryginalnego katalogu cmdline-tools, w tym katalog lib, katalog 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"
    Zastąp version wersją, którą chcesz zainstalować, np. 5.0.

Wykorzystanie

sdkmanager umożliwia wyświetlanie listy zainstalowanych i dostępnych pakietów oraz instalowanie i aktualizowanie pakietów. Więcej informacji znajdziesz w kolejnych 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)

Użyj opcji channel, aby dodać pakiet z kanału do channel_id włącznie. Możesz np. wskazać kanał do wczesnych testów, aby wyświetlić listę pakietów ze wszystkich kanałów.

Zainstaluj pakiety

Aby zainstalować pakiety, użyj następującej składni:

sdkmanager packages [options]

Argument packages to ścieżka w stylu pakietu SDK podana w poleceniu --list, ujęta w cudzysłów. np. "build-tools;34.0.0" lub "platforms;android-33".

Możesz przekazać wiele ścieżek przesyłek oddzielonych spacją, ale każda z nich musi mieć własny zestaw cytatów. Oto przykład instalacji najnowszych narzędzi platformy i narzędzi SDK dla interfejsu API poziomu 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 wskazuje lokalizację pliku tekstowego, w którym każdy wiersz jest ścieżką pakietu do zainstalowania w stylu SDK (bez cudzysłowu).

Aby odinstalować aplikację, dodaj flagę --uninstall:

sdkmanager --uninstall packages [options]
sdkmanager --uninstall --package_file=package_file [options]

Aby zainstalować CMake lub NDK, użyj następującej 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)

Jeśli na przykład chcesz zainstalować określoną wersję NDK niezależnie od kanału, 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

Aktualizuj wszystkie zainstalowane pakiety

Aby zaktualizować wszystkie zainstalowane pakiety, użyj tej składni:

sdkmanager --update [options]

Zaakceptuj licencje

Musisz zaakceptować niezbędną licencję na każdy zainstalowany pakiet. Ten krok ma miejsce w trakcie procesu instalacji, gdy instalujesz pakiety z Android Studio.

Jeśli nie masz zainstalowanego Android Studio albo jest ono przeznaczone dla serwera CI lub innego bez interfejsu graficznego z systemem Linux bez zainstalowanego GUI, wykonaj te czynności z wiersza poleceń:

sdkmanager --licenses

Pojawi się prośba o zaakceptowanie wszystkich licencji, które nie zostały jeszcze zaakceptowane.

Opcje

W tabeli poniżej znajdziesz dostępne opcje poleceń wymienionych w poprzedniej sekcji:

Opcja Opis
--sdk_root=path Użyj określonej ścieżki pakietu SDK zamiast pakietu SDK zawierającego to narzędzie.
--channel=channel_id Uwzględnij pakiety w kanałach o maksymalnym identyfikatorze channel_id. Dostępne kanały:

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

--include_obsolete Dołącz przestarzałe pakiety w informacjach o pakiecie lub aktualizacjach pakietu. Do użytku tylko z --list i --update.
--no_https Wymuszaj, aby wszystkie połączenia korzystały z protokołu HTTP zamiast HTTPS.
--newer W usłudze --list pokazuj tylko nowe pakiety lub pakiety, które można zaktualizować.
--verbose Tryb szczegółowych danych wyjściowych. Wydrukowane zostaną 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) albo 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żywać.
--proxy_port=port_number Numer portu serwera proxy, z którym chcesz się połączyć.
.