sdkmanager

sdkmanager es una herramienta de línea de comandos que te permite ver, instalar, actualizar y desinstalar paquetes para el SDK de Android. Si usas Android Studio, no necesitas esta herramienta y, en cambio, puedes administrar tus paquetes de SDK desde el IDE.

La herramienta sdkmanager se proporciona en el paquete de herramientas de línea de comandos del SDK de Android. Para usar SDK Manager para instalar una versión de las herramientas de línea de comandos, sigue estos pasos:

  1. Descarga el paquete de herramientas de línea de comandos más reciente de la página de Android Studio y extrae el paquete.
  2. Mueve el directorio cmdline-tools descomprimido a un directorio nuevo de tu elección, como android_sdk. Este nuevo directorio es tu directorio del SDK de Android.
  3. En el directorio cmdline-tools descomprimido, crea un subdirectorio llamado latest.
  4. Mueve el contenido original del directorio cmdline-tools, incluidos el directorio lib, el directorio bin, el archivo NOTICE.txt y el archivo source.properties, al directorio latest recién creado. Ahora puedes usar las herramientas de línea de comandos desde esta ubicación.

  5. (Opcional) Para instalar una versión anterior de las herramientas de línea de comandos, ejecuta el siguiente comando:

    android_sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;version"
    Sustituye version por la versión que deseas instalar, por ejemplo, 5.0.

Uso

Puedes usar sdkmanager para enumerar los paquetes instalados y disponibles, instalar paquetes y actualizar paquetes. Si deseas obtener más información, consulta las siguientes secciones:

Enumerar los paquetes instalados y disponibles

Para enumerar los paquetes instalados y disponibles, usa la siguiente sintaxis:

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

Usa la opción channel para incluir un paquete de un canal hasta e inclusive channel_id. Por ejemplo, especifica el canal Canary para enumerar los paquetes de todos los canales.

Instalar paquetes

Para instalar paquetes, usa la siguiente sintaxis:

sdkmanager packages [options]

El argumento packages es una ruta de acceso de estilo SDK, como se muestra con el comando --list, encerrado entre comillas. Por ejemplo, "build-tools;36.0.0" o "platforms;android-36".

Puedes pasar varias rutas de acceso de paquetes separadas por un espacio, pero cada una debe estar encerrada entre su propio par de comillas. Por ejemplo, aquí se explica cómo instalar la versión más reciente de las herramientas de la plataforma y las herramientas del SDK para el nivel de API 36:

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

De manera alternativa, puedes pasar un archivo de texto que especifique todos los paquetes:

sdkmanager --package_file=package_file [options]

El argumento package_file es la ubicación de un archivo de texto en el que cada línea es una ruta de acceso de estilo SDK de un paquete para instalar (sin comillas).

Para desinstalar, agrega la marca --uninstall:

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

Para instalar CMake o el NDK, usa la siguiente sintaxis:

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

Por ejemplo, usa el siguiente comando para instalar la versión del NDK especificada independientemente del canal en el que se encuentre:

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

Actualizar todos los paquetes instalados

Para actualizar todos los paquetes instalados, usa la siguiente sintaxis:

sdkmanager --update [options]

Aceptar licencias

Debes aceptar la licencia necesaria para cada paquete que hayas instalado. Este paso se produce durante el flujo de instalación cuando instalas paquetes desde Android Studio.

Si no tienes instalado Android Studio o es para un servidor de CI o algún otro dispositivo Linux sin interfaz gráfica, haz lo siguiente desde la línea de comandos:

sdkmanager --licenses

Esto te solicitará que aceptes las licencias que aún no se hayan aceptado.

Opciones

En la siguiente tabla, se enumeran las opciones disponibles para los comandos que se mencionan en la sección anterior:

Opción Descripción
--sdk_root=path Usa la ruta de acceso del SDK especificada en lugar del SDK que contiene esta herramienta.
--channel=channel_id Incluye paquetes en los canales hasta channel_id inclusive. Los canales disponibles son los siguientes:

0 (estable), 1 (beta), 2 (desarrollo) y 3 (Canary).

--include_obsolete Incluye paquetes obsoletos en la lista de paquetes o actualizaciones de paquetes. Solo se puede usar con los elementos --list y --update.
--no_https Fuerza todas las conexiones para que usen HTTP en lugar de HTTPS.
--newer Con --list, muestra solo los paquetes nuevos o actualizables.
--verbose Modo de salida detallado. Se imprimen errores, alertas y mensajes informativos.
--proxy={http | socks} Conéctate por medio de un proxy del tipo específico: ya sea http para protocolos de alto nivel como HTTP o FTP, o bien socks para un proxy SOCKS (V4 o V5).
--proxy_host={IP_address | DNS_address} Corresponde a la dirección IP o DNS del proxy que se usará.
--proxy_port=port_number Corresponde al número de puerto de proxy al que se conectará.