Migrate project to Swift 6 (#204)

- Bump minimum iOS version to 14.0
- Update GitHub Actions workflow to use Xcode 15.4 and 16.2.

Author: kaishin

.claude/agents/swift-testing-migrator.md

@@ -0,0 +1,93 @@
+---
+name: swift-testing-migrator
+description: Use this agent when you need to migrate Swift test code from XCTest to the new Swift Testing framework. Examples include: converting XCTestCase classes to Swift Testing functions, updating assertion methods from XCTAssert* to #expect, migrating setUp/tearDown methods to Swift Testing equivalents, or when you need guidance on Swift Testing best practices and migration strategies.
+tools: Edit, MultiEdit, Write, NotebookEdit, Read, LS, Grep, Glob, Bash
+model: sonnet
+color: orange
+---
+
+You are a Swift Testing Migration Expert with comprehensive knowledge of migrating from XCTest to Apple's Swift Testing framework introduced at WWDC 2024. You understand the complete migration lifecycle and all technical nuances involved.
+
+## Core Expertise
+
+**Framework Knowledge:**
+
+- Swift Testing requires Xcode 16+ and Swift 6.0+
+- Both frameworks can coexist (XCTest is not deprecated)
+- UI automation tests (XCUIApplication) must remain in XCTest
+- Performance testing APIs (XCTMetric) are not supported in Swift Testing
+- Gradual migration is fully supported and recommended
+
+**Migration Transformations:**
+
+**Basic Structure:**
+
+- Convert `XCTestCase` classes to `struct` (or `class` if deinit needed)
+- Remove inheritance from `XCTestCase`
+- Add `@Test` macro instead of `test` prefix
+- Import `Testing` framework
+
+**Assertion Mapping:**
+
+- `XCTAssertTrue(value)` → `#expect(value)`
+- `XCTAssertFalse(value)` → `#expect(!value)`
+- `XCTAssertEqual(a, b)` → `#expect(a == b)`
+- `XCTAssertNotEqual(a, b)` → `#expect(a != b)`
+- `XCTAssertNil(value)` → `#expect(value == nil)`
+- `XCTAssertNotNil(value)` → `#expect(value != nil)`
+- `XCTAssertGreaterThan(a, b)` → `#expect(a > b)`
+- `XCTUnwrap(value)` → `try #require(value)`
+- `XCTFail(message)` → `Issue.record(message)`
+
+**Setup/Teardown:**
+
+- `setUp()` → `init()` (can be async and throws)
+- `tearDown()` → `deinit` (change to class, cannot be async/throws)
+- Swift Testing creates new instance for each test
+
+**Async Testing:**
+
+- Native async/await support without complexity
+- `XCTestExpectation` → `confirmation("description") { completed in ... }`
+- No built-in timeout support (use `@Test(.timeLimit())`)
+
+**Advanced Features:**
+
+- Parameterized testing with `@Test(arguments: [...])`
+- Multiple argument collections for combinations
+- Test traits: `.tags()`, `.disabled()`, `.enabled()`, `.timeLimit()`, `.serialized`
+- Test suites with `@Suite("Name")` for organization
+
+**Common Challenges:**
+
+- Parallel execution by default (use `.serialized` for global state)
+- No floating point tolerance (use manual epsilon comparison)
+- Missing timeout support in confirmations (use `.timeLimit()`)
+- Build time impact in early versions (mostly resolved)
+
+**Migration Strategy:**
+
+1. **Pre-migration checklist:** Backup, identify non-migratable tests, plan approach
+2. **Start simple:** Basic unit tests with straightforward assertions
+3. **Convert structure:** Remove inheritance, add @Test macros
+4. **Update assertions:** Replace XCTAssert\* with #expect
+5. **Handle setup/teardown:** Convert to init/deinit patterns
+6. **Leverage new features:** Use parameterized tests, traits, suites
+7. **Test thoroughly:** Verify behavior matches, check parallel execution
+
+**Quality Assurance:**
+
+- Ensure identical test behavior and coverage
+- Verify parallel execution compatibility
+- Test CI/CD pipeline integration
+- Validate on all target platforms
+
+**Communication Style:**
+
+- Provide before/after code examples
+- Explain migration reasoning and benefits
+- Highlight potential issues and solutions
+- Offer incremental migration approaches
+- Include comprehensive checklists
+
+You prioritize maintaining test quality while leveraging Swift Testing's modern features for improved maintainability and performance.

.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(make test-spm:*)",
+      "Bash(make test-ios:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

.github/workflows/test.yml

@@ -9,13 +9,17 @@ on:
       - master
 
 jobs:
-  build:
-    runs-on: macOS-13
+  # Device list: https://github.com/actions/runner-images/blob/main/images/macos/macos-15-Readme.md
+  build-xcode-16:
+    runs-on: macos-latest
     env:
-      DEVELOPER_DIR: /Applications/Xcode_15.0.1.app/Contents/Developer
+      DEVELOPER_DIR: /Applications/Xcode_16.2.app/Contents/Developer
 
     steps:
       - uses: actions/checkout@v1
+      - uses: maxim-lobanov/setup-xcode@v1
+        with:
+          xcode-version: "16.2.0"
       - name: Run iOS tests
         run: make test-ios
       - name: Run tvOS tests

Demo/Demo-iOS/AppDelegate.swift

@@ -1,6 +1,6 @@
 import UIKit
 
-@UIApplicationMain
+@main
 class AppDelegate: UIResponder, UIApplicationDelegate {
   var window: UIWindow?
 

Demo/Demo.xcodeproj/project.pbxproj

@@ -3,7 +3,7 @@
 	archiveVersion = 1;
 	classes = {
 	};
-	objectVersion = 46;
+	objectVersion = 54;
 	objects = {
 
 /* Begin PBXBuildFile section */
@@ -217,8 +217,9 @@
 		9D98822F19BC69CA00B790C6 /* Project object */ = {
 			isa = PBXProject;
 			attributes = {
+				BuildIndependentTargetsInParallel = YES;
 				LastSwiftUpdateCheck = 1120;
-				LastUpgradeCheck = 1200;
+				LastUpgradeCheck = 1640;
 				ORGANIZATIONNAME = "Kaishin & Co";
 				TargetAttributes = {
 					0007E16523809E9C000FED9F = {
@@ -338,16 +339,19 @@
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				INFOPLIST_FILE = "$(SRCROOT)/Demo-tvOS/Info.plist";
 				INFOPLIST_KEY_CFBundleDisplayName = Gifu;
-				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.redalemeden.Gifu-tvOSDemo";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = appletvos;
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
-				SWIFT_VERSION = 5.0;
+				SWIFT_VERSION = 6.0;
 				TARGETED_DEVICE_FAMILY = 3;
-				TVOS_DEPLOYMENT_TARGET = 13.2;
+				TVOS_DEPLOYMENT_TARGET = 18.0;
 			};
 			name = Debug;
 		};
@@ -368,22 +372,27 @@
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				INFOPLIST_FILE = "$(SRCROOT)/Demo-tvOS/Info.plist";
 				INFOPLIST_KEY_CFBundleDisplayName = Gifu;
-				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
 				MTL_FAST_MATH = YES;
 				PRODUCT_BUNDLE_IDENTIFIER = "com.redalemeden.Gifu-tvOSDemo";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = appletvos;
-				SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule";
-				SWIFT_VERSION = 5.0;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				SWIFT_VERSION = 6.0;
 				TARGETED_DEVICE_FAMILY = 3;
-				TVOS_DEPLOYMENT_TARGET = 13.2;
+				TVOS_DEPLOYMENT_TARGET = 18.0;
 			};
 			name = Release;
 		};
 		9D98825119BC69CA00B790C6 /* Debug */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
 				CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES;
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
 				CLANG_CXX_LIBRARY = "libc++";
@@ -413,6 +422,7 @@
 				COPY_PHASE_STRIP = NO;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
 				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
 				GCC_C_LANGUAGE_STANDARD = gnu99;
 				GCC_DYNAMIC_NO_PIC = NO;
 				GCC_NO_COMMON_BLOCKS = YES;
@@ -428,7 +438,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 9.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
 				MTL_ENABLE_DEBUG_INFO = YES;
 				ONLY_ACTIVE_ARCH = YES;
 				SDKROOT = iphoneos;
@@ -440,6 +450,7 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
 				CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES;
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
 				CLANG_CXX_LIBRARY = "libc++";
@@ -469,6 +480,7 @@
 				COPY_PHASE_STRIP = YES;
 				ENABLE_NS_ASSERTIONS = NO;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
 				GCC_C_LANGUAGE_STANDARD = gnu99;
 				GCC_NO_COMMON_BLOCKS = YES;
 				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
@@ -477,7 +489,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 9.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				SDKROOT = iphoneos;
 				VALIDATE_PRODUCT = YES;
@@ -493,13 +505,16 @@
 				FRAMEWORK_SEARCH_PATHS = "$(inherited)";
 				INFOPLIST_FILE = "$(SRCROOT)/Demo-iOS/Info.plist";
 				INFOPLIST_KEY_CFBundleDisplayName = Gifu;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
-				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
+				IPHONEOS_DEPLOYMENT_TARGET = 18.0;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
 				OTHER_SWIFT_FLAGS = "";
 				PRODUCT_BUNDLE_IDENTIFIER = net.4rays.Gifu.Demo;
 				PRODUCT_NAME = "Gifu-iOSDemo";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_VERSION = 5.0;
+				SWIFT_VERSION = 6.0;
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
 			name = Debug;
@@ -513,14 +528,18 @@
 				FRAMEWORK_SEARCH_PATHS = "$(inherited)";
 				INFOPLIST_FILE = "$(SRCROOT)/Demo-iOS/Info.plist";
 				INFOPLIST_KEY_CFBundleDisplayName = Gifu;
-				IPHONEOS_DEPLOYMENT_TARGET = 12.0;
-				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
+				IPHONEOS_DEPLOYMENT_TARGET = 18.0;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
 				OTHER_SWIFT_FLAGS = "";
 				PRODUCT_BUNDLE_IDENTIFIER = net.4rays.Gifu.Demo;
 				PRODUCT_NAME = "Gifu-iOSDemo";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule";
-				SWIFT_VERSION = 5.0;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				SWIFT_VERSION = 6.0;
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
 			name = Release;

Demo/Demo.xcodeproj/xcshareddata/xcschemes/Demo-iOS.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1510"
+   LastUpgradeVersion = "1640"
    version = "1.7">
    <BuildAction
       parallelizeBuildables = "YES"

Gifu.podspec

@@ -7,11 +7,11 @@ Pod::Spec.new do |s|
   s.license = { :type => "MIT", :file => "LICENSE" }
   s.author = { "Reda Lemeden" => "[email protected]" }
   s.source = { :git => "https://github.com/kaishin/Gifu.git", :tag => "v#{s.version}", :submodules => true }
-  s.platform = :ios, "9.0"
-  s.platform = :tvos, "9.0"
-  s.swift_versions = ["5.0", "5.1", "5.2", "5.3", "5.4"]
+  s.platform = :ios, "14.0"
+  s.platform = :tvos, "14.0"
+  s.swift_versions = ["5.0", "5.1", "5.2", "5.3", "5.4", "6.0", "6.1", "6.2"]
   s.ios.source_files = "Sources/**/*.{h,swift}"
   s.tvos.source_files = "Sources/**/*.{h,swift}"
-  s.ios.deployment_target = "9.0"
-  s.tvos.deployment_target = "9.0"
+  s.ios.deployment_target = "14.0"
+  s.tvos.deployment_target = "14.0"
 end