XCTest para Swift: Guia completo com exemplos práticos

1. O que é e para que serve

XCTest é o framework padrão da Apple para testes unitários (unit testing) e testes de interface do usuário (UI testing) em aplicativos. Ele vem integrado diretamente no Xcode e é a principal ferramenta para verificar a qualidade do código em Swift e Objective-C. O XCTest oferece um conjunto poderoso e flexível de APIs para escrever, organizar e executar testes, desde verificações simples de funções individuais até testes complexos de integração e de interface do usuário.

Por que usar o XCTest? No desenvolvimento de software moderno, testar não é um luxo, é uma necessidade. O XCTest permite automatizar a verificação do código, o que é essencial para manter a qualidade do aplicativo a longo prazo. Com ele, você pode:

• Detectar regressões: Após alterar o código, execute os testes rapidamente para garantir que a nova funcionalidade não quebrou algo que já funcionava.
• Documentar o código: Testes bem escritos funcionam como documentação viva, mostrando exatamente como cada parte do sistema deve se comportar.
• Melhorar a arquitetura: Esforçar-se para tornar o código testável geralmente resulta em uma arquitetura mais limpa, modular e com baixo acoplamento.
• Acelerar o desenvolvimento: Em vez de executar o aplicativo manualmente e repetir as mesmas ações várias vezes, você pode rodar uma suíte de testes com um único clique.

O XCTest está integrado ao Xcode em todos os níveis: desde a criação de alvos de teste (test targets) até a exibição dos resultados em relatórios práticos (Test Navigator). Ele suporta execução paralela de testes, medição de desempenho (performance testing) e testes assíncronos, tornando-se uma solução versátil para projetos de qualquer porte.

2. Instalação

O XCTest não é instalado via gerenciadores de pacotes como pip ou npm. Ele faz parte do ecossistema Apple e já vem junto com o Xcode. Nenhum comando adicional é necessário para usá-lo.

Para começar a escrever testes, siga estes passos no Xcode:

1. Abra seu projeto.
2. No menu, selecione File → New → Target.
3. Na janela que aparecer, escolha a aba Test e depois Unit Testing Bundle (ou UI Testing Bundle para testes de UI).
4. Clique em Next, dê um nome ao alvo (ex: "SeuAppTests") e clique em Finish.

O Xcode criará automaticamente um arquivo modelo para você adicionar seus testes. Não é necessário importar o XCTest no código, pois ele é vinculado automaticamente ao alvo de teste.

Para projetos que usam Swift Package Manager (SPM), o XCTest também está disponível sem etapas extras. Ao criar um pacote com o comando swift package init --type executable ou --type library, o SPM cria automaticamente o diretório de teste Tests com os arquivos necessários.

3. Início rápido — exemplo mínimo funcional

Vamos ver um exemplo simples. Suponha que temos uma estrutura Calculator que queremos testar:

// Arquivo: Sources/Calculator.swift
struct Calculator {
    func add(_ a: Int, _ b: Int) -> Int {
        return a + b
    }
    
    func subtract(_ a: Int, _ b: Int) -> Int {
        return a - b
    }
}

Agora, vamos criar o arquivo de teste (o Xcode cria um automaticamente se você seguiu as instruções acima):

// Arquivo: Tests/MyProjectTests/CalculatorTests.swift
import XCTest
@testable import MyProject // Substitua "MyProject" pelo nome do seu módulo

final class CalculatorTests: XCTestCase {
    
    func testAddition() {
        // 1. Arrange (Preparação)