mcpField
A
argent-ios-device-setup

argent-ios-device-setup

github.com/software-mansionテスト・品質3.1k11.7k 回インストール今日更新
リポジトリ

argent-ios-device-setup について

物理iPhoneでArgentを使うためのセットアップスキルです。デバイス接続、初回インストール、署名、一般的なエラーへの対処を扱います。シミュレーターの設定は別のスキルが担当します。

主な機能

  1. 01物理iPhoneの準備と接続
  2. 02デベロッパーモードの有効化
  3. 03ランナーのビルド、署名、起動
  4. 04Argent Runnerアプリの信頼と保持
  5. 05署名とビルドのエラー対処

活用シーン

  1. 01Argentの自動化用にiPhoneを設定
  2. 02初回の信頼確認や署名要求に対応
  3. 03ランナーやビルドのエラーから復旧

MCP 対応

入力にはArgentのセットアップ手順とツールが記載されていますが、MCPの動作については説明されていません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/software-mansion/argent --skill argent-ios-device-setup

インストール後、Claude Code で/argent-ios-device-setupを入力して読み込まれたか確認します。

詳細

実機 iPhone のセットアップ

実機 iPhone を使用する場合にのみお読みください。シミュレーターでは argent-ios-simulator-setup を使用します。

初回起動

  1. iPhone をケーブルで接続してロックを解除し、画面がスリープしないようにして、デベロッパモードをオンにします（設定 > プライバシーとセキュリティ > デベロッパモード）。list-devices に connected と表示される必要があります。
  2. launch-app はアプリを登録するだけです。初回の describe、ジェスチャー、または screenshot で、オンデバイスランナーのビルド、署名、起動が行われます。初回は数分、キャッシュがある場合やツールサーバーの再起動後は数十秒かかります。ビルドの上限は 15 分、ランナーの起動待ちは 120 秒です。
  3. 初回インストール時に、iPhone でデベロッパを信頼する操作が求められます（設定 > 一般 > VPNとデバイス管理）。ホーム画面に Argent Runner アプリが表示されます。これは argent の自動化ランナーであり、インストールしたままにする必要があることをユーザーに伝えてください。

署名とエラー

署名に設定は不要です。ツールサーバープロセスでの最初の iPhone 呼び出し時に、選択されたチームと ARGENT_IOS_TEAM_ID の上書き設定（ツールサーバーの環境変数。変更するとコールドビルドが必要です）を示すメモが表示されます。ケーブル接続、ロック、信頼、期限切れのプロファイル、証明書不足に関するエラーには、解決方法が記載されています。対処して、同じ呼び出しを再試行してください。また、errSecInternalComponent の場合は、security set-key-partition-list -S apple-tool:,apple:,codesign: -s ~/Library/Keychains/login.keychain-db を実行して（ユーザーのログインパスワードを求められます）、再試行してください。team has no devices の場合は、iPhone をケーブルで接続したまま再試行してください。Bundle id の登録に失敗した場合は、無料チームの App ID 数の上限が原因です。数日待つか、有料チームで署名してください。その他の xcodebuild エラーでは、error: の生の行が出力されます。~/.argent/ios-device-runner/logs/runner-<udid8>.log を確認してください。RUNNER_WEDGED の場合は、その udid の stop-simulator-server を実行して、再試行してください。

続いて argent-ios-device-interact をお読みください。

コメント

Markdown 対応