swift-build

SwiftプロジェクトのビルドとテストをXcodeコマンドラインで実行(iOS/macOS対応)。Use when: ビルド、テスト、xcodebuild、swift test を依頼された時。

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

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.
nameswift-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'

実行手順

  1. スキーム確認: xcodebuild -list
  2. フォーマットチェック: swift-format lint -r Sources/
  3. ビルド: 上記プラットフォーム別コマンド
  4. ユニットテスト: 上記プラットフォーム別コマンド
  5. 静的解析: 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