ADB en Mac: instalación de Platform-Tools y comprobación de la conexión del dispositivo

Para utilizar adb en Mac, no es necesario instalar Android Studio completo. Para la línea de comandos basta con el paquete oficial Android SDK Platform-Tools para Mac. Si Studio ya gestiona tu Android SDK, Google recomienda obtener Platform-Tools mediante SDK Manager en lugar de crear otra copia independiente.

Esta guía se basa en la documentación de Google y no es un informe de pruebas prácticas: los pasos no se han probado en un Mac con un dispositivo Android. Los comandos siguientes están destinados a ejecutarse en tu Mac con tu dispositivo; aquí no se incluyen resultados de ejecución ni capturas de pantalla.

1. Elige una única fuente de instalación

Si ya tienes instalado Android Studio

Abre Tools > SDK Manager. En la pestaña SDK Tools, selecciona Android SDK Platform-Tools, después pulsa Apply u OK y consulta las condiciones de la licencia. Anota el valor de Android SDK Location: el adb instalado se encuentra en el subdirectorio platform-tools de ese SDK concreto.

En la documentación de Google, android_sdk/platform-tools/ representa el directorio de tu SDK, no una ruta literal que debas pegar en Terminal. No des por hecho que el SDK está en el directorio predeterminado: toma como referencia SDK Manager. Instrucciones de Google sobre SDK Manager.

Si solo necesitas adb

Abre la página oficial de Platform-Tools, selecciona Download SDK Platform-Tools for Mac, lee las condiciones del Android SDK License Agreement y descarga el ZIP. Descomprime el archivo y guarda la carpeta platform-tools en una ubicación permanente de tu elección. No ejecutes la versión para Windows o Linux.

En Terminal, escribe cd con un espacio, arrastra la carpeta platform-tools descomprimida desde Finder hasta la ventana de Terminal y pulsa Retorno. Así accederás al directorio real sin introducir el nombre de usuario de otra persona ni una ruta inventada. Después, comprueba lo siguiente:

./adb version

El prefijo ./ significa «ejecutar adb desde la carpeta actual». El mero hecho de que el archivo esté en esa carpeta no significa que el comando adb sin prefijo se vaya a encontrar mediante PATH. Para las primeras comprobaciones no es necesario añadir el directorio al PATH global.

Google ofrece un ZIP independiente para la línea de comandos sin Studio; el paquete oficial se distribuye conforme a las condiciones del SDK, no con una supuesta «licencia gratuita sin restricciones». Fuente y condiciones de descarga.

La ficha de Platform-Tools en OpenNavo reúne información sobre el paquete. En el momento de preparar este artículo, la recomendación en el catálogo está suspendida. Este es el estado en OpenNavo, no una afirmación de que Google haya dejado de distribuir las herramientas: el ZIP oficial para Mac sigue figurando en la página de Google. Esta guía utiliza la fuente oficial sin modificar el estado de la ficha.

2. Comprueba qué copia de adb estás ejecutando

Si esperas poder ejecutar adb desde cualquier directorio, ejecuta:

which -a adb
adb version

which -a adb ayuda a ver las copias encontradas en PATH; adb version muestra la versión del cliente que se ejecuta. Compara las rutas encontradas con el directorio elegido en el paso anterior. Estas comprobaciones tienen finalidades distintas: conocer la versión no demuestra por sí solo que estés utilizando la instalación correcta.

Si no se encuentra el comando, vuelve a la carpeta platform-tools elegida y utiliza ./adb version. En ese caso, en los comandos posteriores de este artículo sustituye también el adb inicial por ./adb: por ejemplo, ./adb devices -l. Esta opción también funciona con el directorio instalado mediante SDK Manager.

Si se detectan varias instalaciones, determina primero cuál necesita tu SDK o tu flujo de trabajo. No borres otras copias ni sobrescribas la configuración del intérprete de comandos al azar. Los clientes adb se comunican con un servidor común en el puerto TCP local 5037, por lo que la elección del archivo del cliente y el estado del servidor que ya está en ejecución no son lo mismo. Para esta guía basta con utilizar de forma coherente la copia elegida. Cómo funciona adb.

3. Conecta tu dispositivo Android por USB

1. En un dispositivo de tu propiedad, abre las opciones para desarrolladores y activa USB debugging / Depuración por USB. Si la sección está oculta, sigue las instrucciones de Google para activar las opciones para desarrolladores; los nombres de las opciones pueden variar según el fabricante.
2. Conecta el dispositivo al Mac con un cable capaz de transmitir datos. Desbloquea la pantalla.
3. Ejecuta el comando para mostrar la lista de dispositivos:

adb devices -l

4. Comprueba la solicitud en el propio dispositivo. Android 4.2.2 y versiones posteriores solicitan la confirmación de la clave RSA del ordenador para la depuración. Autoriza el acceso únicamente a tu propio ordenador de confianza y solo si esperabas esa conexión; no guardes una autorización de confianza permanente en un ordenador ajeno.
5. Tras confirmar, vuelve a ejecutar adb devices -l.

Según la documentación de Google, macOS no requiere ninguna configuración adicional del sistema operativo para detectar el dispositivo. No apliques aquí instrucciones sobre controladores USB de Windows o udev de Linux. Esto no garantiza el funcionamiento con cualquier cable y cualquier dispositivo. Conexión USB y autorización RSA.

El comando devices enumera los dispositivos y -l activa la salida detallada. El comando adb tcpip 5555 no enumera los dispositivos: cambia el modo de escucha del servicio en el dispositivo. No es necesario para esta comprobación por USB y no debes ejecutarlo. Referencia de comandos de adb.

4. Interpreta el resultado, no solo la presencia de una línea

A continuación se describen estados, no resultados de pruebas de un dispositivo concreto.

Qué ves	Qué significa	Qué comprobar a continuación
command not found	El intérprete de comandos no ha encontrado el comando por su nombre	Accede a la carpeta elegida y comprueba ./adb version; después utiliza ./adb devices -l
El encabezado de la lista sin líneas de dispositivos	Esta consulta no ha mostrado dispositivos conectados	Comprueba la conexión, el cable de datos, que el dispositivo esté desbloqueado y que la depuración USB esté activada; prueba otro cable en buen estado u otro puerto USB
Una línea con unauthorized	La conexión aún no está autorizada para la depuración	Mira la pantalla desbloqueada del teléfono y confirma la solicitud RSA esperada; si no aparece ninguna solicitud, desconecta y vuelve a conectar el USB y comprueba de nuevo la lista
Una línea con device	El dispositivo está conectado al servidor adb	Comprueba el número de serie y el modelo; esto no demuestra que Android haya terminado de arrancar ni que los comandos posteriores vayan a ejecutarse correctamente
Una línea con offline	El dispositivo no está conectado a adb o no responde	Comprueba la conexión y el estado del dispositivo; no lo consideres una autorización correcta
Varias líneas	Se han detectado varios dispositivos o emuladores	Selecciona explícitamente el dispositivo deseado antes del siguiente comando

Las comprobaciones del cable y de los ajustes se corresponden con las recomendaciones de Google sobre la conexión USB. Si no resuelven el problema, consulta la documentación del fabricante del dispositivo; no desactives la protección de macOS ni intentes eludir la autorización del teléfono.

Google advierte expresamente de que el estado device no significa que Android haya terminado de arrancar y esté listo para todas las operaciones. Estados en la lista de dispositivos.

5. Si hay varios dispositivos, selecciona uno explícitamente

Copia el número de serie de la línea correspondiente en adb devices -l. Para comprobar el estado de un dispositivo concreto, puedes utilizar:

adb -s SERIAL get-state

SERIAL es un marcador de posición: sustitúyelo por el número de serie real de tu dispositivo; no introduzcas esa palabra literalmente. Si ejecutas la herramienta desde el directorio actual, utiliza ./adb -s SERIAL get-state. Se trata de una consulta de estado, no de la instalación de una aplicación ni de una modificación de archivos.

El parámetro -s selecciona el dispositivo con el número de serie indicado. No te fíes del orden de las líneas, especialmente si también hay un emulador en ejecución. Selección de dispositivos en la guía de adb de Google.

6. Finaliza la sesión sin mantener autorizaciones de confianza innecesarias

Después de la comprobación, desconecta el cable y desactiva la depuración USB si ya no la necesitas. Si has autorizado al ordenador para futuras sesiones de depuración y quieres revocar esa confianza, utiliza la opción para revocar las autorizaciones de depuración USB en las opciones para desarrolladores del dispositivo, si está disponible. El nombre y la ubicación dependen del fabricante; la revocación también puede afectar a otros ordenadores autorizados anteriormente.

Cerrar Terminal no implica por sí solo revocar la confianza. No borres manualmente claves ni archivos de servicio para realizar esta comprobación. No publiques números de serie, huellas de claves ni otros identificadores del dispositivo en capturas de pantalla o informes.

Respuestas breves

¿Es necesario instalar Android Studio solo para usar adb? No. Google ofrece un paquete Platform-Tools independiente para Mac. Si ya utilizas Studio, resulta más cómodo dejar la gestión de las herramientas en manos de SDK Manager.

¿Por qué funciona ./adb version y no adb version? La primera opción apunta al archivo del directorio actual; la segunda depende de la búsqueda del comando que realiza el intérprete de comandos. Para esta guía puedes seguir utilizando ./adb sin cambiar la configuración global.

¿device significa que todo está listo? Indica que hay conexión con adb, pero no garantiza que el sistema haya terminado de arrancar, que la aplicación funcione ni que cualquier comando posterior sea seguro.

¿Hace falta la depuración inalámbrica? No, no es necesaria para este procedimiento por USB. Aquí no se incluyen pasos para abrir un puerto de red ni para establecer una conexión inalámbrica.

Fuentes y límites de la verificación

• Google: SDK Platform-Tools y descarga para Mac.
• Google: Android Debug Bridge — autorización, lista y selección de dispositivos.
• Google: SDK Manager.
• Google: conexión de un dispositivo real y comprobación del USB.
• AOSP: referencia de adb.

Este artículo se ha elaborado a partir de la documentación oficial de Google; no se ha realizado ninguna comprobación práctica en un Mac con un dispositivo Android. No se incluyen resultados de rendimiento confirmados, pruebas de compatibilidad con una versión concreta de macOS ni capturas de pantalla de comandos supuestamente ejecutados.