{"title":"Kiểm thử ứng dụng iOS tự động","slug":"automated-testing-ios","category":"guides","summary":"Sử dụng Synapse + Computer Control API để tự động hóa kiểm thử ứng dụng iOS qua Simulator.","audience":["human","llm"],"tags":["guide","ios","testing","automation"],"difficulty":"advanced","updated":"2026-06-27","word_count":407,"read_minutes":2,"lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Kiểm thử ứng dụng iOS tự động\n\nKết hợp hệ thống bộ nhớ của Synapse với Computer Control API để xây dựng kiểm\nthử ứng dụng iOS điều khiển bởi LLM. LLM ghi nhớ kịch bản kiểm thử, học từ lỗi\nquá khứ và thích ứng với thay đổi UI.\n\n## Kiến trúc\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## Điều kiện tiên quyết\n\n- Tài khoản Synapse + Mind Key\n- Synapse MCP server được cấu hình trong Claude Desktop\n- iOS Simulator với `screen-remote-agent` đã cài đặt\n- Máy tính đã đăng ký trong Synapse (xem [Computer Control API](/docs/api/computers))\n\n## Bước 1: Đăng ký máy tính Simulator\n\nTrên Mac chạy iOS Simulator:\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## Bước 2: Lưu kịch bản kiểm thử trong bộ nhớ\n\nLưu kịch bản kiểm thử tái sử dụng dưới dạng bộ nhớ:\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## Bước 3: Thực thi kiểm thử điều khiển bởi LLM\n\nTrong Claude Desktop (với Synapse MCP đã cấu hình):\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 sẽ:\n\n1. Gọi `memory_search` để tìm bộ nhớ `test_scenario_login_flow`\n2. Gọi `computer_screenshot` để xem trạng thái hiện tại\n3. Thực thi mỗi bước qua `computer_command_queue` (click, type)\n4. Xác minh kết quả qua ảnh chụp màn hình\n5. Lưu bất kỳ lỗi nào dưới dạng bộ nhớ `mistake`\n\n## Bước 4: Kiểm thử tự sửa chữa\n\nKhi kiểm thử thất bại, lưu lỗi và cách khôi phục:\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\nLần tới LLM chạy kiểm thử, nó thu hồi lỗi và áp dụng khôi phục tự động.\n\n## Bước 5: Theo dõi kết quả kiểm thử\n\nTheo dõi lần chạy kiểm thử dưới dạng tác vụ:\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## Lệnh phổ biến\n\n| Hành động | Lệnh |\n|--------|---------|\n| Khởi chạy Simulator | `xcrun simctl launch booted com.example.app` |\n| Ảnh chụp màn hình | `computer_screenshot` (qua Synapse MCP) |\n| Nhấp tại (x,y) | `computer_command_queue {type:\"click\", payload:{x,y}}` |\n| Nhập văn bản | `computer_command_queue {type:\"type\", payload:{text:\"...\"}}` |\n| Nhấn Home | `computer_command_queue {type:\"key\", payload:{keys:[\"Cmd\",\"Shift\",\"H\"]}}` |\n\n## Thực hành tốt nhất\n\n> [!TIP]\n> - **Lưu tọa độ UI dưới dạng bộ nhớ** — UI thay đổi, nhưng LLM có thể học lại\n> - **Sử dụng nhãn accessibility** — ổn định hơn tọa độ\n> - **Lưu dữ liệu kiểm thử riêng biệt** — sử dụng biến cho tên người dùng, mật khẩu\n> - **Chạy kiểm thử trong trạng thái sạch** — đặt lại Simulator giữa các lần chạy\n> - **Ghi ảnh chụp màn hình cho lỗi** — hữu ích cho gỡ lỗi\n\n## Bước tiếp theo\n\n- [Kiểm thử tự sửa chữa](/docs/guides/self-healing-tests)\n- [Computer Control API](/docs/api/computers)\n- [Thực hành tốt nhất về bộ nhớ](/docs/guides/memory-best-practices)\n","content_html":"

Kiểm thử ứng dụng iOS tự động

\n

Kết hợp hệ thống bộ nhớ của Synapse với Computer Control API để xây dựng kiểm\nthử ứng dụng iOS điều khiển bởi LLM. LLM ghi nhớ kịch bản kiểm thử, học từ lỗi\nquá khứ và thích ứng với thay đổi UI.

\n

Kiến trúc

\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└──────────────┘

Điều kiện tiên quyết

\n\n

Bước 1: Đăng ký máy tính Simulator

\n

Trên Mac chạy iOS Simulator:

\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)

Bước 2: Lưu kịch bản kiểm thử trong bộ nhớ

\n

Lưu kịch bản kiểm thử tái sử dụng dưới dạng bộ nhớ:

\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")

Bước 3: Thực thi kiểm thử điều khiển bởi LLM

\n

Trong Claude Desktop (với Synapse MCP đã cấu hình):

\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 sẽ:

\n
    \n
  1. Gọi memory_search để tìm bộ nhớ test_scenario_login_flow
    2. \n
  2. Gọi computer_screenshot để xem trạng thái hiện tại
    3. \n
  3. Thực thi mỗi bước qua computer_command_queue (click, type)
    4. \n
  4. Xác minh kết quả qua ảnh chụp màn hình
    5. \n
  5. Lưu bất kỳ lỗi nào dưới dạng bộ nhớ mistake
    6. \n
\n

Bước 4: Kiểm thử tự sửa chữa

\n

Khi kiểm thử thất bại, lưu lỗi và cách khôi phục:

\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.")

Lần tới LLM chạy kiểm thử, nó thu hồi lỗi và áp dụng khôi phục tự động.

\n

Bước 5: Theo dõi kết quả kiểm thử

\n

Theo dõi lần chạy kiểm thử dưới dạng tác vụ:

\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        })

Lệnh phổ biế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
Hành độngLệnh
Khởi chạy Simulatorxcrun simctl launch booted com.example.app
Ảnh chụp màn hìnhcomputer_screenshot (qua Synapse MCP)
Nhấp tại (x,y)computer_command_queue {type:"click", payload:{x,y}}
Nhập văn bảncomputer_command_queue {type:"type", payload:{text:"..."}}
Nhấn Homecomputer_command_queue {type:"key", payload:{keys:["Cmd","Shift","H"]}}
\n

Thực hành tốt nhất

\n

Bước tiếp theo

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