Mejores prácticas para el registro de errores y / o informes para iPhone

Esto es lo que hacemos:

• Deje que el iPhone maneje sus propios volcados de bloqueo a través de los mecanismos existentes de la Tienda de aplicaciones. Actualización: habiendo encontrado que iTunes Connect no es confiable para proporcionar informes de fallas, recomiendo usar Fabric/Crashlytics, o un competidor como Crittercismo Rollbar.
• Nuestro producto lanzado no tiene rastro, esto parece ser consistente con lo que la mayoría de las otras aplicaciones de iPhone hacen.
• Si un error es reportado luego lo reproducimos usando una compilación trazada.

Con más detalle:

• Definimos macros para NSLog trace en numerosos niveles diferentes de granularidad.
• Use la configuración de compilación de Xcode para cambiar el nivel de seguimiento, que controla la cantidad de seguimiento que se compila en el producto, por ejemplo, hay configuraciones de compilación de liberación y Depuración.
• Si no se define ningún nivel de seguimiento, entonces mostramos el seguimiento completo en el Simulador, y no hay seguimiento cuando se ejecuta en un dispositivo real.

He incluido un código de ejemplo a continuación que muestra cómo hemos escrito esto y cómo se ve la salida.

Definimos múltiples niveles de seguimiento diferentes para que los desarrolladores puedan identificar qué líneas de seguimiento son importantes y puedan filtrar los detalles de nivel inferior si así lo desean.

Código de ejemplo:

- (void)myMethod:(NSObject *)xiObj
{
  TRC_ENTRY;
  TRC_DBG(@"Boring low level stuff");
  TRC_NRM(@"Higher level trace for more important info");
  TRC_ALT(@"Really important trace, something bad is happening");
  TRC_ERR(@"Error, this indicates a coding bug or unexpected condition");
  TRC_EXIT;
}

Ejemplo de salida de traza:

2009-09-11 14:22:48.051 MyApp[3122:207] ENTRY:+[MyClass myMethod:]
2009-09-11 14:22:48.063 MyApp[3122:207] DEBUG:+[MyClass myMethod:]:Boring low level stuff
2009-09-11 14:22:48.063 MyApp[3122:207] NORMAL:+[MyClass myMethod:]:Higher level trace for more important info
2009-09-11 14:22:48.063 MyApp[3122:207] ALERT:+[MyClass myMethod:]:Really important trace, something bad is happening
2009-09-11 14:22:48.063 MyApp[3122:207] ERROR:+[MyClass myMethod:]:Error, this indicates a coding bug or unexpected condition
2009-09-11 14:22:48.073 MyApp[3122:207] EXIT:+[MyClass myMethod:]

Nuestras definiciones de traza:

#ifndef TRC_LEVEL
#if TARGET_IPHONE_SIMULATOR != 0
#define TRC_LEVEL 0
#else
#define TRC_LEVEL 5
#endif
#endif

/*****************************************************************************/
/* Entry/exit trace macros                                                   */
/*****************************************************************************/
#if TRC_LEVEL == 0
#define TRC_ENTRY    NSLog(@"ENTRY: %s:%d:", __PRETTY_FUNCTION__,__LINE__);
#define TRC_EXIT     NSLog(@"EXIT:  %s:%d:", __PRETTY_FUNCTION__,__LINE__);
#else
#define TRC_ENTRY
#define TRC_EXIT
#endif

/*****************************************************************************/
/* Debug trace macros                                                        */
/*****************************************************************************/
#if (TRC_LEVEL <= 1)
#define TRC_DBG(A, ...) NSLog(@"DEBUG: %s:%d:%@", __PRETTY_FUNCTION__,__LINE__,[NSString stringWithFormat:A, ## __VA_ARGS__]);
#else
#define TRC_DBG(A, ...)
#endif

#if (TRC_LEVEL <= 2)
#define TRC_NRM(A, ...) NSLog(@"NORMAL:%s:%d:%@", __PRETTY_FUNCTION__,__LINE__,[NSString stringWithFormat:A, ## __VA_ARGS__]);
#else
#define TRC_NRM(A, ...)
#endif

#if (TRC_LEVEL <= 3)
#define TRC_ALT(A, ...) NSLog(@"ALERT: %s:%d:%@", __PRETTY_FUNCTION__,__LINE__,[NSString stringWithFormat:A, ## __VA_ARGS__]);
#else
#define TRC_ALT(A, ...)
#endif

#if (TRC_LEVEL <= 4)
#define TRC_ERR(A, ...) NSLog(@"ERROR: %s:%d:%@", __PRETTY_FUNCTION__,__LINE__,[NSString stringWithFormat:A, ## __VA_ARGS__]);
#else
#define TRC_ERR(A, ...)
#endif

Configuración de Xcode:

En Xcode configuración de compilación, elija "Agregar configuración definida por el usuario" (haciendo clic en el pequeño engranaje en la parte inferior izquierda de la pantalla de configuración de compilación), luego defina una nueva configuración llamada GCC_PREPROCESSOR_DEFINITIONS y dale el valor TRC_LEVEL=0.

La única sutileza es que Xcode no sabe hacer una compilación limpia si cambia esta configuración, así que recuerde hacer una limpieza manualmente si la cambia.