SDKManager

sdkmanager — это инструмент командной строки, который позволяет просматривать, устанавливать, обновлять и удалять пакеты для Android SDK. Если вы используете Android Studio, вам не нужно использовать этот инструмент, и вместо этого вы можете управлять своими пакетами SDK из IDE .

Инструмент sdkmanager входит в пакет Android SDK Command-Line Tools . Чтобы использовать SDK Manager для установки версии инструментов командной строки, выполните следующие действия:

1. Загрузите последний пакет инструментов командной строки со страницы Android Studio и извлеките пакет.
2. Переместите распакованный каталог cmdline-tools в новый каталог по вашему выбору, например, android_sdk . Этот новый каталог — ваш каталог Android SDK.
3. В распакованном каталоге cmdline-tools создайте подкаталог с именем latest .
4. Переместите исходное содержимое каталога cmdline-tools , включая каталог lib , каталог bin , файл NOTICE.txt и файл source.properties , в недавно созданный latest каталог. Теперь вы можете использовать инструменты командной строки из этого расположения.

5. (Необязательно) Чтобы установить предыдущую версию инструментов командной строки, выполните следующую команду:

   android_sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;version"
   

   Замените version на версию, которую вы хотите установить, например, 5.0 .
   Примечание: Для локального использования вы можете использовать latest пакеты. Для скриптов выберите определенную версию, чтобы обеспечить стабильность.

Использование

Вы можете использовать sdkmanager для просмотра установленных и доступных пакетов, установки пакетов и обновления пакетов. Для получения более подробной информации см. следующие разделы.

Список установленных и доступных пакетов

Чтобы вывести список установленных и доступных пакетов, используйте следующий синтаксис:

sdkmanager --list [options] \
           [--channel=channel_id] // Channels: 0 (stable), 1 (beta), 2 (dev), or 3 (canary)

Используйте опцию channel , чтобы включить пакет из канала до channel_id включительно. Например, укажите канал canary, чтобы вывести список пакетов со всех каналов.

Примечание: чтобы вывести только стабильные пакеты, используйте --channel=0 или полностью удалите опцию --channel .

Установить пакеты

Для установки пакетов используйте следующий синтаксис:

sdkmanager packages [options]

Аргумент packages — это путь в стиле SDK, как показано с помощью команды --list , заключенный в кавычки. Например, "build-tools;34.0.0" или "platforms;android-33" .

Вы можете передать несколько путей пакетов, разделенных пробелом, но каждый из них должен быть заключен в свой собственный набор кавычек. Например, вот как установить последние инструменты платформы и инструменты SDK для API уровня 33:

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

В качестве альтернативы вы можете передать текстовый файл, в котором указаны все пакеты:

sdkmanager --package_file=package_file [options]

Аргумент package_file — это местоположение текстового файла, в котором каждая строка представляет собой путь в стиле SDK к пакету для установки (без кавычек).

Для удаления добавьте флаг --uninstall :

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

Для установки CMake или NDK используйте следующий синтаксис:

sdkmanager --install
           ["ndk;major.minor.build[suffix]" | "cmake;major.minor.micro.build"]
           [--channel=channel_id] // NDK channels: 0 (stable), 1 (beta), or 3 (canary)

Например, используйте следующую команду для установки указанной версии NDK независимо от того, на каком канале она в данный момент находится:

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

Обновить все установленные пакеты

Чтобы обновить все установленные пакеты, используйте следующий синтаксис:

sdkmanager --update [options]

Принимать лицензии

Вам необходимо принять необходимую лицензию для каждого установленного вами пакета. Этот шаг происходит во время процесса установки, когда вы устанавливаете пакеты из Android Studio.

Если у вас не установлена ​​Android Studio или она предназначена для сервера непрерывной интеграции или другого безголового устройства Linux без установленного графического интерфейса, выполните следующие действия из командной строки:

sdkmanager --licenses

Это предложит вам принять все лицензии, которые еще не были приняты.

Параметры

В следующей таблице перечислены доступные параметры для команд, перечисленных в предыдущем разделе:

Вариант	Описание
--sdk_root= path	Используйте указанный путь SDK вместо SDK, содержащего этот инструмент.
--channel= channel_id	Включить пакеты в каналы до channel_id включительно. Доступные каналы: 0 (Стабильная), 1 (Бета), 2 (Разработка) и 3 (Канарская).
--include_obsolete	Включить устаревшие пакеты в список пакетов или обновления пакетов. Для использования только с --list и --update .
--no_https	Принудительно перевести все соединения на протокол HTTP вместо HTTPS.
--newer	С помощью --list можно отображать только новые или обновляемые пакеты.
--verbose	Режим подробного вывода. Печатаются ошибки, предупреждения и информационные сообщения.
--proxy={http | socks}	Подключитесь через прокси-сервер указанного типа: либо http для протоколов высокого уровня, таких как HTTP или FTP, либо socks для прокси-сервера SOCKS (V4 или V5).
--proxy_host={ IP_address | DNS_address }	IP- или DNS-адрес используемого прокси-сервера.
--proxy_port= port_number	Номер порта прокси-сервера для подключения.

Примечание: Если вы хотите установить пакеты для операционной системы, отличной от текущей машины, задайте для переменной среды REPO_OS_OVERRIDE значение "windows" , "macosx" или "linux" .