building-apple-platform-productslisted

# Building Apple Platform Products Build, test, and archive Swift packages and Xcode projects for Apple platforms. ## When to Use This Skill Use this skill when you need to: - Build an iOS, macOS, tvOS, watchOS, or visionOS app - Build a Swift package - Run unit tests or UI tests - Create an archive for distribution - Discover project structure (schemes, targets, configurations) ## Tool Selection | Project Type | Primary Tool | When to Use | |--------------|--------------|-------------| | Standalone `Package.swift` | `swift build` | Libraries, CLI tools, cross-platform Swift (no .xcodeproj) | | `.xcworkspace` | `xcodebuild -workspace` | CocoaPods or multi-project setups | | `.xcodeproj` | `xcodebuild` | Standard Xcode projects (including those with SPM dependencies) | **Important**: The `swift build` / `swift test` commands only work for **standalone Swift packages**. If a Swift package is embedded as a submodule within an Xcode project, you must use `xcodebuild` with the appropriate scheme—the Swift CLI cannot orchestrate builds in that context. ## Project Discovery Before building, discover the project structure: ```bash # Find what project files exist ls Package.swift *.xcworkspace *.xcodeproj 2>/dev/null # List schemes and targets (auto-detects project) xcodebuild -list # Describe package (standalone SPM only) swift package describe ``` **Note**: When an Xcode project references a local Swift package, each package **target** gets its own scheme (named after th