KLog es una herramienta de registro especializada para el desarrollo de Android, diseñada para optimizar la depuración mediante una API intuitiva y funcionalidades avanzadas.

Funcionalidades principales

Formateo estructurado de registros

KLog incorpora automáticamente detalles de conetxto como nombre de clase, método y número de línea, facilitando la identificación rápida de orígenes de problemas en comparación con el LogCat nativo.

Parseo automático de formatos de datos

La herramienta incluye capacidades integradas para formatear JSON y XML, permitiendo una visualización clara de estructuras de datos durante la depuración.

Integración con el entorno de desarrollo

Ofrece la posibilidad de navegar directamente al código fuente desde los registros y persistir los logs en almacenamiento local para análisis posterior.

Proceso de integración

Añadir la dependencia al proyecto

Para incorporar KLog en un proyecto Android, incluye la siguiente configuración en el archivo build.gradle:

dependencies {
    implementation 'com.github.zhaokaiqiang.klog:klog-library:1.6.0'
}

Inicialización básica

Configura KLog en el método onCreate de la clase Application:

public class MiApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        KLog.init(true); // Activar la salida de registros
    }
}

Técnicas de uso y buenas prácticas

Niveles de registro variados

KLog soporta múltiples niveles de severidad para adaptarse a distintos escenarios:

KLog.v("Detalle verbose");
KLog.d("Información de depuración");
KLog.i("Mensaje informativo");
KLog.w("Advertencia detectada");
KLog.e("Error crítico");

Visualización formateada de JSON

Para datos en formato JSON, KLog los presenta de forma estructurada:

String contenidoJson = "{\"aplicacion\":\"KLog\",\"v\":\"1.6.0\"}";
KLog.json(contenidoJson);

Presentación mejorada de XML

Para contenido XML, ofrece un formateo similar para facilitar la lectura:

String contenidoXml = "<ajustes><activado>true</activado><modo>debug</modo></ajustes>";
KLog.xml(contenidoXml);

Configuraciones avanzadas

Personalización de etiquetas

Asigna etiquetas únicas a diferentes componentes para organizar los registros:

KLog.d("EtiquetaModulo", "Registro específico de un componente");

Persistencia en archivos

Habilita el almacenamiento de registros en archivos configurando la ruta deseada:

FileLog.setLog2FileEnable(true);
FileLog.setLogPath("/sdcard/registros/");

Casos de uso comunes

Utiliza KLog en callbacks de redes para inspeccionar solicitudes y respuestas, durante el parsing de datos estructurados, o para monitorear rendimiento mediante marcas de tiempo en registros.