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

プロジェクト構成の検出

このプラグインは以下の順序でプロジェクトを検出:

1. Makefile優先: make ios-check 等のターゲットがあれば使用
2. xcodeproj検出: *.xcodeproj を探索して xcodebuild を直接実行
3. 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: ビルド・テスト・実行のコマンド

両方をインストールすることで、設計に沿った開発とビルドワークフローの両方をサポート。