{"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":265,"read_minutes":1,"lang":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# 자동화된 iOS 앱 테스트\n\nSynapse의 메모리 시스템을 Computer Control API와 결합하여 LLM 기반 iOS 앱\n테스트를 구축하십시오. LLM은 테스트 시나리오를 기억하고, 과거 실패로부터\n학습하며, 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\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- [자가 치유 테스트](/docs/guides/self-healing-tests)\n- [Computer Control API](/docs/api/computers)\n- [메모리 모범 사례](/docs/guides/memory-best-practices)\n","content_html":"

자동화된 iOS 앱 테스트

\n

Synapse의 메모리 시스템을 Computer Control API와 결합하여 LLM 기반 iOS 앱\n테스트를 구축하십시오. LLM은 테스트 시나리오를 기억하고, 과거 실패로부터\n학습하며, 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적용합니다.

\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"]}