Android Fundamentos: Registro de Aplicación

En este rápido tutorial, aprenderá a cómo usar el soporte para el registro de la aplicación en sus aplicaciones Android para diagnosticar propósitos.

Este consejo rápido le muestra los pasos para incorporar soporte de registro en sus aplicaciones y luego usa la utilidad de registro LogCat para monitorear los registros de salida de su aplicación, ya sea; un emulador o un dispositivo que está adjuntado a Eclipse por medio de un depurador. Esta habilidad es invaluable para depurar problemas, incluso cuando depuradores magníficos están disponibles para andar a través del código.

Paso 1: Crear una Aplicación Android

Comenzando a crear un proyecto Android. Implementar su aplicación Android. Una vez que haya ajustado su proyecto Android, entonces está listo para proceder con este pequeño tip.

Paso 2: Opciones de Registro para Aplicaciones Android.

La SDK de Android incluye una útil clase de uso para registro llamada android.util.Log. Los mensajes de registro son clasificados por gravedad (y palabreo) con errores siendo los más graves, después las advertencias, los mensajes de información, mensajes de depuración y los mensajes de palabreo siendo los menos graves. Cada tipo de mensaje de registro tiene su propio método. Simplemente llame el método y un mensaje de registro es creado. Los tipos de mensajes y sus llamadas de métodos relacionados son:

• El método Log.e() es utilizado para registrar errores.
• El método Log.w() es utilizado para registrar advertencias.
• El método Log.i() es utilizado para registrar mensajes de información.
• El método Log.d() es utilizado para registrar mensajes de depuración.
• El método Log.v() es utilizado para registrar mensajes de palabreo.
• El método Log.wtf() es utilizado para registrar fallas terribles que nunca deberían ocurrir. ("WTF" significa "What a Terrible Failure!" [Qué Falla tan Terrible!], por supuesto).

El primer parámetro de cada método Log es un string denominado una etiqueta. Es una práctica común definir una cadena global estática para representar la aplicación general o una actividad específica dentro de la aplicación tal como los filtros para registrar puedan ser creado para limitar los registros de salida para datos específicos. Por ejemplo, usted podría definir un string denominado TAG, así como sigue:

private static final String TAG = "MyApp";

A menudo encontrará que la etiqueta está definida como la clase en la cual ocurre la sentencia Log. Esta es una convención razonable, sin embargo, algo identificable o útil que usted hará.

Ahora, cada vez que use el método Log, usted suministra esta etiqueta. Un mensaje de información de registro podría lucir como este:

Log.i(TAG, "I am logging something informational!");

Además, puede pasar un objeto Throwable, usualmente en Exception, que le permitirá a Log imprimir un seguimiento de pila u otra información de usuarios.

try {
// ...
} catch (Exception exception) {
    Log.e(TAG, "Received an exception", exception);
}

NOTA: Al llamar al método Log.wtf(), siempre imprimirá un seguimiento de pila y puede causar que el proceso finalice con un mensaje de error. Este está realmente destinado solo para errores extremos. Para registros estándares de excepciones, recomendamos usar el método Log.e(). El método Log.wtf() está disponible solo en Android 2.2 o posteriores. El resto está disponible en todas las versiones de Android.

Paso 3: Añadiendo Registro de Soporte a una clase Activity

Ahora vamos añadir algunos registros a su clase Activity. Primero, añada la sentencia import apropiada para la clase de registro android.util.Log. Después, declare una etiqueta de registro para usarla dentro de su clase (o en toda la aplicación), en este caso, llamamos está variable DEBUG_TAG. Finalmente, añada el método de registro dondequiera que desee un registro de salida. Por ejemplo, podría añadir un mensaje de información dentro del método onCreate() de su clase Activity.

Debajo están algunas muestras de códigos que demuestran cómo todos estos pasos se unen:

package com.mamlambo.simpleapp;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;

public class MySimpleAppActivity extends Activity {
    private static final String DEBUG_TAG= "MySimpleAppLogging";

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        Log.i(DEBUG_TAG, "Info about MySimpleAppActivity.");      
    }
}

Paso 4: Monitoreando los Registros de Salida de la Aplicación - La forma fácil

Puede usar la utilidad LogCat que está dentro de Eclipse para visualizar el registro de salida desde un emulador o dispositivo. LogCat está integrado en Eclipse usando el plug-in de Desarrollo de Android. Encontrará un panel integrado LogCat en perspectivas DDMS y Debug de Eclipse.

Paso 5: Monitoreando los Registros de Salida de la Aplicación - Creando Filtros de Registro

Como puede ver, el registro de salida básico LogCat incluye registro de datos desde muchas fuentes diferentes. Para los propósitos de depuración, esto puede ser útil para filtrar la salida solo para las etiquetas para su aplicación específica. De esta manera, puede enfocarse en su registro de aplicación de salida, en medio de todo el desorden.

Puede usar la utilidad LogCat desde dentro de Eclipse para filtrar sus mensajes de registro para la etiqueta string suministrada para su aplicación. Para añadir un nuevo filtro, haga clic sobre el botón verde para suscripción en el panel LogCat de Eclipse. Nombre el filtro —quizás usando el nombre de la etiqueta— y llenándolo la etiqueta que usted quiere para filtrar. Una etiqueta nueva es creada en LogCat que mostrará solo mensajes de registro que contienen esta etiqueta. Puede crear filtros que muestren ítems para niveles de gravedad.

Consideraciones de Rendimiento con Registros

Los registros de salida ponen un apagador en el rendimiento de la aplicación. El uso excesivo puede resultar en un rendimiento de la aplicación reducido. Al mínimo, los registros de depuración y palabreo deberían ser utilizado solo para propósitos de desarrollo y quitarlos antes de la salida. Además es buena idea revisar otros registros de salida antes de la publicación.

En conclusión

El registro es una depuración muy práctica y la técnica de diagnóstico es usada por los desarrolladores. Use la clase de registro proporcionada como parte de Android SDK para registrar información importante sobre su aplicación para LogCat, pero asegúrese de revisar la implementación previa de registro de su aplicación para la publicación, ya que el registro tiene inconvenientes de rendimiento.

Sobre los Autores

Desarrolladores de Celulares; Lauren Darcey y Shane Conder son coautores de varios libros sobre el desarrollo en Android: un libro de programación a fondo titulado: Desarrollo de Aplicaciones Inalámbricas de Android y Sams Aprenda usted mismo a Desarrollar Aplicaciones para Android en 24 horas. Cuando no escriben, ellos pasan su tiempo desarrollando programas para celulares en sus empresas y proporcionando servicios de consultoría. Ellos pueden ser localizado a través de correo electrónico: androidwirelessdev+mt@gmail.com o por medio de su blog en androidbook.blogspot.com y en Twitter @androidwireless.