steipete

The Ultimate Swift Testing Playbook (2024 WWDC Edition, expanded with Apple docs from June 2025)

Updated with info from https://developer.apple.com/documentation/testing fetched via Firecrawl on June 7, 2025.

See also my blog: See also my blog post: https://steipete.me/posts/2025/migrating-700-tests-to-swift-testing

A hands-on, comprehensive guide for migrating from XCTest to Swift Testing and mastering the new framework. This playbook integrates the latest patterns and best practices from WWDC 2024 and official Apple documentation to make your tests more powerful, expressive, and maintainable.

---

1. Migration & Tooling Baseline

janodev

import Foundation
import Testing

func waitForExpectation(
    timeout: Duration,
    description: String,
    fileID: String = #fileID,
    filePath: String = #filePath,
    line: Int = #line,
    column: Int = #column,

Sherlouk

//
// DebugDevice.swift
//
// Copyright 2022 • Sidetrack Tech Limited
//

import Foundation

// This must be called on the main-thread.
var isDebugProfileInstalled: Bool {

Arutyun2312

//
//  CustomGeometryReader.swift
//
//
//  Created by Arutyun Enfendzhyan on 10.01.22.
//

import SwiftUI

struct CustomGeometryReader: View {

steipete

//
//  KeyCommand.swift
//  Adds Keyboard Shortcuts to SwiftUI on iOS 13
//  See https://steipete.com/posts/fixing-keyboardshortcut-in-swiftui/
//  License: MIT
//
// Usage: (wrap view in `KeyboardEnabledHostingController`)
// Button(action: {
//       print("Button Tapped!!")
//  }) {

htr3n

Built-in

diskutil erasevolume HFS+ 'RAM Disk' `hdiutil attach -nobrowse -nomount ram://XXXXX`

where XXXXX is the size of the RAM disk in terms of memory blocks.

Notes:

mohanpedala

Table of Contents

• set -e, -u, -x, -o pipefail
• set -e
• set -x
• set -u
• set -o pipefail
• Setting IFS
• Original Reference

set -e, -u, -x, -o pipefail

shaps80

#if os(iOS)
import UIKit
public typealias PlatformImage = UIImage
public typealias PlatformColor = UIColor
#else
import AppKit
public typealias PlatformImage = NSImage
public typealias PlatformColor = NSColor
#endif

JoeMatt

set -e

# carthage.sh : smarter carthage updating and caching by Joe Mattiello
#
# Inspired from http://shashikantjagtap.net/cache-carthage-speed-ios-continuous-integration/
#
# The purpose of this script is to reduce the amount of checkouts Carthage runs.
# I use this script in an XCode 'run script' build phase as the first phase before compiling
# If you have mutliple targets, projects, frameworks etc, you can include this script in each and it will selec
# the correct Carthage folder for each target.

DougGregor

import Darwin

@dynamicMemberLookup
struct Environment {
  subscript(dynamicMember name: String) -> String? {
    get {
      guard let value = getenv(name) else { return nil }

      return String(validatingUTF8: value)
    }