XCTest: кључни појмови, класе XCTestCase и писање тестова

Šta je XCTest?

XCTest — je framework za modularno, integraciono i UI testiranje, koji je razvio Apple i ugradio u Xcode od verzije 5.0 (2013). XCTest je zamenio OCUnit (SenTestingKit) i pružio moderni API u Swift-u sa podrškom za asinhrone testove, performance testove i integraciju sa Xcode Server. Prema Swift.org (2024), XCTest je osnova testiranja u svim Apple projektima, uključujući Swift Package Manager, koji koristi XCTest za samoproveru.

XCTest radi u saradnji sa Xcode Test Navigator i Report Navigator, koji prikazuju stablo testova, istorijat izvršavanja i upoređuju rezultate između kompilacija. Test Navigator omogućava pokretanje jednog testa, grupe testova ili celog skupa bez menjanja koda. Rezultati se prikazuju kao zelene (passed), crvene (failed) i žute (skipped) ikonice. Prema Apple WWDC (2024), Xcode 16 je poboljšao paralelno pokretanje testova za 40% korišćenjem više simulatora.

XCTest podržava platforme: iOS 8.0+, macOS 10.10+, watchOS 2.0+, tvOS 9.0+. Za svaku platformu je dostupan isti API, što omogućava pisanje cross-platform testova. Swift Testing — novi Apple-ov framework (najavljen 2024), koji će u budućnosti dopuniti XCTest, ali ga neće u potpunosti zameniti. XCTest ostaje glavni framework za testiranje u Apple ekosistemu.

XCTestCase — bazna klasa za testove

XCTestCase — je bazna klasa od koje nasleđuju sve test klase u XCTest-u. Ona pruža životni ciklus testa: `setUp()` se poziva pre svakog testa, `tearDown()` — nakon svakog testa. SetUp se koristi za inicijalizaciju objekata i mock-ova, tearDown — za čišćenje resursa. setUpWithError i tearDownWithError omogućavaju obradu grešaka inicijalizacije bez try-catch u svakom testu.

Svaka metoda čije ime počinje sa `test` automatski se prepoznaje kao test u Xcode-u. Alternativno se može koristiti makro `@Test` (Swift Testing). Ime testa treba da bude opisno: `testLoginWithValidCredentials` je bolje od `testLogin1`. Dokumentovanje testova kroz komentare je dobra praksa, ali Xcode omogućava dodavanje opisa putem User-Defined Attributes.

import XCTest

class UserServiceTests: XCTestCase {

    var sut: UserService!
    var mockSession: MockURLSession!

    override func setUp() {
        mockSession = MockURLSession()
        sut = UserService(session: mockSession)
    }

    override func tearDown() {
        sut = nil
        mockSession = nil
    }

    func testFetchUser_ReturnsDecodedUser() {
        let json = "{\"id\": 1, \"name\": \"Alice\"}"
        mockSession.setResponse(json)
        let user = try await sut.fetchUser(id: 1)
        XCTAssertEqual(user.name, "Alice")
    }
}

Gornji primer prikazuje standardnu strukturu XCTestCase. sut (System Under Test) — konvencija imenovanja testiranog objekta. MockURLSession zamenjuje realnu mrežu, omogućavajući testiranje UserService-a u izolaciji. Princip „jedan test — jedna provera" pojednostavljuje otklanjanje grešaka. Svaki XCTestCase test treba da proverava jedan scenario ili jednu tvrdnju.

Asercije u XCTest-u

Bazna grupa asercija

XCTAssertTrue i XCTAssertFalse — osnovne asercije za proveru bulanskih vrednosti. XCTAssertTrue(expression) prolazi ako expression == true. XCTAssertEqual proverava jednakost dve vrednosti sa podrškom za sve tipove koji implementiraju Equatable. Za brojeve sa plivajućom zapetom koristi se XCTAssertEqual sa parametrom accuracy za uzimanje greške izračunavanja. Prema Google Testing Blog (2024), XCTAssertEqual pokriva 70% svih provera u tipičnom test skupu.

Nil asercije i greške

XCTAssertNil i XCTAssertNotNil proveravaju opcione vrednosti na nil. Ove asercije su kritične za Swift, gde se opcioni tipovi široko koriste. XCTAssertThrowsError proverava da li kod baca očekivanu grešku. XCTUnwrap — asercija koja izvlači opcionu vrednost i pada sa razumljivom porukom ako je vrednost nil. Poređenje nizova kroz XCTAssertEqual koristi doslovno poređenje, a ne semantičko. XCTAssertNoThrow — parna asercija za proveru da kod ne baca grešku.

XCTestExpectation i asinhroni testovi

XCTestExpectation — je mehanizam za testiranje asinhronog koda. Test stvara očekivanje sa opisnim imenom, prosleđuje ga asinhronoj operaciji i poziva `wait(for:timeout:)`. Ako se očekivanje ne ispuni u roku, test pada. Timeout podrazumevano je 10 sekundi, ali za brze operacije preporučuje se 1–3 sekunde da se ubrza ukupno vreme testiranja.

XCTWaiter — fleksibilnija alternativa za wait(for:timeout:). XCTWaiter omogućava čekanje na više očekivanja, konfigurisanje redosleda izvršavanja i programsku obradu timeout-a. Za razliku od wait, XCTWaiter vraća `XCTWaiter.Result`, koji se može analizirati. Delegat XCTWaiterDelegate obaveštava o kršenju redosleda očekivanja i timeout-ima.

func testAsyncLogin() {
    let expectation = XCTestExpectation(description: "login")
    var resultUser: User?

    sut.login(email: "a@b.com", password: "123") { user in
        resultUser = user
        expectation.fulfill()
    }

    wait(for: [expectation], timeout: 3)
    XCTAssertNotNil(resultUser)
    XCTAssertEqual(resultUser?.email, "a@b.com")
}

U primeru, XCTestExpectation se koristi za testiranje asinhronog prijavljivanja. fulfill() se poziva unutar callback-a, signalizirajući da je asinhrona operacija završena. Ako u roku od 3 sekunde fulfill() nije pozvan — test pada sa timeout-om. Nakon uspešnog čekanja izvršavaju se asercije za proveru rezultata. Višestruka očekivanja se mogu proslediti kao niz i čekati ispunjenje svih.

Performance testovi sa XCTest-om

measure(metrics:) — metoda XCTestCase za kreiranje performance testova. Blok koda unutar measure pokreće se 10 puta zaredom, a XCTest prikuplja statistiku: prosečno vreme, medijanu, standardnu devijaciju. Metrics — niz metrika koje se prate: XCTClockMetric (vreme), XCTMemoryMetric (memorija), XCTStorageMetric (disk) i XCTCPUMetric (procesor). Prema Apple WWDC (2024), performance testovi sa XCTCPUMetric su korisni za otkrivanje regresija u algoritmima.

Baseline (osnovna linija) za performance testove postavlja se u Xcode Test Plan-u. Ako vreme izvršavanja premašuje baseline za određen procenat (podrazumevano 10%), test se smatra neuspešnim. Baseline se ažurira ručno nakon potvrde da je promena performansi očekivana. Test Plan u Xcode-u omogućava grupisanje performance testova po konfiguracijama: debug/release, različiti uređaji, različite iOS verzije.

func testArraySortPerformance() {
    let numbers = (1...10000).shuffled()
    measure(metrics: [XCTClockMetric()]) {
        let _ = numbers.sorted()
    }
}

Ovaj performance test meri vreme sortiranja niza od 10000 elemenata. XCTClockMetric beleži realno vreme izvršavanja. Ako nakon promene algoritma sortiranja vreme poraste za 10% ili više, test će ukazati na regresiju. Performance testovi XCTest-a su posebno korisni za: algoritme obrade podataka, renderovanje UI komponenata, operacije sa bazom podataka i mrežne zahteve.

Organizacija testova i CI/CD integracija

Struktura test projekta

Struktura test projekta u XCTest-u prati konvenciju: jedan test fajl po jednoj klasi, smešten u poseban direktorijum `<TargetName>Tests`. Imena fajlova odgovaraju imenima testiranih klasa sa sufiksom `Tests`: `UserService.swift` → `UserServiceTests.swift`. Test Targets u Xcode-u se konfigurišu odvojeno za unit-testove i UI-testove, što omogućava njihovo nezavisno pokretanje. Schemes u Xcode-u upravljaju konfiguracijom kompilacije i skupom pokrenutih testova.

CI/CD integracija

Xcode Cloud i GitHub Actions podržavaju pokretanje XCTest-a kroz `xcodebuild test -scheme App -testPlan SmokeTest`. CI pipeline uključuje: kompilacija → pokretanje unit-testova → pokretanje UI-testova → objavljivanje izveštaja. JUnit izveštaj se generiše kroz `xcodebuild` sa opcijom `-resultBundlePath` i može se uvesti u bilo koji CI alat. Code Coverage — ugrađena funkcija XCTest-a koja pokazuje koje linije koda su pokrivene testovima. Minimalni prag pokrivenosti za proizvodni kod — 70% za kritičnu poslovnu logiku.

Xcode Cloud i GitHub Actions podržavaju pokretanje XCTest-a kroz `xcodebuild test -scheme App -testPlan SmokeTest`. CI pipeline uključuje: kompilacija → pokretanje unit-testova → pokretanje UI-testova → objavljivanje izveštaja. JUnit izveštaj se generiše kroz `xcodebuild` sa opcijom `-resultBundlePath` i može se uvesti u bilo koji CI alat. Bitrise i Jenkins imaju gotove korake za XCTest.

Code Coverage — ugrađena funkcija XCTest-a koja pokazuje koje linije koda su pokrivene testovima. Xcode prikazuje pokrivenost zelenom (pokriveno), crvenom (nije pokriveno) i žutom (delimično pokriveno). Minimalni prag pokrivenosti za proizvodni kod — 70% za kritičnu poslovnu logiku. Prema Google Testing Blog (2024), prinudno zahtevanje 80% pokrivenosti za sve module dovodi do pojave „praznih testova" koji ne proveravaju logiku, već samo izvršavaju kod.