Instala un APK desde tu Mac y depura Android — con o sin la Terminal

Detrás de la frase «instalar APK desde Mac» se esconden dos tareas completamente distintas, y la mayoría de las guías solo responde a una de ellas. Esta página responde a las dos y después entra en lo que de verdad atasca a la gente más adelante: leer logcat y conseguir que macOS vea el teléfono. Todos los pasos que siguen funcionan con comandos adb normales; cuando una interfaz gráfica ahorra trabajo de verdad, decimos exactamente qué hace y qué no. Actualizado en agosto de 2026.

Primero: ¿quieres la app en el Mac o en el teléfono?

Los resultados de búsqueda para esta frase están partidos por la mitad, y los primeros solo cubren una de las dos mitades. Los artículos que responden «instala BlueStacks / NoxPlayer / LDPlayer» están contestando a la primera pregunta: ejecutar software Android en el propio macOS. Para eso hace falta un emulador y, en Apple Silicon, tus opciones realistas son el emulador del propio Android Studio (gratuito, con imágenes de sistema arm64) o productos del estilo de Google Play Games en PC, no los viejos emuladores x86.

Si, en cambio, tienes un teléfono o una tablet sobre la mesa y un archivo .apk en Descargas, no necesitas ningún emulador. Necesitas ADB —el Android Debug Bridge— y un cable. De eso trata el resto de esta página.

1. ¿Quieres ejecutar la app en el propio Mac? → usa un emulador; nada de lo que viene a continuación te sirve.
2. ¿Quieres enviar la app a un dispositivo Android físico conectado al Mac? → sigue leyendo.

Paso cero: activa la depuración por USB (esta parte se hace en el teléfono)

Ninguna app de Mac puede accionar este interruptor por ti: Android exige a propósito que lo actives a mano en el dispositivo, y la primera conexión hay que confirmarla en la pantalla del teléfono. Cualquiera que afirme lo contrario se equivoca.

macOS no necesita controladores USB, a diferencia de Windows. Cuando un dispositivo no aparece, la causa casi siempre es un cable que solo carga, un hub USB o un diálogo de autorización sin confirmar.

1. Ajustes → Información del teléfono → toca siete veces Número de compilación.
2. Vuelve atrás a Ajustes → Sistema → Opciones de desarrollador → activa Depuración por USB.
3. Conecta el teléfono al Mac con un cable que transmita datos, directamente y no a través de un hub.
4. En el teléfono, acepta «¿Permitir la depuración por USB?» y marca «Permitir siempre desde este ordenador».

La vía de la Terminal: adb install

Este es el método clásico y merece la pena conocerlo aunque acabes usando una interfaz gráfica. Homebrew instala exactamente los mismos binarios de platform-tools que publica Google.

Los fallos habituales, sin rodeos: INSTALL_FAILED_UPDATE_INCOMPATIBLE significa que ya hay instalada una app con ese nombre de paquete pero firmada con otra clave; desinstálala primero. INSTALL_FAILED_VERSION_DOWNGRADE se resuelve añadiendo -d. Y «adb: no devices/emulators found» quiere decir que el paso de autorización anterior no llegó a completarse.

1. brew install --cask android-platform-tools
2. adb devices: el número de serie debe aparecer como device, no como unauthorized ni offline.
3. adb install -r ~/Downloads/app.apk (la opción -r reinstala sobre una copia existente y conserva los datos).
4. Fíjate en Success; cualquier línea que empiece por INSTALL_FAILED_ es el mensaje de error real.

La vía sin Terminal: arrastra el APK a una ventana

Si no vas a vivir dentro de la Terminal, instalar Homebrew, editar el PATH y el baile del cd platform-tools son puro trabajo de más. Super ADB Manager incluye adb y el servidor de scrcpy dentro de la propia app, así que no hay nada que instalar aparte ni nada que mantener actualizado por separado.

Es gratuita, no pide cuenta, no muestra anuncios y la telemetría viene desactivada por defecto. La app está firmada y notarizada por Apple, así que se abre con normalidad, sin el rodeo de «clic derecho → Abrir» que exigen las herramientas sin firmar de los sitios agregadores de descargas.

1. Descarga el DMG, arrastra la app a Aplicaciones y ábrela.
2. Conecta el teléfono y acepta el aviso de depuración por USB (igual que antes).
3. Selecciona el dispositivo, abre la pestaña Aplicaciones y pulsa Instalar APK o suelta el .apk directamente sobre la ventana.
4. Esa misma pestaña lista los paquetes instalados y permite abrirlos, extraer el APK de vuelta al Mac, borrar sus datos o desinstalarlos.

APK split: base.apk más los archivos de configuración

Todo lo que descargas de APKMirror como App Bundle, o lo que exporta SAI, llega en varios archivos: base.apk más split_config.arm64_v8a.apk, split_config.xxhdpi.apk, los splits de idioma, etc. Instalar solo base.apk da como resultado una app que se cierra al arrancar o que aparece sin recursos.

Todas las partes tienen que venir de la misma compilación y con la misma firma; mezclar versiones falla. Si tienes un contenedor .xapk o .apks, descomprímelo primero —los dos son archivos ZIP— e instala juntas las partes extraídas.

1. Terminal: adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. Interfaz gráfica: selecciona todas las partes a la vez en el selector de archivos, o arrástralas juntas sobre la ventana; la app ejecuta install-multiple por ti y muestra el número de partes mientras instala.

Leer logcat en un Mac sin Android Studio

adb logcat funciona perfectamente por sí solo y, para cazar un fallo rápido, la línea de comandos suele bastar. El problema es la lectura sostenida: el logcat en bruto son miles de líneas por minuto de todos los procesos del dispositivo.

El panorama de aplicaciones gráficas aquí es escaso y en su mayoría está desactualizado. Los visores de logcat más conocidos para macOS son un proyecto en Objective-C de hace una década y sus forks, una herramienta en Tcl/Tk y un par de utilidades más recientes en Rust con aspecto de terminal; existe además una opción comercial de pago. Todas dan por hecho que instalas y mantienes platform-tools por tu cuenta, y la mayoría no están firmadas, lo que en macOS 13 y posteriores significa pelearse con Gatekeeper antes de ver una sola línea.

En Super ADB Manager, la pestaña Logcat transmite en directo desde el dispositivo seleccionado con un filtro de prioridad (Todo / Info+ / Aviso+ / Error / Fatal), filtros predefinidos para Fallo, Red, Sistema y la app que está en primer plano, búsqueda de texto libre, código de colores, desplazamiento automático y borrado. Un límite que conviene decir con honestidad: la vista guarda en memoria las 2000 líneas más recientes, así que es una ventana de depuración en vivo, no un archivo de sesiones largas; para una captura completa, redirige adb logcat a un archivo.

1. adb logcat -v time: marcas de tiempo legibles.
2. adb logcat *:E: solo errores y fallos fatales.
3. adb logcat --pid=$(adb shell pidof -s com.example.app): la salida de una sola app.
4. adb logcat -c: vacía el búfer antes de reproducir un error.
5. adb logcat -v time > ~/Desktop/session.log: captura todo en un archivo.

Cuando el Mac no ve el dispositivo

No existe una página de solución de problemas específica de macOS que sea buena y esté al día, así que aquí tienes la lista de comprobación en el orden en el que realmente se resuelve. En algunos modelos de Samsung, Xiaomi y Honor hay que cambiar además el modo USB de «Solo carga» a «Transferencia de archivos» en el panel de notificaciones para que ADB se conecte.

Si adb devices muestra el número de serie con la palabra unauthorized, el teléfono está conectado y en buen estado: solo falta el diálogo de confirmación, o se denegó en su momento. Revocar las autorizaciones obliga a que vuelva a aparecer.

1. Cambia el cable. Los cables USB-C que solo cargan son, con diferencia, la causa más frecuente.
2. Conecta directamente al Mac; nada de hubs, bases de conexión ni puertos del monitor.
3. adb kill-server y después adb devices para reiniciar el daemon.
4. Opciones de desarrollador → Revocar autorizaciones de depuración USB, y luego desconecta y vuelve a conectar.
5. system_profiler SPUSBDataType | grep -i -A4 android: si aquí no aparece nada, el problema es del hardware o del cable, no de ADB.

Depuración inalámbrica y dispositivos sin ADB

Android 11 y posteriores admiten la vinculación por Wi-Fi con un código de seis dígitos, algo realmente útil cuando el puerto USB está ocupado o el dispositivo está montado en un banco de pruebas. El puerto de vinculación que muestra el teléfono es temporal y distinto del puerto de conexión. Ambas máquinas tienen que estar en la misma subred: una Wi-Fi corporativa con aislamiento de clientes lo bloquea por completo. En la app, el panel Inalámbrico busca dispositivos en la red por mDNS y acepta el código de vinculación y, mientras el dispositivo está conectado por USB, Atajos → Cambiar a Wi-Fi hace todo el traspaso con un solo clic.

Por otro lado, no todos los dispositivos hablan ADB. Los Kindle y muchas cámaras o reproductores multimedia exponen su almacenamiento solo por MTP, y Google descontinuó Android File Transfer, que sigue recomendándose por toda la web. Super ADB Manager incluye una sección Dispositivos MTP que permite explorar y transferir archivos en esos dispositivos sin ADB. Una salvedad: la sesión MTP puede cortarse si desconectas o expulsas el dispositivo a mitad de una transferencia, y hay que volver a conectar para continuar.

Requisitos y límites, dichos con claridad: versión 0.6.0, solo Apple Silicon, macOS 13 Ventura o posterior, unos 27 MB, notarizada. La grabación de pantalla se apoya en el screenrecord de Android y no funciona en algunos dispositivos HONOR y Huawei. Es una herramienta de gestión de dispositivos y de registros, no un sustituto del depurador de Android Studio: aquí no hay puntos de interrupción ni inspección de variables.

1. En el teléfono: Opciones de desarrollador → Depuración inalámbrica → Vincular dispositivo mediante código de vinculación.
2. En el Mac: adb pair 192.168.1.20:41234 y luego introduce el código de seis dígitos.
3. adb connect 192.168.1.20:5555 para conectarte y trabajar con ADB con normalidad.
4. O usa el panel Inalámbrico de la app: busca en la red, selecciona el dispositivo y escribe el código.

Preguntas frecuentes

Más guías