ios-build-workflow
iOS/Swift/Xcodeのビルド・テスト・実行ワークフロー。「iOSビルド」「Xcodeエラー」「コンパイル」「シミュレーター」「swift build」「xcodebuild」などのキーワードで自動適用。
When & Why to Use This Skill
The iOS Build Workflow skill automates the essential stages of Apple platform development, including building, testing, and running Swift and Xcode projects. It streamlines the development lifecycle by providing high-level commands for xcodebuild and Swift Package Manager (SPM), helping developers quickly identify compilation errors, manage simulators, and ensure code quality through automated test execution.
Use Cases
- Rapidly checking for Swift compilation errors without performing a full project rebuild to save significant development time.
- Automating the deployment and execution of iOS applications on simulators for immediate visual and functional verification.
- Executing unit tests and managing build caches to maintain a clean and reliable development environment.
- Troubleshooting common Xcode environment issues such as missing schemes, simulator boot failures, and SPM dependency resolution errors.
| name | ios-build-workflow |
|---|---|
| description | iOS/Swift/Xcodeのビルド・テスト・実行ワークフロー。「iOSビルド」「Xcodeエラー」「コンパイル」「シミュレーター」「swift build」「xcodebuild」などのキーワードで自動適用。 |
iOS Build Workflow
iOS/Swift/Xcode プロジェクトのビルド・テスト・実行ワークフロー。
コマンド一覧
| コマンド | 用途 | 実行時間 |
|---|---|---|
/ios-dev:ios-check |
コンパイルエラーのみ高速チェック | 〜30秒 |
/ios-dev:ios-build |
フルビルド（全出力） | 1〜3分 |
/ios-dev:ios-run |
シミュレーターで実行 | 1〜3分 |
/ios-dev:ios-test |
ユニットテスト実行 | 1〜5分 |
/ios-dev:ios-clean |
ビルドキャッシュクリア | 〜10秒 |
推奨ワークフロー
コード変更 → ios-check（高速確認）
↓ エラーなし
ios-build（フルビルド）
↓ 成功
ios-run（動作確認）
↓ OK
ios-test（テスト実行）
↓ 全テストパス
コミット・PR
プロジェクト構成の検出
このプラグインは以下の順序でプロジェクトを検出:
- Makefile優先:
make ios-check等のターゲットがあれば使用 - xcodeproj検出:
*.xcodeprojを探索して xcodebuild を直接実行 - SPMプロジェクト:
Package.swiftがあればswift buildを使用
環境変数
| 変数 | 説明 | デフォルト |
|---|---|---|
IOS_PROJECT |
.xcodeproj パス | 自動検出 |
IOS_SCHEME |
ビルドスキーム | プロジェクト名と同じ |
IOS_SIMULATOR |
シミュレーター名 | iPhone 16 Pro |
IOS_DESTINATION |
xcodebuild destination | 自動生成 |
よくあるエラーと対処
シミュレーターが見つからない
❌ No booted iPhone simulator found
対処: シミュレーターを起動
open -a Simulator
# または
xcrun simctl boot "iPhone 16 Pro"
スキームが見つからない
xcodebuild: error: The project '...' does not contain a scheme named '...'
対処: 利用可能なスキームを確認
xcodebuild -list -project <project>.xcodeproj
SPM依存関係エラー
error: Dependencies could not be resolved
対処: パッケージキャッシュをクリア
rm -rf ~/Library/Caches/org.swift.swiftpm
swift package resolve
ios-architecture との連携
このプラグインは ios-architecture プラグインと補完関係:
- ios-architecture: 設計原則・レイヤー構成の知識
- ios-dev: ビルド・テスト・実行のコマンド
両方をインストールすることで、設計に沿った開発とビルドワークフローの両方をサポート。