{"title":"اختبار تطبيقات iOS المؤتمت","slug":"automated-testing-ios","category":"guides","summary":"استخدم Synapse + Computer Control API لأتمتة اختبارات تطبيقات iOS عبر Simulator.","audience":["human","llm"],"tags":["guide","ios","testing","automation"],"difficulty":"advanced","updated":"2026-06-27","word_count":297,"read_minutes":1,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# اختبار تطبيقات iOS المؤتمت\n\nاجمع نظام ذاكرة Synapse مع Computer Control API لبناء\nاختبارات تطبيقات iOS مدفوعة بـ LLM. يتذكر الـ LLM سيناريوهات الاختبار، يتعلّم من الإخفاقات\nالسابقة، ويتكيّف مع تغييرات الواجهة.\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- خادم Synapse MCP مُعدّ في Claude Desktop\n- iOS Simulator مع `screen-remote-agent` مثبت\n- جهاز مسجّل في Synapse (راجع [Computer Control API](/docs/api/computers))\n\n## الخطوة 1: سجّل جهاز Simulator\n\nعلى الـ Mac الذي يشغّل iOS Simulator:\n\n```bash\n# احصل على رمز التثبيت من 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# شغّل screen-remote-agent على الـ Mac\n# (يستخدم رمز التثبيت للتسجيل)\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\nفي Claude 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\nسيفعل Claude:\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# مثال\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> - **خزّن إحداثيات الواجهة كذكريات** — تتغير الواجهة، لكن الـ LLM يستطيع إعادة التعلم\n> - **استخدم تسميات الوصول (accessibility labels)** — أكثر ثباتًا من الإحداثيات\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 لبناء\nاختبارات تطبيقات iOS مدفوعة بـ LLM. يتذكر الـ LLM سيناريوهات الاختبار، يتعلّم من الإخفاقات\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

الخطوة 1: سجّل جهاز Simulator

\n

على الـ Mac الذي يشغّل iOS Simulator:

\n
# احصل على رمز التثبيت من 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# شغّل screen-remote-agent على الـ Mac\n# (يستخدم رمز التثبيت للتسجيل)

الخطوة 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# مثال\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
الإجراءالأمر
تشغيل Simulatorxcrun 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:"..."}}
ضغط Homecomputer_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"]}