iOS 测试体系与持续集成

import XCTest
@testable import ShopKit

final class CartTests: XCTestCase {
    private var cart: Cart!

    override func setUpWithError() throws {
        cart = Cart(taxRate: 0.08)
    }

    override func tearDownWithError() throws {
        cart = nil
    }

    func testAddItemIncreasesTotal() {
        cart.add(Item(name: "Book", price: 100))
        XCTAssertEqual(cart.total, 108, accuracy: 0.001)
    }

    func testRemoveItemBelowZeroThrows() {
        XCTAssertThrowsError(try cart.remove(at: 0)) { error in
            XCTAssertEqual(error as? CartError, .indexOutOfRange)
        }
    }
}

final class ProfileServiceTests: XCTestCase {
    func testFetchProfileReturnsName() async throws {
        let service = ProfileService(client: StubHTTPClient())
        let profile = try await service.fetch(id: "42")
        XCTAssertEqual(profile.name, "Leeting")
    }

    // 测试 actor 的隔离与并发安全
    func testCounterIsSerialized() async {
        let counter = CounterActor()
        await withTaskGroup(of: Void.self) { group in
            for _ in 0..<1_000 {
                group.addTask { await counter.increment() }
            }
        }
        let value = await counter.value
        XCTAssertEqual(value, 1_000)
    }
}

protocol HTTPClient {
    func get(_ url: URL) async throws -> Data
}

// Stub：返回固定数据
final class StubHTTPClient: HTTPClient {
    var result: Result<Data, Error> = .success(Data("{}".utf8))
    func get(_ url: URL) async throws -> Data { try result.get() }
}

// Spy：记录调用参数，便于断言
final class SpyHTTPClient: HTTPClient {
    private(set) var requestedURLs: [URL] = []
    func get(_ url: URL) async throws -> Data {
        requestedURLs.append(url)
        return Data()
    }
}

import SnapshotTesting
import XCTest

final class ProfileCardSnapshotTests: XCTestCase {
    func testProfileCardLayout() {
        let view = ProfileCard(name: "Leeting", avatar: .init(systemName: "person"))
        assertSnapshot(of: view, as: .image(layout: .fixed(width: 320, height: 120)))
    }
}

import Testing

@Suite("购物车")
struct CartTests {
    @Test("加入商品后总价包含税费")
    func addItem() {
        let cart = Cart(taxRate: 0.08)
        cart.add(Item(name: "Book", price: 100))
        #expect(cart.total == 108)
    }

    // 参数化测试：一个函数跑多组数据
    @Test(arguments: [(100.0, 108.0), (0.0, 0.0), (50.0, 54.0)])
    func taxCalculation(price: Double, expected: Double) {
        let cart = Cart(taxRate: 0.08)
        cart.add(Item(name: "X", price: price))
        #expect(abs(cart.total - expected) < 0.001)
    }
}

final class LoginUITests: XCTestCase {
    func testLoginFlow() {
        let app = XCUIApplication()
        app.launchArguments += ["-uiTesting", "1"]   // 让 App 走测试专用配置
        app.launch()

        let email = app.textFields["login.email"]
        XCTAssertTrue(email.waitForExistence(timeout: 5))
        email.tap()
        email.typeText("demo@example.com")

        app.secureTextFields["login.password"].tap()
        app.secureTextFields["login.password"].typeText("secret")
        app.buttons["login.submit"].tap()

        XCTAssertTrue(app.staticTexts["home.title"].waitForExistence(timeout: 10))
    }
}

# fastlane/Fastfile
default_platform(:ios)

platform :ios do
  desc "跑单元测试并生成覆盖率报告"
  lane :test do
    scan(
      scheme: "Shop",
      device: "iPhone 15 Pro",
      code_coverage: true,
      output_types: "html,junit"
    )
  end

  desc "同步签名证书与描述文件"
  lane :certs do
    match(type: "appstore", readonly: true)
  end

  desc "构建并上传到 TestFlight"
  lane :beta do
    certs
    gym(scheme: "Shop", export_method: "app-store", include_bitcode: false)
    pilot(skip_waiting_for_build_processing: true)
  end
end

# .github/workflows/ios.yml
name: iOS CI
on:
  pull_request:
    branches: [main]
jobs:
  test:
    runs-on: [self-hosted, macOS, arm64]
    steps:
      - uses: actions/checkout@v4
      - name: Select Xcode
        run: sudo xcode-select -s /Applications/Xcode_16.0.app
      - name: Cache SwiftPM
        uses: actions/cache@v4
        with:
          path: .build
          key: spm-${{ hashFiles('Package.resolved') }}
      - name: Test
        run: bundle exec fastlane test
      - name: Upload results
        uses: actions/upload-artifact@v4
        with:
          name: test-results
          path: fastlane/test_output

# CI 上创建临时钥匙串的典型步骤
security create-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
security default-keychain -s build.keychain
security unlock-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
security set-keychain-settings -t 3600 -u build.keychain

# 后续交给 fastlane match 导入证书
bundle exec fastlane certs