FBRetainCycleDetector es una biblioteca desarrollada por Meta (anteriormente Facebook) que permite identificar retain cycles en aplicaciones iOS mientras estas se ejecutan. Estos ciclos de retención son una de las principales causas de fugas de memoria en entornos con ARC, ya que el compilador no siempre puede determinar cuándo dos o más objetos se mantienen mutuamente con referencias fuertes. Esta herramienta resulta especialmente útil para diagnosticar problemas de memoria que solo se manifiestan en runtime.

Componentes principales de la arquitectura

La biblioteca se organiza en módulos independientes que colaboran durante el proceso de detección:

FBRetainCycleDetector

Es el coordinador central. Se encarga de recibir los objetos candidatos, construir el grafo de referencias y ejecutar el algoritmo de búsqueda. Sus métodos principales son initWithConfiguration:, addCandidate: y findRetainCycles.

FBObjectGraphConfiguration

Permite ajustar el comportamiento del análisis mediante reglas de filtrado. Es posible definir qué clases o tipos de objetos deben ignorarse durante la exploración.

FBAssociationManager

Rastrea relaciones creadas con objc_setAssociatedObject, que de otro modo serían invisibles para un análisis superficial del heap.

FBObjectiveCGraphElement y sus subclases

Modelan los nodos del grafo: objetos Objective-C, bloques, temporizadores y otros tipos especiales. Cada nodo conoce sus referencias salientes y permite recorrer el grafo.

Flujo de detección de un ciclo de retención

El proceso se divide en tres etapas principales:

1. Construcción del grafo: a partir de cada candidato, la biblioteca recorre recursivamente las referencias fuertes, incluyendo variables de instancia, propeidades, bloques capturados y objetos asociados.
2. Búsqueda de ciclos: utiliza una estrategia basada en recorrido en profundidad (DFS) para detectar caminos cerrados dentro del grafo. El límite predeterminado es un ciclo de longitud máximo 10, aunque puede configurarse.
3. Filtrado y presentación: los ciclos repetidos o que involucran únicamente objetos del sistema se descartan, devolviendo únicamente rutas útiles para el desarrollador.

Integración y uso básico

El siguiente ejemplo muestra cómo inicializar el detector, registrar un objeto y consultar los resultados:

FBObjectGraphConfiguration *graphConfig = [FBObjectGraphConfiguration defaultConfiguration];
FBRetainCycleDetector *cycleDetector = [[FBRetainCycleDetector alloc] initWithConfiguration:graphConfig];

[cycleDetector addCandidate:viewController];

NSSet *detectedCycles = [cycleDetector findRetainCycles];
for (NSArray *cyclePath in detectedCycles) {
    NSLog(@"Ciclo detectado: %@", cyclePath);
}

Para personalizar el análisis se puede proporcionar un bloque de filtrado. En este caso se excluye una clase concreta del recorrido:

FBObjectGraphConfiguration *graphConfig = 
    [FBObjectGraphConfiguration configurationWithFilterBlock:^BOOL(FBObjectiveCGraphElement *element) {
        return ![element.className isEqualToString:@"IgnoredClass"];
    }];

FBRetainCycleDetector *cycleDetector = [[FBRetainCycleDetector alloc] initWithConfiguration:graphConfig];

Tipos de objetos que puede analizar

• Instancias de clases Objective-C.
• Bloques (blocks) que capturan referencias fuertes.
• Temporizadores (NSTimer) y otras especializaciones de Foundation.
• Objetos Swift, mediante el kit de introspección incluido.
• Objetos asociados creados con la API de runtime.

Consideraciones importantes

• Impacto en rendimiento: el análisis es intensivo en CPU, por lo que debe limitarse a entornos de depuración o pruebas.
• Seguridad de hilos: el detector no es thread-safe; conviene ejecutarlo en un único hilo.
• Uso de API privada: la biblioteca accede a detalles internos del runtime, por lo que no es aconsejable incluirla en builds de producción.
• Activación condicional: la macro _INTERNAL_RCD_ENABLED permite habilitar o deshabilitar el detector, normalmente vinculada a la configuración DEBUG.