pranshuchittora/simvynأداة تطوير جوال شاملة للعوامل والبشر - التحكم في أجهزة محاكاة iOS وأجهزة محاكاة Android والأجهزة الحقيقية من لوحة تحكم واحدة وواجهة سطر أوامر
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12264/e081fb1d4bcaa6556ff10e722d1ff25449288b68ce1aad9ac3b5ecc047ccf5fb.png" width="180" alt="simvyn" /> </p> <h1 align="center">simvyn</h1> <p align="center"> أداة تطوير الجوال الشاملة — تحكم في محاكيات iOS ومحاكيات Android والأجهزة الحقيقية من لوحة تحكم واحدة وواجهة سطر أوامر </p> <p align="center"> <a href="https://www.npmjs.com/package/simvyn"><img src="https://img.shields.io/npm/v/simvyn?color=cb3837&logo=npm" alt="npm version" /></a> <a href="https://www.npmjs.com/package/simvyn"><img src="https://img.shields.io/npm/dm/simvyn?color=cb3837&logo=npm" alt="npm downloads" /></a> <a href="https://github.com/pranshuchittora/simvyn/actions/workflows/ci.yml"><img src="https://github.com/pranshuchittora/simvyn/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a> <a href="https://github.com/pranshuchittora/simvyn/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/simvyn?color=blue" alt="MIT License" /></a> <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/simvyn?color=5FA04E&logo=node.js&logoColor=white" alt="Node version" /></a> </p> <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12264/bff45a80ced8a6cba77f5bab23f21607fb310862cbc838179d9ce714a1d4d6b6.png" alt="simvyn dashboard" /> </p> <p align="center"> <img src="https://raw.githubusercontent.com/pranshuchittora/simvyn/main/assets/demo.gif" alt="simvyn demo" /> </p> ## جدول المحتويات - [البدء السريع](#quick-start) - [التثبيت](#installation) - [وكلاء البرمجة بالذكاء الاصطناعي](#ai-coding-agents) - [الميزات](#features) - [عروض الوحدات](#module-showcases) - [دليل المجموعات](#collections-guide) - [مرجع واجهة سطر الأوامر](#cli-reference) - [كيف يعمل](#how-it-works) - [المنصات المدعومة](#supported-platforms) - [المساهمة](#contributing) - [الأمان](#security) - [الترخيص](#license) ## البدء السريع```bash npx simvyn ``` يبدأ الخادم المحلي، ويفتح لوحة التحكم على الويب في متصفحك، ويكتشف تلقائيًا جميع المحاكيات وأجهزة المحاكاة والأجهزة الفعلية المتصلة عبر USB. ## التثبيت **تثبيت عام:**```bash npm install -g simvyn ``` **استخدام لمرة واحدة (بدون تثبيت):**```bash npx simvyn ``` **المتطلبات:** - Node.js 22 (22.14.0+) أو 24+ - macOS (دعم كامل لـ iOS + Android) أو Linux (Android فقط) ## وكلاء البرمجة بالذكاء الاصطناعي يتضمن simvyn [مهارة وكيل](https://github.com/pranshuchittora/simvyn/blob/main/skills/simvyn/SKILL.md) محمولة لاكتشاف الأجهزة، وتشغيل أوامر CLI المدعومة، والتقاط لقطات الشاشة، وفحص بيانات التطبيق، وجمع السجلات المحدودة. وهي تعلّم الوكيل كيفية استخدام CLI بمعرّفات أجهزة صريحة وحدود المنصات. تستخدم المهارة أداة الطرفية الموجودة لدى الوكيل؛ ولا تسجّل خادم MCP أو أدوات وكيل جديدة. **Pi:** حزمة npm هي [حزمة Pi](https://pi.dev/packages/simvyn). إلى جانب المهارة، تضيف أدوات `simvyn` و`simvyn_screenshot` و`simvyn_logs` و`simvyn_record`، وأمر `/simvyn` الذي يشغّل لوحة التحكم، وقوالب المطالبات `/simvyn-repro` و`/simvyn-screen` و`/simvyn-logs`. وتتطلب Pi 0.74 أو أحدث:```bash pi install npm:simvyn ``` **الوكلاء الآخرون المتوافقون:** ثبّت المهارة المحمولة من GitHub، باختيار الوكيل الخاص بك، وثبّت واجهة سطر الأوامر simvyn CLI بشكل منفصل:```bash npm install -g simvyn npx skills add pranshuchittora/simvyn --skill simvyn --agent codex --yes ``` يتطلب أمر GitHub وجود ملفات المهارات هذه على الفرع الافتراضي؛ يتطلب أمر Pi موارد Pi في إصدار npm المنشور. للتغييرات غير المنشورة، استخدم [تعليمات السحب المحلي](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md#test-an-unreleased-checkout). راجع [دليل إعداد الوكيل وسير العمل](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md) للحصول على المشغّل المضمّن، والمخرجات المدعومة، والتشغيل غير التفاعلي، والقيود الحالية. يتوفر أيضًا [فهرس توثيق](https://github.com/pranshuchittora/simvyn/blob/main/llms.txt) مختصر للأدوات التي تقبل عناوين URL للتوثيق. ## الميزات - **إدارة الأجهزة** — اكتشف، وشغّل، وأغلق، وامسح، وأنشئ، واستنسخ المحاكيات والأجهزة الفعلية مع تثبيت المفضلة - **إدارة التطبيقات** — ثبّت، وشغّل، وأنهِ، وأزل التطبيقات عبر السحب والإفلات أو CLI - **عارض السجلات** — بث مباشر مع تصفية حسب المستوى، والبحث داخل الصفحة (Cmd+F)، والبحث بتعبيرات نمطية، والترقيم، والتصدير - **محاكاة الموقع** — عيّن إحداثيات GPS، وشغّل مسارات GPX/KML مع التحكم في السرعة، واحفظ المفضلة - **إعدادات الجهاز** — الوضع الداكن، واللغة، والاتجاه، والأذونات، وتجاوزات شريط الحالة، وإعدادات إمكانية الوصول المسبقة - **لقطات الشاشة والتسجيل** — التقط لقطات الشاشة وسجّل فيديو الشاشة مع السجل - **الروابط العميقة** — افتح عناوين URL والمخططات المخصصة، واحفظ المفضلة لكل تطبيق - **مفتش قواعد البيانات** — تصفّح جداول SQLite، ونفّذ استعلامات SQL، واعرض SharedPreferences وNSUserDefaults - **متصفح الملفات** — تصفّح صناديق حماية التطبيقات، وارفع/نزّل الملفات، وحرّر النصوص مباشرة - **الإشعارات الفورية** — أنشئ حمولات JSON، وأرسلها إلى محاكيات iOS، ومكتبة قوالب - **المجموعات** — اجمع إجراءات الأجهزة في تسلسلات قابلة لإعادة الاستخدام، وطبّقها على أجهزة متعددة دفعة واحدة - **سجلات الأعطال** — تقارير تشخيص iOS وسجلات logcat/tombstone لأعطال Android - **الحافظة** — اقرأ واكتب محتويات حافظة الجهاز - **الوسائط** — ادفع الصور ومقاطع الفيديو إلى ألبومات كاميرا الجهاز ومعارضه - **إعدادات الأداة** — تكوين الخادم، وإدارة التخزين، والتشخيص، وتقارير التصحيح - **دعم الأجهزة الفعلية** — وصّل أجهزة Android وiOS الفعلية عبر USB مع الاكتشاف التلقائي - **لوحة تحكم الويب** — تصميم Apple Liquid Glass مع لوحة الأوامر والتنقل بلوحة المفاتيح - **CLI كامل** — كل ميزة تعمل بدون واجهة عبر `simvyn <command>` ## عروض الوحدات ### إدارة الأجهزة اكتشف جميع محاكيات iOS وأجهزة Android Emulator والأجهزة الفعلية المتصلة عبر USB في قائمة موحّدة واحدة. شغّل الأجهزة وأغلقها وامسحها دون الحاجة إلى Xcode أو Android Studio. أنشئ محاكيات iOS جديدة باختيار نوع الجهاز وبيئة التشغيل، أو استنسخ محاكيًا موجودًا لإنشاء نسخ مكررة بسرعة. تظهر الأجهزة الفعلية تلقائيًا عند توصيلها وتُجمَّع بشكل منفصل في محدد الأجهزة. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/2b85641878f6015c248311700a1a87a20476ade6c930273a3e47f288a82d6d2e.png" alt="Device Management" width="700" /></p> - اعرض جميع المحاكيات والأجهزة الفعلية المتاحة عبر المنصات - شغّل الأجهزة وأغلقها وامسحها بنقرة واحدة أو أمر CLI - أنشئ محاكيات iOS جديدة مع اختيار نوع الجهاز وبيئة التشغيل - استنسخ المحاكيات الموجودة وأعد تسميتها - ثبّت الأجهزة المفضلة في أعلى محدد الأجهزة - تحديثات حالة الجهاز في الوقت الفعلي عبر WebSocket ### إدارة التطبيقات ثبّت التطبيقات وشغّلها وأنهها وأزلها على أي جهاز متصل. اسحب وأفلت حزم IPA أو APK أو .app لمحاكي iOS مباشرةً على لوحة التحكم. اعرض معلومات التطبيق التفصيلية وامسح بيانات التطبيق دون أوامر adb أو simctl يدوية. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/17757b1ca8ddd41d43ac3a159260598308da6c3f759e1c9d730f61498e18ce8a.png" alt="App Management" width="700" /></p> - تثبيت IPA وAPK و.app لمحاكي iOS عبر السحب والإفلات - شغّل التطبيقات وأنهها وأزلها بواسطة معرّف الحزمة - اعرض تفاصيل التطبيق بما في ذلك الإصدار والحجم والأذونات - امسح بيانات التطبيق على أجهزة Android - اعرض جميع التطبيقات المثبّتة مع تصفية البحث ### عارض السجلات بثّ سجلات الجهاز في الوقت الفعلي مع تصفية قوية. صفِّ حسب مستوى السجل، وابحث بأنماط regex، وصفِّ حسب اسم العملية. استخدم البحث داخل الصفحة (Cmd+F) لإبراز إدخالات محددة دون إخفاء السياق المحيط. صدّر السجلات المصفّاة للمشاركة أو الأرشفة. يتيح السجل المُرقَّم التمرير للخلف عبر آلاف الإدخالات دون مشاكل في الأداء. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/b909b3515637b4059ebf210c56599f2f022506f09ee35a11e812bd8368d3750e.png" alt="Log Viewer" width="700" /></p> - بث السجلات في الوقت الفعلي عبر WebSocket - صفِّ حسب المستوى: debug، info، warning، error، fatal - البحث داخل الصفحة (Cmd+F) مع إبراز التطابقات والتنقل والعدّاد - البحث بتعبيرات نمطية وتصفية اسم العملية - سجل مُرقَّم مع تمرير افتراضي - صدّر السجلات المصفّاة إلى ملف - إيقاف/استئناف بث السجلات مع الحفاظ على الحالة عبر عمليات المسح ### الموقع عيّن إحداثيات GPS دقيقة على أي جهاز باستخدام خريطة تفاعلية أو إدخال يدوي. شغّل ملفات مسارات GPX وKML مع تحكم قابل للتعديل في السرعة. احفظ المواقع المستخدمة بشكل متكرر كمفضلة للوصول السريع. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/47842dfa878ffbc80bd5bb32d83e820e7ed7dd56a4d63368ca6e823ef72889d4.png" alt="Location" width="700" /></p> - خريطة تفاعلية مع تعيين الإحداثيات بالنقر - تشغيل ملفات مسارات GPX وKML مع التحكم في السرعة - المواقع المفضلة محفوظة لكل جهاز - بث الموقع لأجهزة متعددة - الترميز الجغرافي العكسي للحصول على عناوين مقروءة ### إعدادات الجهاز بدّل الوضع الداكن، وغيّر اللغة، وأدر اتجاه الجهاز (Android)، وأدر أذونات التطبيقات، وتجاوز مظهر شريط الحالة. طبّق إعدادات إمكانية الوصول المسبقة لاختبار تطبيقك في ظروف مختلفة. تسري جميع تغييرات الإعدادات فورًا على الجهاز المستهدف. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/d3f6a33c17b773560072f7b94b71abd5ebc82786c073bdeb6d25f828c3f214fa.png" alt="Device Settings" width="700" /></p> - بدّل الوضع الداكن/الفاتح - غيّر لغة الجهاز - أدر أذونات التطبيقات - تجاوز شريط الحالة (الوقت، البطارية، الإشارة) - إعدادات إمكانية الوصول المسبقة (نص عريض، زيادة التباين، حجم المحتوى) ### لقطات الشاشة والتسجيل التقط لقطات الشاشة وسجّل فيديو الشاشة على أي جهاز. تُحفظ جميع اللقطات مع الطوابع الزمنية وتُنظَّم في سجل قابل للتصفح. نزّل أو احذف اللقطات مباشرةً من لوحة التحكم. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/58ed8f25d148ed53f39066e42be730f255235dbec47539bbec826c455cba7936.png" alt="Screenshots and Recording" width="700" /></p> - التقاط لقطة شاشة بنقرة واحدة - تسجيل الشاشة مع عناصر التحكم في البدء/الإيقاف - سجل لقطات بطوابع زمنية - نزّل واحذف اللقطات من لوحة التحكم ### الروابط العميقة افتح عناوين URL ومخططات URI المخصصة على أي جهاز. احفظ الروابط العميقة المستخدمة بشكل متكرر كمفضلة منظّمة حسب التطبيق. اختبر معالجة الروابط العميقة في تطبيقك دون كتابة عناوين URL يدويًا في الطرفية. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/3a990ef7c74f83c93b63c1654f74b3fa952b0b41abd31fe688cdaf2e29570f62.png" alt="Deep Links" width="700" /></p> - افتح أي عنوان URL أو مخطط مخصص على جهاز - احفظ الروابط العميقة المفضلة لكل تطبيق - سجل الروابط بترتيب الأحدث أولاً - يعمل مع كل من iOS وAndroid ### مفتش قواعد البيانات تصفّح قواعد بيانات SQLite داخل صندوق حماية أي تطبيق. اعرض مخططات الجداول، ونفّذ استعلامات SQL عشوائية، وافحص SharedPreferences (Android) أو NSUserDefaults (iOS). حرّر القيم مباشرةً دون كتابة نصوص برمجية. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/4884b688dbbee5f1a34b0454950f4d6562e74efdbbb3b84ca5c626835b4b7d37.png" alt="Database Inspector" width="700" /></p> - تصفّح جداول SQLite بأعمدة قابلة للفرز - نفّذ استعلامات SQL عشوائية - اعرض وحرّر SharedPreferences وNSUserDefaults - تحرير الخلايا مباشرةً مع اكتشاف النوع ### متصفح الملفات تصفّح نظام ملفات صندوق الحماية لأي تطبيق مثبّت. تنقّل بين الأدلة، وارفع ونزّل الملفات، وحرّر الملفات النصية مباشرةً. انقل الملفات بين جهازك والجهاز دون أوامر adb pull/push يدوية. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7b7ba540ad5de8b575da4f9bb28694dc68f5ffce51225a388788b8ef2f4767a0.png" alt="File Browser" width="700" /></p> - تصفّح أدلة صندوق حماية التطبيق - ارفع ونزّل الملفات - تحرير الملفات النصية مباشرةً - يعمل مع حاويات تطبيقات iOS وAndroid ### الإشعارات الفورية أنشئ حمولات إشعارات فورية بصيغة JSON وأرسلها إلى محاكيات iOS. استخدم مكتبة القوالب المضمّنة كنقطة بداية أو اكتب الحمولات من الصفر. يُبرز التحقق الفوري من JSON الأخطاء قبل الإرسال. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/f640654be67c24c7248806987e62908316407c18648fc145109118f260443f7d.png" alt="Push Notifications" width="700" /></p> - أنشئ وأرسل حمولات الإشعارات الفورية إلى محاكيات iOS - مكتبة قوالب الحمولات المضمّنة - التحقق الفوري من JSON - استهدف تطبيقات محددة بواسطة معرّف الحزمة ### المجموعات أنشئ مجموعات قابلة لإعادة الاستخدام من إجراءات الأجهزة وطبّقها على أجهزة متعددة دفعة واحدة. تجمع المجموعات خطوات مثل تعيين الموقع، وتبديل الوضع الداكن، وتثبيت تطبيق في سير عمل واحد قابل للتكرار. تأتي ثلاث إعدادات مسبقة أولية مع simvyn لتبدأ منها. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/fbf2ddbba1d3725321c80a914bf5b71ea6a2fc605fddbb73abd0b28385488af6.png" alt="Collections" width="700" /></p> - أنشئ مجموعات مسمّاة وانسخها وأدرها - تصفّح كتالوج الإجراءات المصنّف عبر جميع الوحدات - إعادة ترتيب الخطوات بالسحب والإفلات - طبّق على أجهزة متعددة مع فحص التوافق - ثلاث إعدادات مسبقة أولية مضمّنة ### سجلات الأعطال اعرض تقارير تشخيص iOS (ملفات .ips) وسجلات أعطال Android من logcat ومقالب tombstone. تصفّح إدخالات الأعطال مع الطوابع الزمنية ومعلومات العملية. افحص تفاصيل العطل الكاملة دون التنقيب في أنظمة ملفات الجهاز. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/8f74a799448050bc37eace1d43865b13f3f47a0997c01dba650fd21e94f09ebf.png" alt="Crash Logs" width="700" /></p> - تحليل تقرير تشخيص iOS (.ips) - تجميع أعطال Android logcat حسب PID والوسم - استرجاع مقالب tombstone لأندرويد - قائمة أعطال بطوابع زمنية مع عرض التفاصيل ### الحافظة اقرأ واكتب حافظة الجهاز من لوحة التحكم أو CLI. مفيد للصق بيانات الاختبار بسرعة في التطبيقات أو فحص ما نسخه تطبيق. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/db889032abeb5f1d511dcfeb8c06c215bda851436f198a63db97f595b50853d6.png" alt="Clipboard" width="700" /></p> - اقرأ محتويات الحافظة الحالية - اكتب نصًا إلى حافظة الجهاز - يعمل مع محاكيات iOS وأجهزة Android Emulator ### الوسائط ادفع الصور ومقاطع الفيديو مباشرةً إلى ألبوم كاميرا الجهاز أو معرضه. أفلت الملفات على لوحة التحكم لحقنها دون كابلات أو بريد إلكتروني أو نقل سحابي. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/c63ce5411dc17b5d329c2af381c035d86164f5544928b0c76fe7d05346473561.png" alt="Media" width="700" /></p> - أضف الصور ومقاطع الفيديو إلى معرض الجهاز عبر السحب والإفلات - يدعم الملفات الكبيرة حتى 500 ميجابايت - يعمل مع محاكيات iOS وأجهزة Android Emulator ### إعدادات الأداة كوّن خادم simvyn، وأدر التخزين، واعرض التشخيص. يتضمن مولّد تقرير تصحيح للإبلاغ عن المشكلات. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7ba043d473d21d4bb5477582539ffd9a4c57600ec20c22ee9d7e63146cbbfbb2.png" alt="Tool Settings" width="700" /></p> - تكوين منفذ الخادم والفتح التلقائي وفترة الاستقصاء - نظرة عامة على استخدام التخزين مع خيار مسح البيانات - التشخيص: إصدار Xcode، وتوفر devicectl، وإصدار adb - تقرير تصحيح بنقرة واحدة للإبلاغ عن الأخطاء ## دليل المجموعات تتيح لك المجموعات تجميع إجراءات أجهزة متعددة في تسلسل قابل لإعادة الاستخدام وتطبيقها على أي مجموعة من الأجهزة بنقرة واحدة. ### إنشاء مجموعة افتح لوحة المجموعات من الشريط الجانبي. انقر على **New Collection** وأعطها اسمًا. تبدأ المجموعة فارغة — ستضيف الخطوات من كتالوج الإجراءات. ### إضافة الخطوات انقر على **Add Step** لتصفّح كتالوج الإجراءات المصنّف. تُنظَّم الإجراءات حسب الوحدة — إعدادات الجهاز، والموقع، وإدارة التطبيقات، والمزيد. اختر إجراءً، وكوّن معاملاته مباشرةً (الإحداثيات، ومعرّفات الحزم، وقيم التبديل)، وسيظهر في مجموعتك. اسحب الخطوات لإعادة ترتيبها. ### تطبيق مجموعة انقر على **Apply** لفتح نافذة التطبيق. اختر جهازًا مستهدفًا واحدًا أو أكثر من قائمة الأجهزة. يعرض ملخص التوافق الخطوات التي سيتم تخطيها على المنصات غير المتوافقة (على سبيل المثال، إجراءات iOS فقط على جهاز Android). اضغط **Cmd+Enter** للتنفيذ. تعرض مصفوفة الحالة المباشرة تقدم كل خطوة وكل جهاز في الوقت الفعلي. ### التكامل مع لوحة الأوامر تظهر المجموعات المحفوظة في لوحة الأوامر (**Cmd+K**). ابحث عن مجموعة بالاسم وطبّقها مباشرةً مع منتقي الأجهزة — دون الحاجة إلى الانتقال إلى لوحة المجموعات. ### المجموعات الأولية تأتي ثلاث إعدادات مسبقة مضمّنة مع simvyn: - **Dark Mode + Japanese Locale** — يفعّل الوضع الداكن ويضبط اللغة على اليابانية - **Screenshot Setup** — يكوّن تجاوزات شريط الحالة للحصول على لقطات شاشة نظيفة لمتجر التطبيقات - **Reset Device State** — يمسح الموقع، ويعيد ضبط الإعدادات، ويمسح بيانات التطبيق ### استخدام CLI```bash simvyn collections list # List all collections simvyn collections apply <name> <devices...> # Apply a collection to devices ``` ## مرجع CLI كل ميزة متاحة من سطر الأوامر. شغّل `simvyn` بدون وسائط لبدء لوحة التحكم، أو استخدم أي أمر أدناه للتشغيل بدون واجهة. | الأمر | الوصف | | ------------------------------------------------- | ------------------------------------------ | | `simvyn` | بدء لوحة التحكم (افتراضي) | | `simvyn device list` | عرض جميع الأجهزة | | `simvyn device boot <device>` | تشغيل جهاز | | `simvyn device shutdown <device>` | إيقاف تشغيل جهاز | | `simvyn device erase <device>` | مسح محتوى الجهاز وإعداداته | | `simvyn device create <name> <type> <runtime>` | إنشاء محاكي iOS جديد | | `simvyn device clone <device> <name>` | استنساخ محاكي iOS | | `simvyn device rename <device> <name>` | إعادة تسمية محاكي iOS | | `simvyn device delete <device>` | حذف محاكي iOS | | `simvyn location set <device> <lat> <lng>` | تعيين إحداثيات GPS | | `simvyn location route <device> <file>` | تشغيل مسار GPX/KML | | `simvyn location clear <device>` | مسح الموقع المحاكى | | `simvyn app list <device>` | عرض التطبيقات المثبّتة | | `simvyn app install <device> <path>` | تثبيت IPA أو APK أو iOS simulator .app | | `simvyn app uninstall <device> <bundle-id>` | إلغاء تثبيت تطبيق | | `simvyn app launch <device> <bundle-id>` | تشغيل تطبيق | | `simvyn app terminate <device> <bundle-id>` | إنهاء تطبيق | | `simvyn app info <device> <bundle-id>` | عرض تفاصيل التطبيق | | `simvyn app clear-data <device> <bundle-id>` | مسح بيانات التطبيق (Android) | | `simvyn logs <device>` | بث سجلات الجهاز | | `simvyn screenshot <device>` | التقاط لقطة شاشة | | `simvyn record <device>` | تسجيل الشاشة | | `simvyn link <device> <url>` | فتح رابط عميق | | `simvyn push <device>` | إرسال إشعار فوري | | `simvyn fs ls <device> <bundle-id> [path]` | عرض الملفات في صندوق رمل التطبيق | | `simvyn fs pull <device> <bundle-id> <path>` | تنزيل ملف | | `simvyn fs push <device> <bundle-id> <src> <dst>` | رفع ملف | | `simvyn db list <device> <bundle-id>` | عرض قواعد البيانات | | `simvyn db query <device> <bundle-id> <db> <sql>` | تشغيل استعلام SQL | | `simvyn db prefs <device> <bundle-id>` | عرض SharedPreferences / NSUserDefaults | | `simvyn keychain add <device> <cert>` | إضافة شهادة جذر | | `simvyn keychain reset <device>` | إعادة تعيين سلسلة المفاتيح | | `simvyn collections list` | عرض جميع المجموعات | | `simvyn collections show <id>` | عرض تفاصيل المجموعة | | `simvyn collections create <name>` | إنشاء مجموعة جديدة | | `simvyn collections delete <id>` | حذف مجموعة | | `simvyn collections duplicate <id>` | تكرار مجموعة | | `simvyn collections apply <name> <devices...>` | تطبيق مجموعة على الأجهزة | | `simvyn settings orientation <device> <orient>` | تعيين اتجاه الجهاز (Android) | ## كيف يعمل يغلّف simvyn كلاً من `xcrun simctl` (محاكيات iOS)، و`xcrun devicectl` (أجهزة iOS الفعلية)، و`adb` (Android) خلف واجهة موحّدة. لا حاجة إلى SDK — يعمل مع أي تطبيق، دون الحاجة إلى أي تغييرات في الكود. بُني الهيكل حول نظام وحدات حيث تكون كل ميزة (الموقع، السجلات، إدارة التطبيقات، إلخ) إضافة قائمة بذاتها تسجّل مسارات API الخاصة بها، وأوامر CLI، ومعالجات WebSocket. تتواصل لوحة التحكم على الويب مع خادم Fastify محلي عبر اتصال WebSocket واحد متعدد الإرسال لحالة الجهاز في الوقت الفعلي وبث السجلات. تُعطَّل الميزات غير المتاحة على نوع جهاز معيّن تلقائيًا مع مؤشرات واضحة في الواجهة. ## المنصات المدعومة | المنصة | محاكيات iOS | أجهزة iOS | محاكيات Android | أجهزة Android | | -------- | -------------- | ----------- | ----------------- | --------------- | | macOS | نعم | محدود | نعم | نعم | | Linux | لا | لا | نعم | نعم | ### دعم الأجهزة الفعلية تُكتشف الأجهزة الفعلية المتصلة عبر USB تلقائيًا إلى جانب المحاكيات. تجمّعها لوحة التحكم في أقسام منفصلة (أجهزة فعلية / محاكيات / محاكيات Android) وتعرض إشعارًا عند فصل جهاز. **أجهزة Android الفعلية** تدعم جميع الميزات تقريبًا — إدارة التطبيقات، الروابط العميقة، السجلات، لقطات الشاشة، مفتش قواعد البيانات، متصفح الملفات، والمزيد. بعض الميزات الخاصة بالمحاكيات فقط (محاكاة الموقع عبر `adb emu geo`، محاكاة البطارية) غير متاحة ومُعلَّمة بوضوح في الواجهة. **أجهزة iOS الفعلية** تتطلب Xcode 15+ وتستخدم `xcrun devicectl` في الخلفية. تشمل الميزات المدعومة اكتشاف الأجهزة، تثبيت/إلغاء تثبيت/تشغيل/إنهاء التطبيقات، عرض التطبيقات، الروابط العميقة، ونسخ الملفات. العديد من الميزات التي تعتمد على `simctl` (لقطات الشاشة، تسجيل الشاشة، محاكاة الموقع، الحافظة، المظهر، شريط الحالة، الإشعارات الفورية) غير متاحة على أجهزة iOS الفعلية. تُعطَّل عناصر التحكم غير المدعومة مع تلميحات توضح السبب. تتخطى المجموعات تلقائيًا الخطوات التي لا تنطبق على الأجهزة الفعلية. ## المساهمة المساهمات مرحّب بها — إصلاحات الأخطاء، وحدات جديدة، تغطية منصات، ووثائق على حد سواء. ابدأ بـ **[دليل المساهمة](https://github.com/pranshuchittora/simvyn/blob/main/CONTRIBUTING.md)**، الذي يغطي إعداد التطوير، وتخطيط المشروع، وكيفية إضافة وحدة، والفحوصات التي يشغّلها CI. - [الإبلاغ عن خطأ](https://github.com/pranshuchittora/simvyn/issues/new?template=bug_report.yml) - [طلب ميزة](https://github.com/pranshuchittora/simvyn/issues/new?template=feature_request.yml) --- [Read more](https://github.com/pranshuchittora/simvyn)
