{"title":"iOS アプリの自動テスト","slug":"automated-testing-ios","category":"guides","summary":"Synapse + Computer Control API を使用して Simulator 経由で iOS アプリテストを自動化。","audience":["human","llm"],"tags":["guide","ios","testing","automation"],"difficulty":"advanced","updated":"2026-06-27","word_count":171,"read_minutes":1,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# iOS アプリの自動テスト\n\nSynapse のメモリシステムと Computer Control API を組み合わせて、LLM 駆動の iOS アプリテストを構築します。LLM はテストシナリオを記憶し、過去の失敗から学習し、UI 変更に適応します。\n\n## アーキテクチャ\n\n```\n┌──────────────┐ commands ┌──────────────┐ screenshots ┌──────────────┐\n│ LLM Agent │ ─────────────▶│ Synapse │ ────────────────▶ │ iOS Sim │\n│ (Claude) │ │ Computer │ ◀──────────────── │ (via agent) │\n└──────────────┘ │ Control │ results └──────────────┘\n │ └──────────────┘\n │ store/recall\n ▼\n┌──────────────┐\n│ Memories │ (test scenarios, past failures, UI patterns)\n└──────────────┘\n```\n\n## 前提条件\n\n- Synapse アカウント + Mind Key\n- Claude Desktop で構成された Synapse MCP サーバー\n- `screen-remote-agent` をインストールした iOS Simulator\n- Synapse に登録されたコンピュータ（[Computer Control API](/docs/api/computers) を参照）\n\n## ステップ 1：Simulator コンピュータの登録\n\niOS Simulator を実行する Mac 上で：\n\n```bash\n# Get install code from Synapse\ncurl -X POST https://synapse.schaefer.zone/computers/install-code \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -d '{\"computer_name\":\"ios-sim\"}'\n# → { \"install_code\": \"ic_...\" }\n\n# Run screen-remote-agent on the Mac\n# (uses the install code to register)\n```\n\n## ステップ 2：テストシナリオをメモリに保存\n\n再利用可能なテストシナリオをメモリとして保存します。\n\n```python\nimport requests\n\ndef store_test_scenario(name, steps, app):\n requests.post(f\"{URL}/memory\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\"},\n json={\n \"category\": \"skill\",\n \"key\": f\"test_scenario_{name}\",\n \"content\": f\"App: {app}\\nSteps:\\n\" + \"\\n\".join(steps),\n \"tags\": [\"test\", \"ios\", app],\n \"priority\": \"high\"\n })\n\nstore_test_scenario(\"login_flow\", [\n \"Launch app\",\n \"Tap email field\",\n \"Type test@example.com\",\n \"Tap password field\",\n \"Type password123\",\n \"Tap Login button\",\n \"Verify home screen appears\"\n], \"MyApp\")\n```\n\n## ステップ 3：LLM 駆動のテスト実行\n\nClaude Desktop で（Synapse MCP を構成済み）：\n\n```\nRun the login_flow test scenario on the iOS Simulator.\nTake a screenshot after each step and verify the expected UI.\nIf any step fails, store the failure as a memory so we can\navoid it next time.\n```\n\nClaude は以下を行います。\n\n1. `memory_search` を呼び出して `test_scenario_login_flow` メモリを見つける\n2. `computer_screenshot` を呼び出して現在の状態を確認\n3. 各ステップを `computer_command_queue`（click、type）経由で実行\n4. スクリーンショットで結果を検証\n5. 失敗があれば `mistake` メモリとして保存\n\n## ステップ 4：自己修復テスト\n\nテスト失敗時に、失敗と復旧を保存します。\n\n```python\ndef store_test_failure(scenario, step, error, recovery):\n requests.post(f\"{URL}/memory\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\"},\n json={\n \"category\": \"mistake\",\n \"key\": f\"failure_{scenario}_{step}\",\n \"content\": f\"Scenario: {scenario}\\nStep: {step}\\nError: {error}\\nRecovery: {recovery}\",\n \"tags\": [\"test\", \"failure\", \"ios\", scenario],\n \"priority\": \"high\"\n })\n\n# Example\nstore_test_failure(\"login_flow\", \"tap_login\",\n \"Login button not found at expected coordinates\",\n \"Button moved due to new logo. Search by accessibility label instead.\")\n```\n\n次回 LLM がテストを実行する際、失敗を再取得し、復旧を自動的に適用します。\n\n## ステップ 5：テスト結果の追跡\n\nテスト実行をタスクとして追跡します。\n\n```python\ndef track_test_run(scenario, status, duration):\n requests.post(f\"{URL}/mind/task\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\"},\n json={\n \"title\": f\"Test: {scenario}\",\n \"description\": f\"Status: {status}, Duration: {duration}s\",\n \"priority\": \"normal\"\n })\n```\n\n## よくあるコマンド\n\n| アクション | コマンド |\n|--------|---------|\n| Simulator 起動 | `xcrun simctl launch booted com.example.app` |\n| スクリーンショット | `computer_screenshot`（Synapse MCP 経由） |\n| (x,y) をタップ | `computer_command_queue {type:\"click\", payload:{x,y}}` |\n| テキスト入力 | `computer_command_queue {type:\"type\", payload:{text:\"...\"}}` |\n| Home を押す | `computer_command_queue {type:\"key\", payload:{keys:[\"Cmd\",\"Shift\",\"H\"]}}` |\n\n## ベストプラクティス\n\n> [!TIP]\n> - **UI 座標をメモリとして保存** — UI は変わるが、LLM は再学習可能\n> - **アクセシビリティラベルを使用** — 座標より安定\n> - **テストデータは別々に保存** — ユーザー名、パスワードには変数を使用\n> - **クリーンな状態でテスト実行** — 実行間で Simulator をリセット\n> - **失敗時のスクリーンショットを記録** — デバッグに有用\n\n## 次のステップ\n\n- [Self-Healing Tests](/docs/guides/self-healing-tests)\n- [Computer Control API](/docs/api/computers)\n- [Memory Best Practices](/docs/guides/memory-best-practices)\n","content_html":"

iOS アプリの自動テスト

\n

Synapse のメモリシステムと Computer Control API を組み合わせて、LLM 駆動の iOS アプリテストを構築します。LLM はテストシナリオを記憶し、過去の失敗から学習し、UI 変更に適応します。

\n

アーキテクチャ

\n
┌──────────────┐    commands    ┌──────────────┐    screenshots    ┌──────────────┐\n│  LLM Agent   │ ─────────────▶│  Synapse     │ ────────────────▶ │  iOS Sim     │\n│  (Claude)    │               │  Computer    │ ◀──────────────── │  (via agent) │\n└──────────────┘               │  Control     │    results        └──────────────┘\n       │                       └──────────────┘\n       │ store/recall\n       ▼\n┌──────────────┐\n│  Memories    │ (test scenarios, past failures, UI patterns)\n└──────────────┘

前提条件

\n\n

ステップ 1：Simulator コンピュータの登録

\n

iOS Simulator を実行する Mac 上で：

\n
# Get install code from Synapse\ncurl -X POST https://synapse.schaefer.zone/computers/install-code \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -d '{"computer_name":"ios-sim"}'\n# → { "install_code": "ic_..." }\n\n# Run screen-remote-agent on the Mac\n# (uses the install code to register)

ステップ 2：テストシナリオをメモリに保存

\n

再利用可能なテストシナリオをメモリとして保存します。

\n
import requests\n\ndef store_test_scenario(name, steps, app):\n    requests.post(f"{URL}/memory",\n        headers={"Authorization": f"Bearer {MIND_KEY}"},\n        json={\n            "category": "skill",\n            "key": f"test_scenario_{name}",\n            "content": f"App: {app}\\nSteps:\\n" + "\\n".join(steps),\n            "tags": ["test", "ios", app],\n            "priority": "high"\n        })\n\nstore_test_scenario("login_flow", [\n    "Launch app",\n    "Tap email field",\n    "Type test@example.com",\n    "Tap password field",\n    "Type password123",\n    "Tap Login button",\n    "Verify home screen appears"\n], "MyApp")

ステップ 3：LLM 駆動のテスト実行

\n

Claude Desktop で（Synapse MCP を構成済み）：

\n
Run the login_flow test scenario on the iOS Simulator.\nTake a screenshot after each step and verify the expected UI.\nIf any step fails, store the failure as a memory so we can\navoid it next time.

Claude は以下を行います。

\n
    \n
  1. memory_search を呼び出して test_scenario_login_flow メモリを見つける
    2. \n
  2. computer_screenshot を呼び出して現在の状態を確認
    3. \n
  3. 各ステップを computer_command_queue（click、type）経由で実行
    4. \n
  4. スクリーンショットで結果を検証
    5. \n
  5. 失敗があれば mistake メモリとして保存
    6. \n
\n

ステップ 4：自己修復テスト

\n

テスト失敗時に、失敗と復旧を保存します。

\n
def store_test_failure(scenario, step, error, recovery):\n    requests.post(f"{URL}/memory",\n        headers={"Authorization": f"Bearer {MIND_KEY}"},\n        json={\n            "category": "mistake",\n            "key": f"failure_{scenario}_{step}",\n            "content": f"Scenario: {scenario}\\nStep: {step}\\nError: {error}\\nRecovery: {recovery}",\n            "tags": ["test", "failure", "ios", scenario],\n            "priority": "high"\n        })\n\n# Example\nstore_test_failure("login_flow", "tap_login",\n    "Login button not found at expected coordinates",\n    "Button moved due to new logo. Search by accessibility label instead.")

次回 LLM がテストを実行する際、失敗を再取得し、復旧を自動的に適用します。

\n

ステップ 5：テスト結果の追跡

\n

テスト実行をタスクとして追跡します。

\n
def track_test_run(scenario, status, duration):\n    requests.post(f"{URL}/mind/task",\n        headers={"Authorization": f"Bearer {MIND_KEY}",\n                 "Content-Type": "application/json"},\n        json={\n            "title": f"Test: {scenario}",\n            "description": f"Status: {status}, Duration: {duration}s",\n            "priority": "normal"\n        })

よくあるコマンド

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
アクションコマンド
Simulator 起動xcrun simctl launch booted com.example.app
スクリーンショットcomputer_screenshot（Synapse MCP 経由）
(x,y) をタップcomputer_command_queue {type:"click", payload:{x,y}}
テキスト入力computer_command_queue {type:"type", payload:{text:"..."}}
Home を押すcomputer_command_queue {type:"key", payload:{keys:["Cmd","Shift","H"]}}
\n

ベストプラクティス

\n

次のステップ

\n\n","urls":{"html":"/docs/guides/automated-testing-ios","text":"/docs/guides/automated-testing-ios?format=text","json":"/docs/guides/automated-testing-ios?format=json","llm":"/docs/guides/automated-testing-ios?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}