swift-build
SwiftプロジェクトのビルドとテストをXcodeコマンドラインで実行(iOS/macOS対応)。Use when: ビルド、テスト、xcodebuild、swift test を依頼された時。
When & Why to Use This Skill
This Claude skill automates Swift and Xcode project management via the command-line interface, enabling seamless build, test, and archival processes. It streamlines the development workflow for iOS, macOS, and Mac Catalyst applications by providing standardized commands for environment configuration, code linting, and multi-platform compilation.
Use Cases
- Automated Testing: Execute comprehensive unit test suites on specific iOS simulators or macOS environments to ensure code stability and catch regressions early.
- Build Pipeline Management: Perform clean builds, universal binary creation (arm64/x86_64), and platform-specific compilations for iOS, macOS, and Catalyst.
- Release and Archiving: Generate production-ready archives for App Store submission or internal distribution across different Apple ecosystems.
- Code Quality Assurance: Integrate static analysis and formatting checks using SwiftLint and swift-format to maintain high coding standards automatically.
- Environment Troubleshooting: Quickly identify available hardware destinations and simulator configurations using built-in diagnostic commands.
| name | swift-build |
|---|---|
| description | "SwiftプロジェクトのビルドとテストをXcodeコマンドラインで実行(iOS/macOS対応)。Use when: ビルド、テスト、xcodebuild、swift test を依頼された時。" |
Swift ビルド&テスト(iOS / macOS 対応)
プラットフォーム別コマンド
iOS Simulator
xcodebuild build -scheme YourApp -destination 'platform=iOS Simulator,name=iPhone 16e'
xcodebuild test -scheme YourApp -destination 'platform=iOS Simulator,name=iPhone 16e'
macOS
xcodebuild build -scheme YourApp -destination 'platform=macOS'
xcodebuild test -scheme YourApp -destination 'platform=macOS'
Mac Catalyst
xcodebuild build -scheme YourApp -destination 'platform=macOS,variant=Mac Catalyst'
実行手順
- スキーム確認:
xcodebuild -list - フォーマットチェック:
swift-format lint -r Sources/ - ビルド: 上記プラットフォーム別コマンド
- ユニットテスト: 上記プラットフォーム別コマンド
- 静的解析:
swiftlint lint
Universal Binary(macOS)
# arm64 + x86_64 のユニバーサルビルド
xcodebuild build -scheme YourApp -destination 'platform=macOS' \
ARCHS="arm64 x86_64" ONLY_ACTIVE_ARCH=NO
クリーンビルド
xcodebuild clean build -scheme YourApp -destination 'platform=macOS'
アーカイブ(リリース用)
iOS
xcodebuild archive -scheme YourApp -archivePath ./build/YourApp.xcarchive \
-destination 'generic/platform=iOS'
macOS
xcodebuild archive -scheme YourApp -archivePath ./build/YourApp.xcarchive \
-destination 'platform=macOS'
トラブルシューティング
シミュレーター一覧
xcrun simctl list devices available
利用可能なデスティネーション
xcodebuild -showdestinations -scheme YourApp