Depuración y diagnóstico en el desarrollo móvil: qué es, qué herramientas usar y cómo funciona

Modos de depuración para desarrollo móvil: Debug vs Release

Las aplicaciones móviles se compilan en dos configuraciones principales: Debug y Release. La compilación Debug incluye símbolos de depuración, no optimiza el código y usa una firma temporal — esto permite establecer breakpoints, inspeccionar variables y ejecutar el código paso a paso.

La compilación Release para desarrollo móvil es la versión final para App Store y Google Play. Release optimiza el código, elimina símbolos y registros innecesarios y firma la aplicación con un certificado de producción. La depuración en Release es imposible — si un error solo se reproduce en Release, se necesitan Crashlytics u otros reportadores de fallos.

La estrategia correcta para aplicaciones móviles: Debug para desarrollo, Release para pruebas antes de publicar. IT Sectr recomienda ejecutar la compilación Release en dispositivos de prueba 2 o 3 días antes del lanzamiento para identificar problemas que no aparecen en modo Debug (por ejemplo, ofuscación de código o errores de ProGuard/R8).

Debuggable=false es una configuración obligatoria para Release en AndroidManifest. iOS Debug y Release se diferencian por el esquema de compilación en Xcode — Debug incluye Debug executable, Release no. iOS también tiene configuración TestFlight (con reportes de fallos) y App Store.

Herramientas de Android: Logcat, Layout Inspector, Database Inspector

Android Studio proporciona un conjunto completo de herramientas para depurar y diagnosticar aplicaciones móviles en la plataforma Android. Logcat es la consola de registros del sistema Android, la herramienta principal para ver registros, filtrable por nivel (Verbose, Debug, Info, Warn, Error), proceso y etiqueta.

Logcat — Conceptos básicos

Logcat muestra los registros de todos los procesos en el dispositivo o emulador. Cada registro tiene un nivel de prioridad, una etiqueta y un mensaje — use Log.d(TAG, message) para mensajes de depuración, Log.e para errores. El filtrado por etiqueta es la mejor manera de encontrar sus registros entre miles de mensajes del sistema.

Ejemplo de salida de registro en desarrollo móvil en Android:

private static final String TAG = "MainActivity";

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Log.d(TAG, "onCreate started");
    try {
        initComponents();
        Log.i(TAG, "Components initialized successfully");
    } catch (Exception e) {
        Log.e(TAG, "Failed to init components", e);
    }
}

Layout Inspector — depurador visual de interfaz para Android, muestra la jerarquía de View, los atributos de cada elemento y su posición en la pantalla. Permite verificar parámetros de diseño, padding, margin, visibilidad y tamaños de texto en una aplicación en ejecución.

Database Inspector — permite ver y editar bases de datos SQLite directamente en Android Studio, muestra el contenido de todas las tablas, permite ejecutar consultas SQL y modificar datos en tiempo real — una herramienta indispensable para depurar consultas Room y ContentProvider.

Network Inspector — rastrea todas las solicitudes HTTP de la aplicación, mostrando URL, encabezados, cuerpo de la solicitud y respuesta, tiempo de ejecución y código de estado. Ayuda a depurar API REST, verificar la corrección de la serialización y detectar solicitudes lentas.

La depuración y el diagnóstico integral de aplicaciones móviles en Android requiere dominio de todas las herramientas mencionadas. Android Studio las combina en un solo IDE para mayor eficiencia.

Herramientas de iOS: Console, Memory Graph, View Hierarchy

Xcode proporciona un conjunto similar de herramientas para depurar y diagnosticar aplicaciones móviles en iOS. Console es el equivalente de Logcat para iOS, que muestra los registros del sistema y la aplicación agrupados por categoría y nivel (OSLogType).

Memory Graph — Diagnóstico de fugas de memoria

Memory Graph Debugger es una herramienta visual para detectar retain cycles y fugas de memoria, que muestra un gráfico de todos los objetos en memoria con sus referencias. Los nodos rojos indican fugas — objetos que deberían haberse liberado pero aún están en memoria.

Uso de Memory Graph: ejecute la aplicación, haga clic en el botón Debug Memory Graph en Xcode, seleccione un objeto e inspeccione sus referencias entrantes. Un retain cycle aparece como una dependencia circular: el objeto A retiene al objeto B, el objeto B retiene al objeto A. La solución es usar referencias débiles o no proprietarias en los closures.

View Hierarchy Debugger es el equivalente de Layout Inspector para iOS, que muestra una visualización 3D de todos los UIView en pantalla con su jerarquía, constraints y atributos. Permite seleccionar cualquier elemento y ver su posición, color, tamaño y restricciones de diseño.

Heap Dump es una instantánea de toda la memoria de la aplicación, cuyo análisis ayuda a encontrar objetos que no se liberan y estimar el uso total de memoria de cada clase. En Xcode, Heap Dump está disponible a través del Memory Report en el Debug Navigator.

LLDB es un depurador de bajo nivel para aplicaciones en C, Objective-C y Swift, que admite breakpoints, watchpoints, volcado de ensamblador y modificación dinámica de variables. El comando po (print object) en LLDB muestra la descripción de cualquier objeto en memoria.

Watchpoint es un punto de interrupción que se activa cuando cambia el valor de una variable, útil para rastrear quién y cuándo modifica el valor de un campo de objeto. A diferencia de un breakpoint, que se activa en una línea específica, un watchpoint se activa ante cualquier cambio en la memoria.

La depuración y el diagnóstico profesional en iOS requiere experiencia con Xcode y comprensión de la gestión de memoria. Apple proporciona documentación completa para cada herramienta de depuración.

Depuradores de red: Charles Proxy, Proxyman, Wireshark

Las herramientas proxy son esenciales para diagnosticar problemas de red en aplicaciones móviles. Charles Proxy es el proxy HTTP más popular para el desarrollo móvil, que permite interceptar, ver y modificar solicitudes entre la aplicación y el servidor.

Charles Proxy — Intercepción de tráfico

Charles Proxy funciona como un intermediario: configura el dispositivo para usar Charles como proxy (generalmente la IP del ordenador, puerto 8888). Charles muestra todas las solicitudes HTTP y HTTPS con la posibilidad de ver encabezados, cuerpo, cookies y tiempo de ejecución. SSL Proxying permite descifrar el tráfico HTTPS para su análisis.

Funciones de Charles: Breakpoints (pausar una solicitud para editarla), Rewrite (modificación automática de solicitudes), Map Local (sustituir respuestas con archivos locales). Map Local es indispensable para probar sin una API real — devuelve un JSON preparado previamente en lugar de la respuesta del servidor.

Proxyman es una alternativa moderna a Charles para macOS con una interfaz más limpia, mejor soporte para M1 y M2 y protección de privacidad. Admite las mismas funciones: interceptación, proxy SSL, edición de solicitudes y scripts para modificación automática del tráfico.

Wireshark es un analizador de tráfico profesional para diagnóstico profundo de red, que analiza todas las capas OSI: TCP, DNS, handshake TLS, ICMP. Se utiliza para diagnosticar conexiones lentas, problemas de DNS y errores de red de bajo nivel.

Stetho es una biblioteca de Facebook para depurar aplicaciones Android a través del navegador Chrome, que permite ver bases de datos, solicitudes de red, View Hierarchy y Shared Preferences mediante Chrome DevTools. Flipper es el sucesor de Stetho con soporte para iOS y arquitectura de plugins.

Herramientas para API: Postman, Insomnia

Los clientes API se utilizan para depurar y diagnosticar el backend de aplicaciones móviles sin ejecutar la aplicación en sí. Postman es el cliente API más popular con colecciones, pruebas y automatización, que permite enviar solicitudes GET, POST, PUT, DELETE y gestionar encabezados, cookies y variables de entorno.

Insomnia es una alternativa ligera de código abierto a Postman con una interfaz más rápida, soporte integrado para GraphQL y mejor organización de colecciones. Admite plugins: temas, exportación, generación de código en diferentes lenguajes.

Httpie es un cliente HTTP de línea de comandos con salida legible, que muestra respuestas JSON con colores, encabezados y estado directamente en la terminal. Adecuado para verificaciones rápidas de API sin abrir una aplicación GUI.

Ejemplo de uso de Httpie:

http POST https://api.example.com/v1/users \
    "Authorization: Bearer token123" \
    name="John" email="john@example.com"

IT Sectr recomienda la combinación: Postman para análisis y documentación de API + Httpie para comprobaciones rápidas. Importe una colección de Postman desde la especificación Swagger o OpenAPI — esto garantiza que los endpoints probados coincidan con la documentación del servidor.