Android

Registros seguros

Configure el SDK de Thales para generar archivos de registro seguros y ofuscados.

Habilitar o deshabilitar el registro seguro

El registro seguro está habilitado por defecto. Puede desactivarlo durante la inicialización del SDK de Thales:

Context contexto;
String serverUrl;
byte[] serverCertificate;
String keyIdentifier;
TMGClientConfiguration configuration = new TMGClientConfiguration(activity, 
                                                                  serverUrl, 
                                                                  serverCertificate, 
                                                                  keyIdentifier);

configuration.enableSecureLog(false);

En este ejemplo, enableSecureLog(false) desactiva la generación de registros después de TMGClientConfiguration es instanciado. Con la configuración predeterminada (true), el SDK escribe registros durante la vida del proceso de la aplicación.

También puede pausar el registro temporalmente:

// Desactivar el registro seguro temporalmente.
TMGClient.getInstance().getSecureLog().setLevel(SecureLogLevel.OFF);

// Reanudar el registro con el nivel de registro predeterminado.
TMGClient.getInstance().getSecureLog().setLevel(SecureLogLevel.WARN);

Establecer el nivel de registro en OFF evita que el SDK de Thales escriba nuevas entradas de registro. Restablezca el nivel a WARN (predeterminado) u otro nivel para reanudar el registro.

Recuperar archivos de registro seguros

El SDK de Thales genera archivos de registro en el sandbox de la aplicación. Recupérelos así:

// Recuperar los archivos de registro seguro
List<File> secureLogFiles = TMGClient.getInstance().getSecureLog().getFiles();

// Procesar los archivos.

secureLogFiles contiene una lista de File objetos para los archivos de registro disponibles. Comparta estos archivos con el equipo de entrega de Thales al investigar un problema.

Registros de Logcat

Asegúrese de que está usando la variante de compilación debug.

Método 1: capturar registros con adb

Antes de capturar registros desde un dispositivo Android, confirme lo siguiente:

1. La herramienta Android Debug Bridge (ADB) está disponible en el sistema anfitrión.

2. La opción de depuración USB está habilitada en el dispositivo bajo prueba.

   • Si no está habilitada, vaya a Configuración > Opciones de desarrollador > Depuración USB.

3. El dispositivo Android está conectado al sistema anfitrión mediante un cable USB y el controlador USB está instalado.

Puede ejecutar el siguiente comando en el símbolo del sistema para verificar su configuración:

adb devices

Una respuesta similar al siguiente fragmento de código indica que el dispositivo puede ser alcanzado por la herramienta ADB:

Lista de dispositivos adjuntos
228b0e100d047ece dispositivo

Pasos recomendados para capturar registros

1. Abra el símbolo del sistema y borre todos los búferes de registro en el dispositivo:

adb logcat -b all -c

1. Inicie la captura de registros:

adb logcat > LogFileName.txt

Reemplace LogFileName.txt con el nombre de archivo que prefiera.

1. Realice el/los caso(s) de uso.

2. Presione CTRL+C en el símbolo del sistema para detener la captura de registros.

3. Recupere LogFileName.txt desde el directorio donde ejecutó el paso 2.

Método 2: usar Android Studio Logcat

Vea los registros directamente en la ventana de herramienta Logcat de Android Studio.

1. Abra la pestaña Logcat que se puede encontrar en la barra de herramientas lateral o inferior.

2. Asegúrese de que un dispositivo esté conectado y ejecute los casos de uso requeridos para el programa.

3. Filtre los mensajes con TMGSDK etiqueta.

4. Los registros aparecerán en la pestaña Logcat.