WWDC24) Swift Testing 소개

 

- 뛰어난 사용자 경험을 제공하려면 품질, 안정성 중요

- 자동화된 테스트는 시간이 지나도 소프트웨어 품질을 달성하고 유지할 수 있는 입증된 방법

 

swift testing은 새로운 오픈 소스 패키지로 swift를 사용해 코드를 테스트할 수 있음.

 

 

테스트 설명, 구성, 장애 발생 시 대처를 위한 세부정보, 대규모 코드베이스에 맞게 확장 가능

 

동시성 및 매크로와 같은 최신 기능 도입, Linux / Windows 등 모든 주요 플랫폼 지원

 

1️⃣ Swift Testing 개요

• Swift Testing은 Swift 전용의 새로운 오픈 소스 테스트 프레임워크로, Xcode 16에 기본 포함됨.
• 목표: 자동화된 테스트를 통해 품질과 안정성을 장기적으로 유지할 수 있도록 지원.
• XCTest와는 달리 Swift 언어의 특성과 동시성, 매크로, 태그 등 최신 기능을 활용.
• Windows, Linux 등 멀티 플랫폼 지원. GitHub 오픈소스로 공개 개발 중.

 

2️⃣ Swift Testing의 핵심 구성 요소 4가지

- 첫 번째 단계 : 프로젝트에 테스트 번들 대상 추가하기 

File > New > Target > Test 섹션에서 Unit Testing Bundle 검색

 

Xcode 16에서 테스트 시스템의 기본 선택 > Finish

 

- 첫 테스트 작성해보기

모듈 import > 전역 함수 작성 > @Test 속성 추가

 

✅ 1. 테스트 함수: @Test

• 전역 함수, 정적 함수, 인스턴스 메서드 모두 사용 가능.
• 비동기(async), 예외(throws), 액터 격리도 지원.
• @Test("설명") 형식으로 이름 지정 가능.

- 테스트에서 확인할 것 : 비디오 파일의 메타데이터가 예상과 일치하는지 

확인하려는 비디오와 예상되는 메타데이터를 초기화, 해당 모듈 가져와야함 - @testable import DestinationVideo

 

 

✅ 2. 기대치 매크로: #expect, #require

• #expect는 표현식을 평가하고 실패 시 상세 정보 제공 (소스코드와 하위 표현식 값을 캡처).
• #require는 조건 불충족 시 테스트 조기 종료.
• 모든 Swift 표현식 지원 (연산자, 메서드 등).
• 예시: 매크로를 사용해 비디오 메타데이터를 확인

#expect(video.rating == .general)
#require let user = db.firstUser else { return }

- 기대치를 수행 > 예상조건이 true인지 확인

 

실패 : 메시지 클릭 > show

메타데이터를 펼치면 해당 속성을 비교 가능

- 기간 , 해상도 필드가 모두 서로 같지 않음

- video 유형이 초기화 된 후 메타데이터가 로드되지 않는 것으로 예상

- 분할 편집기에서 비디오 이니셜라이저로 이동하여 속성이 할당되었는지 확인하여 해결하기

✅ 1. 분할 편집기 열기 단축키

수평 분할 편집기 열기	Control + Option + Command + T
수직 분할 편집기 열기	Control + Command + ↩︎ Return (또는 편집기 탭에서 오른쪽 클릭 → Split Editor)

 

또는 상단 메뉴에서 Editor > Split Editor 선택도 가능

---

✅ 2. 파일 검색 (파일 이름으로 이동)

파일 검색창 열기

Command + Shift + O

 

입력창에 파일 이름, 타입 이름, 심볼 등 검색 가능

이니셜라이저에 메타데이터 속성 할당

 

테스트 성공

 

 

#expect 매크로 추가 예시 )

== 연산자, 왼쪽 오른쪽 캡처

.isEmpty , .contains 메서드 / 오류를 보면 숫자 배열의 내용이 자동으로 표시되어있음

 

 

- 테스트에서 예상한 결과가 나오지 않아 조기 종료하고 싶을 때 ? #require 매크로

try 키워드가 있고, 표현식이 false면 오류 발생. > 테스트 실패

 

- 옵셔널 값을 안전하게 언래핑하고 값이 nil 인 경우에도 사용 가능 > 테스트 중지

 

#require 메크로를 사용해서 컬렉션의 .first 속성에 액세스하고, 요소의 속성을 확인하는 방법을 보여줌.

 

first 속성은 선택사항, 테스트의 두번째 줄은 해당 값에 의존. > 테스트 조기 중지 , 래핑 해제된 값이 nil이면 계속하는 것이 합리적이지 않기 때문.

 

 

 

 

✅ 3. 특성(Attribute)

• 테스트에 대한 설명 정보 추가, 테스트 실행 시기 또는 실행 여부 맞춤화, 테스트 동작 방식 수정
• 테스트에 메타데이터 또는 동작 제어를 부여하는 기능.
• 사용 예시: 표시 이름, 비활성화, 버그 추적 링크, 조건부 실행 등.

@Test("Test Video Rating", .bug("https://tracker/123"), .disabled("기계 고장"))

@Test 속성에 맞춤화된 표시 이름을 전달 > 테스트 내비게이터와 Xcode의 다른 위치에 표시

 

 

- 두번째 테스트 작성 : Xcode 16에 내장된 테스트 스니펫 사용 > 빈 테스트 함수 추가

 

#expect 로 contentRating이 기본값이 되도록

 

-> 이 두가지 테스트를 그룹화 해서 프로젝트에서 더 쉽게 찾을 수 있게

 

✅ 4. 모음(Suite)

• 관련 테스트 그룹화 구조체.
• @Suite 속성으로 명시 가능 (암시적 인식도 됨).
• init/deinit에서 테스트 전후 로직 실행 가능.
• 별도의 @Suite 인스턴스가 모든 인스턴스 @Test함수에 대해 별도로 생성되어 의도치 않은 상태 공유 방지.
• 테스트 상태 공유 방지를 위해 구조체 권장.

 

VideoTests라는 구조체로 래핑 > 그룹으로 테스트 실행 가능.

 

중복되는 코드를 줄일 수 있음. 각 테스트 함수가 호출되는 곳은 포함된 집합 유형의 새 인스턴스이므로 각각 자체 비디오 인스턴스를 갖게 되며 실수로 상태를 공유할수 없게 됨.

 

3️⃣ Swift Testing의 특징 및 장점

✅ Swift 문법 친화적 DSL

• XCTAssertEqual 등 별도 어설션 함수 없이도 일반 Swift 표현식 사용 가능.

✅ 상세한 실패 리포트

• 실패 시 서브 표현식의 값까지 자동 출력.
• 코드에서 디버깅에 필요한 모든 정보를 노출함.

✅ 동시성 완전 통합

• async/await, actor 격리 등을 완벽 지원.

✅ 테스트 함수 실행 조건 제어

• .enabled(if: someCondition) 또는 .disabled("이유") 특성 사용.
• CI/CD에서 조건 기반으로 테스트 실행 여부 제어 가능.

✅ 버전 제한

• @available 사용 가능. 테스트가 지원 OS 버전 조건에 따라 실행됨.

 

4️⃣  Common workflows : 조건이 있는 테스트 

일반적인 작업 흐름

 

- 조건이 있는 테스트 : 특정 기기나 환경 등 특정 상황에서만 실행 

테스트 실행 되기 전 평가할 조건 전달, 조건이 false면 테스트가 건너뛴 것으로 표시'

 

- 테스트가 실행 되지 않게 하려면 ? 테스트 비활성화. 주석처리보다 선호됨 > 컴파일된 테스트 내부의 코드를 확인하기 때문.

( 테스트가 비활성화된 이유를 설명하는데 사용하는 주석은 허용 )

 

- 테스트가 비활성화되는 이유 : 버그 추적 시스템에서 추적되는 문제 때문인 경우 

- .bug(..) 특성을 포함 시켜 url로 관련 이슈 참고 

- xcode 16 의 테스트 보고서에서 해당 버그 특성을 확인하고 클릭해 해당 url 확인 가능

 

- 테스트의 전체 본문을 특정 OS버전에서만 실행할 수 있는 경우

 

런타임에서 확인할 때 #available 사용 대신 @available(...) 속성 사용해라. > 테스트 라이브러리가 테스트에 OS버전 조건이 있다는 걸 알수 있어 이를 결과에 더 정확하게 반영.

 

5️⃣ Common workflows : 태그(Tag) 시스템과 테스트 그룹화

- 공통된 특징을 가진 테스트를 서로 다른 모음이나 파일에 있어도 연결 시킬 수 있는 방법 

✅ 태그 선언 및 사용

extension Tag {
  static let formatting = Tag("formatting")
}

@Test("테스트", .tag(.formatting))

✅ 효과

• 테스트 내비게이터에서 태그로 그룹화하거나 실행 가능.
• 테스트 계획에서 특정 태그 포함/제외 설정 가능.
• 태그 기반 리포트 분석 및 패턴 인사이트 제공.

---

 

- 맞춤형 태그 할당 기능 : 테스트 내비게이터 하단에 모든 태그가 표시

tag 탭

 

 

- 일부 데이터 서식 지정 로직의 유효성을 검사하는 테스트 

하나 더 추가

- Video 정보의 서식 지정에 관한 것 > 2개 하위 모음으로

- 서식 지정 태그를 @Suite위로 올려서 포함된 모든 테스트에서 상속되도록 할 수 있다. 

 

 

- 공통점이 있는 테스트에 태그를 연결하기

- 특정한 기능이나 하위 시스템의 유효성을 검사하는 모든 테스트에 공통 태그 적용

- 특정 태그가 있는 모든 테스트를 실행 할수 있음

- test report에서 필터링 가능

- 태그 자체는 다른 파일, 모음 또는 대상의 테스트에 적용할 수 있음.

- 여러 프로젝트 공유 가능 

 

 

swift testing : 테스트 게획에 특정한 이름보다 태그를 포함시키거나 제외하는 것이 더 좋음

- 모든 시나리오가 태그를 사용할 필요는 없음

- 런타임 조건 : .enabled(if ...)

- 태그 사용방법 -> 심화 세션

 

 

6️⃣ Common workflows : 매개변수화된 테스트 (Parameterized Test)

- 매번 다른 인수를 사용하여 테스트를 반복

 

예시 >  다양한 비디오에서 언급되는 대륙의 수를 확인하는 여러테스트 

- 새로운 videoLibrary 생성 > 비디오를 이름으로 조회 > #expect 매크로로 언급된 대륙 수 확인

매우 반복적, 테스트를 추가하는 비디오가 많아질수록 중복된 코드 때문에 유지관리가 어려워짐, 각 테스트에 고유한 함수 이름을 지정해야되는데 이름을 읽기가 어렵고 테스트하는 비디오의 이름과 일치하지 않을 수 있다.

 

✅ 목적

• 하나의 테스트 함수로 다양한 인수에 대해 반복 실행.
• 유지보수성 개선, 중복 제거, 인수별 병렬 실행 가능.

✅ 작성 방법

@Test(arguments: ["Video1", "Video2"])
func testContinents(for videoName: String) {
    let video = library.lookup(name: videoName)
    #expect(video.mentionedContinents.count >= 1)
}

✅ 장점

• 테스트 실행 시 개별 인수별 결과 제공.
• 실패한 인수만 개별 재실행 가능.
• 디버깅 시 인수 확인 및 중단점 지정 용이.

 

 

1) 서명에 매개변수를 추가

테스트에 전달할 인수 포함해야됨.

 

2) 조회할 비디오의 이름을 전달받은 인수로 대체하는 것

 

여러 비디오를 다룸 : 이름을 일반화하기 > 이 테스트의 전체 이름에 매개변수 레이블이 포함됨.

 

- 원하는 경우 인자 앞에 표시 이름이나 다른 특성을 전달하여 이름 지정 가능 

 

테스트 성공 , 내비게이터가 별도의 테스트인 것처럼 그 아래의 각 개별 비디오 표시

=> 인수 추가와 테스트 범위 확장이 쉬워짐.

 

나머지 비디오 추가 후 test 함수들 삭제

오류 > 인수 클릭 > 세부정보, 실패한 기대치 볼 수 있음.

 

- 실패한 인수만 다시 > 실행버튼으로 개별인수 실행

- 그전에 , 테스트 시작 부분에 중단점 추가

 

디버거에 표시된 videoName은 Scotland Coast -> 디버깅 진행 하여 실패 원인 보기

 

개념적으로 for..in 루프 사용하여 여러번 반복되는 단일 테스트와 유사

 

 

 

for in 루프보다 나은 방식

 

- 매개변수화된 테스트는 각 개별 인수의 세부 사항을 결과에서 명확하게 확인 가능

- 세분회된 디버깅을 위해 인수를 독립적으로 재실행 가능

- 인수를 병력 실행하여 더 효율적으로 실행 > 결과를 더 빨리 얻음.

 

 

---

7️⃣  Swift Testing vs XCTest 비교

항목	XCTest	Swift Testing
테스트 인식	메서드 이름이 test로 시작하는 모든 메서드	@Test 속성 명시
지원 타입	인스턴스 메서드	인스턴스 메서드, 정적 또는 전역함수
어설션 방식	XCTAssert* 함수들	#expect, #require 매크로
병렬 실행	제한적 (프로세스 단위)	Swift 동시성 기반 병렬 실행
상태 공유 방지	클래스 기반, 공유 위험 존재	구조체 기반, 값 타입 권장
전후 처리	setUp, tearDown 메서드 ( setUp() async throws)	init, deinit 사용 ( init() async throws )
그룹화	클래스 상속 (XCTestCase에서 상속)	중첩 구조체 및 @Suite 사용 (구조체, 액터, 클래스 가능, 의도치 않은 상태공유로 인한 버그를 피하기 위해 구조체 추천 )

 

 

 

- 마이그레이션 가능 : 점진적 진행

- 단일 대상으로 존재 가능

- 앞서 설명한대로 매개화된 변수 테스트 하나로 통합

- 테스트 이름을 정할 때 더이상 test 안붙여도 됨.

 

 

- XCTest를 계속 사용해야되는 테스트 :

XCUIApplication 과 같은 UI 자동화 API나 XCTMetric과 같은 성능 테스트 API를 사용하는 테스트는 지원되지 않음. 

Objective-C로만 작성할 수 있는 모든 테스트 

 - XCTest 어설션 함수를 Swift Testing에서 호출하거나 #expect 매크로를 XCTest에서 호출하지 말기

 

 

 

문서 : Migrating a test from XCTest 

 -> 어설션 변환하고 비동기 대기 조건 처리 방법 등 

---

8️⃣ 커맨드라인 및 플랫폼 지원

• swift test CLI에서 실행 시 콘솔에 컬러 출력 포함 상세 로그 제공.
• SwiftPM, Xcode 16, VSCode 등 주요 도구와 연동됨.
• Linux/Windows/macOS 공통 코드베이스 사용.
• 모든 플랫폼에서 일관적으로 동작 

command line 환경

터미널에서 swift test 입력 시 패키지 테스트 가능

---

9️⃣ 오픈 소스 및 커뮤니티

• GitHub에 오픈 소스로 공개됨.
• Swift Forums에서 기능 제안, 토론, 피드백 가능.
• 향후 swiftlang 조직으로 이전 예정.

---

✅ 결론

Swift Testing은 Swift 언어의 철학과 동시성 기능을 반영하여 테스트의 생산성과 정확성을 극대화한 도구입니다. 커뮤니티 중심의 오픈소스로 발전 가능성이 크며, 기존 XCTest에서 점진적 마이그레이션도 용이합니다.