ios-device-build

name	ios-device-build
description	Swift/iOSアプリを実機にビルド・インストール・起動する。使用タイミング: 「実機にビルドして」「iPhoneで動かして」「デバイスにインストールして」など。xcodebuild → devicectl install → devicectl launchの一連のフローを自動化。

iOS Device Build

iOS実機へのビルド・インストール・起動を自動化するスキル。

実行フロー

Step 1: 設定確認

まず設定ファイルの存在を確認:

CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/agent-skills/ios-device-build"
cat "$CONFIG_DIR/settings.conf" 2>/dev/null || echo "NOT_FOUND"

Step 2: 設定がない場合 → ユーザーに質問

設定ファイルが存在しない、または NOT_FOUND の場合:

1. 接続中のデバイス一覧を取得:

xcrun devicectl list devices 2>/dev/null

2. ユーザーに質問:

   • 「どのデバイスをデフォルトとして使用しますか？」
   • 取得したデバイス一覧から選択肢を提示
   • 選択肢に「自動検出（毎回最初のデバイスを使用）」も含める

3. 設定ファイルを作成:

CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/agent-skills/ios-device-build"
mkdir -p "$CONFIG_DIR"
cat > "$CONFIG_DIR/settings.conf" << 'EOF'
# iOS Device Build - 設定ファイル
DEFAULT_DEVICE_NAME="<ユーザーが選んだデバイス名>"
DEFAULT_SCHEME=""
NOTIFY_LANGUAGE="ja"
BUILD_LOG_LINES=30
EOF

Step 3: ビルド実行

設定が確認できたら、ビルドスクリプトを実行:

bash "$(agent-skill-path ios-device-build scripts/device_build.sh)" <project_path> [scheme] [device_name] [bundle_id]

パラメータ

パラメータ	説明	デフォルト
project_path	プロジェクトのパス	.（カレントディレクトリ）
scheme	ビルドスキーム	設定ファイル → xcodeproj名から自動検出
device_name	デバイス名	設定ファイル → 接続中の最初のデバイス
bundle_id	バンドルID	Info.plistから自動取得

優先順位: コマンド引数 > 設定ファイル > 自動検出

設定の変更

ユーザーが「デバイスを変更したい」「設定をリセットしたい」と言った場合:

1. 現在の設定を表示:

CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/agent-skills/ios-device-build"
cat "$CONFIG_DIR/settings.conf"

2. ユーザーに新しい設定を確認
3. 設定ファイルを更新

設定ファイル形式

$XDG_CONFIG_HOME/agent-skills/ios-device-build/settings.conf (XDG_CONFIG_HOME 未設定時は ~/.config/agent-skills/ios-device-build/settings.conf):

# デフォルトのデバイス名（部分一致で検索）
# 空欄の場合は毎回自動検出
DEFAULT_DEVICE_NAME=""

# デフォルトのスキーム名（空欄で自動検出）
DEFAULT_SCHEME=""

# 完了通知の言語（"ja" or "en"）
NOTIFY_LANGUAGE="ja"

# ビルドログの表示行数
BUILD_LOG_LINES=30

手動実行コマンド

接続デバイス一覧

xcrun devicectl list devices

ビルド

xcodebuild -project <project>.xcodeproj -scheme <scheme> -destination 'id=<UDID>' build

インストール

APP_PATH=$(find ~/Library/Developer/Xcode/DerivedData -name "<scheme>.app" -path "*/Debug-iphoneos/*" -type d | head -1)
xcrun devicectl device install app --device <UDID> "$APP_PATH"

起動

xcrun devicectl device process launch --device <UDID> <bundle_id>

前提条件

• Xcode がインストール済み
• 有効な開発者証明書とプロビジョニングプロファイル
• デバイスがMac に接続され、信頼済みであること
• デバイスのロックが解除されていること

トラブルシューティング

エラー	解決策
No devices found	デバイスが接続・ロック解除されているか確認
Device not found	「デバイス変更したい」と言って再設定
Build failed	Xcodeでエラー詳細確認、証明書/プロビジョニング確認
Install failed	「設定 > 一般 > VPNとデバイス管理」で開発元を信頼
Launch failed	バンドルIDが正しいか確認

ファイル構成

skills/ios-device-build/
├── SKILL.md
├── config/
│   └── settings.conf.example
└── scripts/
    └── device_build.sh

$XDG_CONFIG_HOME/agent-skills/ios-device-build/
└── settings.conf