Pruebas Unitarias en Xcode: Casos Prácticos y XCT Asserts

La implementación de pruebas unitarias es fundamental para garantizar la calidad del software que desarrollamos. En el contexto de desarrollo iOS con Swift, Xcode nos proporciona herramientas poderosas para crear y ejecutar pruebas que validen el comportamiento esperado de nuestras aplicaciones. Vamos a explorar cómo aplicar estos conceptos en un proyecto real utilizando la API de Valorant.

¿Cómo implementar pruebas unitarias en un proyecto iOS?

Cuando trabajamos con pruebas unitarias en Xcode, es importante entender la estructura básica que nos proporciona el framework XCTest. Al crear un archivo de prueba, Xcode genera automáticamente una plantilla con métodos esenciales:

• setUp(): Se ejecuta antes de cada prueba, permitiéndonos preparar el entorno necesario.
• tearDown(): Se ejecuta después de cada prueba, ideal para limpiar recursos o restablecer estados.

Las pruebas individuales se definen como métodos que comienzan con la palabra "test", lo que permite a Xcode identificarlas automáticamente como casos de prueba ejecutables.

Explorando los métodos de aserción en XCTest

XCTest proporciona una variedad de métodos de aserción que nos permiten validar diferentes condiciones en nuestro código:

• XCTAssertEqual: Verifica si dos expresiones son iguales.
• XCTAssertNotEqual: Comprueba que dos expresiones sean diferentes.
• XCTAssertTrue/XCTAssertFalse: Valida si una expresión booleana es verdadera o falsa.
• XCTAssertThrowsError: Verifica si una operación lanza un error.

Veamos un ejemplo básico:

func testExample() {
    let condition = 2 > 1
    XCTAssertTrue(condition, "La condición no es correcta")
}

En este caso, estamos verificando que la condición 2 > 1 sea verdadera. Si ejecutamos esta prueba, pasará correctamente. Si cambiáramos la condición a 2 > 3, la prueba fallaría y mostraría el mensaje de error que proporcionamos.

¿Cómo probar funciones con retorno directo?

Para funciones que devuelven un valor inmediatamente, podemos usar aserciones directas. Por ejemplo:

func helloWorld(name: String) -> String {
    return "Hello, \(name)!"
}

func testHelloWorld() {
    XCTAssertEqual(helloWorld(name: "Alice"), "Hello, Alice!", "El saludo no coincide con el esperado")
}

Esta prueba verifica que nuestra función helloWorld devuelva exactamente el string esperado cuando se le pasa "Alice" como parámetro.

¿Cómo probar funciones asíncronas en Swift?

Las funciones asíncronas representan un desafío especial para las pruebas unitarias, ya que no devuelven un resultado inmediatamente. En iOS, muchas operaciones son asíncronas: llamadas a API, operaciones de base de datos, animaciones, etc.

Para probar estas funciones, XCTest proporciona el concepto de "expectativas" (expectations):

var completed = false

func functionWithCompletion(completion: @escaping () -> Void) {
    DispatchQueue.main.asyncAfter(deadline: .now() + 2) {
        self.completed = true
        completion()
    }
}

func testAsyncFunction() {
    let expectation = XCTestExpectation(description: "Function with completion")
    
    functionWithCompletion {
        expectation.fulfill()
    }
    
    wait(for: [expectation], timeout: 5)
    XCTAssertTrue(completed, "La variable completed debería ser true después de la ejecución")
}

En este ejemplo:

1. Creamos una expectativa con una descripción.
2. Llamamos a nuestra función asíncrona.
3. Cuando la función completa su ejecución, llamamos a fulfill() en nuestra expectativa.
4. Utilizamos wait(for:timeout:) para pausar la ejecución de la prueba hasta que se cumpla la expectativa o se agote el tiempo de espera.
5. Finalmente, verificamos que el estado esperado (en este caso, que completed sea true) se haya alcanzado.

Aplicación en un proyecto real

Este enfoque es particularmente útil cuando trabajamos con ViewModels que realizan llamadas a API, como en nuestro ejemplo de la aplicación de Valorant. Al probar un ViewModel que obtiene datos de una API, podemos:

1. Crear una expectativa para la finalización de la llamada.
2. Llamar al método que inicia la solicitud de red.
3. Esperar a que se complete la expectativa.
4. Verificar que los datos se hayan cargado correctamente.

¿Por qué son importantes las pruebas unitarias en el desarrollo iOS?

Las pruebas unitarias nos proporcionan múltiples beneficios:

• Detección temprana de errores: Identificamos problemas antes de que lleguen a producción.
• Refactorización segura: Podemos modificar el código con confianza, sabiendo que las pruebas detectarán regresiones.
• Documentación viva: Las pruebas sirven como ejemplos de cómo debe comportarse nuestro código.
• Mejora de diseño: Escribir código testeable nos lleva a crear arquitecturas más modulares y desacopladas.

Las pruebas unitarias son una inversión que paga dividendos a lo largo de todo el ciclo de vida de una aplicación, reduciendo el costo de mantenimiento y mejorando la calidad general del software.

Dominar las técnicas de pruebas unitarias en Swift te permitirá desarrollar aplicaciones iOS más robustas y confiables. ¿Has implementado pruebas unitarias en tus proyectos? Comparte tu experiencia en los comentarios.