يبدأ تشغيل الخادم المحلي، ويفتح لوحة الويب في المتصفح، ويكتشف تلقائيًا جميع simulators، و emulators، والأجهزة الفعلية المتصلة عبر USB.

## التثبيت

**تثبيت عالمي:**```bash
npm install -g simvyn

**المتطلبات:**

- Node.js >= 22.12.0
- macOS (دعم كامل لنظامي iOS و Android) أو Linux (Android فقط)

## الميزات

- **إدارة الأجهزة** — اكتشاف، تشغيل، إيقاف، مسح، إنشاء، واستنساخ المحاكيات والمحاكيات الافتراضية والأجهزة الحقيقية مع تثبيت المفضلة
- **إدارة التطبيقات** — تثبيت، تشغيل، إنهاء، إلغاء تثبيت التطبيقات عبر السحب والإفلات أو CLI
- **عارض السجلات** — دفق مباشر مع تصفية المستوى، بحث داخل الصفحة (Cmd+F)، بحث بالتعبير العادي، ترقيم الصفحات، والتصدير
- **محاكاة الموقع** — تعيين إحداثيات GPS، تشغيل مسارات GPX/KML مع التحكم في السرعة، حفظ المفضلة
- **إعدادات الجهاز** — الوضع الداكن، الإعدادات المحلية، الاتجاه، الأذونات، تجاوز شريط الحالة، الإعدادات المسبقة لإمكانية الوصول
- **لقطات الشاشة والتسجيل** — التقاط لقطات شاشة وتسجيل فيديو الشاشة مع السجل
- **الروابط العميقة** — فتح عناوين URL والمخططات المخصصة، حفظ المفضلة لكل تطبيق
- **مفتش قاعدة البيانات** — تصفح جداول SQLite، تشغيل استعلامات SQL، عرض SharedPreferences و NSUserDefaults
- **متصفح الملفات** — تصفح بيئات تطبيقات الحماية، تحميل/تنزيل الملفات، تحرير النصوص بشكل مضمن
- **الإشعارات الفورية** — إنشاء حمولات JSON، إرسالها إلى محاكيات iOS، مكتبة قوالب
- **المجموعات** — حزم إجراءات الأجهزة في تسلسلات قابلة لإعادة الاستخدام، تطبيقها على أجهزة متعددة مرة واحدة
- **سجلات الانهيار** — تقارير تشخيص iOS وسجلات الانهيار من logcat/tombstone في Android
- **الحافظة** — قراءة وكتابة محتويات حافظة الجهاز
- **الوسائط** — دفع الصور ومقاطع الفيديو إلى ألبومات الكاميرا والمعارض في الجهاز
- **إعدادات الأداة** — تكوين الخادم، إدارة التخزين، التشخيص، وتقارير التصحيح
- **دعم الأجهزة الحقيقية** — توصيل أجهزة Android و iOS الحقيقية عبر USB مع اكتشاف تلقائي
- **لوحة القيادة على الويب** — تصميم Apple Liquid Glass مع لوحة أوامر، تنقل بلوحة المفاتيح
- **واجهة سطر أوامر كاملة** — كل ميزة تعمل بدون واجهة رسومية عبر `simvyn <command>`

## عروض الوحدات

### إدارة الأجهزة

اكتشف جميع محاكيات iOS وأجهزة محاكاة Android والأجهزة الحقيقية المتصلة عبر USB في قائمة واحدة موحدة. قم بتشغيل وإيقاف ومسح الأجهزة دون لمس Xcode أو Android Studio. أنشئ محاكيات iOS جديدة باختيار نوع الجهاز ووقت التشغيل، أو استنسخ محاكيًا موجودًا لتجهيز نسخ مكررة بسرعة. تظهر الأجهزة الحقيقية تلقائيًا عند توصيلها وتكون مجمعة بشكل منفصل في محدد الأجهزة.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/2b85641878f6015c248311700a1a87a20476ade6c930273a3e47f288a82d6d2e.png" alt="إدارة الأجهزة" 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="إدارة التطبيقات" width="700" /></p>

- تثبيت السحب والإفلات لحزم IPA و APK و .app الخاصة بمحاكي iOS
- تشغيل وإنهاء وإلغاء تثبيت التطبيقات بواسطة bundle ID
- عرض تفاصيل التطبيق بما في ذلك الإصدار والحجم والأذونات
- مسح بيانات التطبيق على أجهزة Android
- عرض جميع التطبيقات المثبتة مع تصفية البحث

### عارض السجلات

قم ببث سجلات الجهاز في الوقت الفعلي مع تصفية قوية. قم بالتصفية حسب مستوى السجل، ابحث باستخدام أنماط التعبير العادي، وقم بالتصفية حسب اسم العملية. استخدم البحث داخل الصفحة (Cmd+F) لتسليط الضوء على إدخالات محددة دون إخفاء السياق المحيط. قم بتصدير السجلات المصفاة للمشاركة أو الأرشفة. يتيح لك السجل المترقب التمرير للخلف عبر آلاف الإدخالات دون مشاكل في الأداء.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/b909b3515637b4059ebf210c56599f2f022506f09ee35a11e812bd8368d3750e.png" alt="عارض السجلات" width="700" /></p>

- بث السجلات في الوقت الفعلي عبر WebSocket
- تصفية حسب المستوى: تصحيح، معلومات، تحذير، خطأ، قاتل
- بحث داخل الصفحة (Cmd+F) مع تمييز المطابقة، التنقل، والعداد
- بحث بالتعبير العادي وتصفية اسم العملية
- سجل مترقب مع تمرير افتراضي
- تصدير السجلات المصفاة إلى ملف
- إيقاف/استئناف بث السجلات مع الحفاظ على الحالة عبر عمليات المسح

### الموقع

قم بتعيين إحداثيات GPS دقيقة على أي جهاز باستخدام خريطة تفاعلية أو إدخال يدوي. قم بتشغيل ملفات مسار GPX و KML مع التحكم في السرعة القابلة للتعديل. احفظ المواقع المستخدمة بشكل متكرر كمفضلة للوصول السريع.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/47842dfa878ffbc80bd5bb32d83e820e7ed7dd56a4d63368ca6e823ef72889d4.png" alt="الموقع" width="700" /></p>

- خريطة تفاعلية مع النقر لتعيين الإحداثيات
- تشغيل ملفات مسار GPX و KML مع التحكم في السرعة
- المواقع المفضلة المحفوظة لكل جهاز
- بث الموقع إلى أجهزة متعددة
- الترميز الجغرافي العكسي لعناوين قابلة للقراءة البشرية

### إعدادات الجهاز

قم بتبديل الوضع الداكن، تغيير الإعدادات المحلية، تدوير اتجاه الجهاز (Android)، إدارة أذونات التطبيق، وتجاوز مظهر شريط الحالة. قم بتطبيق الإعدادات المسبقة لإمكانية الوصول لاختبار تطبيقك تحت ظروف مختلفة. تصبح جميع تغييرات الإعدادات سارية المفعول فورًا على الجهاز المستهدف.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/d3f6a33c17b773560072f7b94b71abd5ebc82786c073bdeb6d25f828c3f214fa.png" alt="إعدادات الجهاز" width="700" /></p>

- تبديل الوضع الداكن/الفاتح
- تغيير الإعدادات المحلية للجهاز
- إدارة أذونات التطبيق
- تجاوز شريط الحالة (الوقت، البطارية، الإشارة)
- الإعدادات المسبقة لإمكانية الوصول (نص عريض، زيادة التباين، حجم المحتوى)

### لقطات الشاشة والتسجيل

قم بالتقاط لقطات شاشة وتسجيل فيديو الشاشة على أي جهاز. يتم حفظ جميع اللقطات مع الطوابع الزمنية وتنظيمها في سجل قابل للتصفح. قم بتنزيل أو حذف اللقطات مباشرة من لوحة القيادة.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/58ed8f25d148ed53f39066e42be730f255235dbec47539bbec826c455cba7936.png" alt="لقطات الشاشة والتسجيل" width="700" /></p>

- التقاط لقطة شاشة بنقرة واحدة
- تسجيل الشاشة مع عناصر تحكم البدء/الإيقاف
- سجل اللقطات مع الطوابع الزمنية
- تنزيل وحذف اللقطات من لوحة القيادة

### الروابط العميقة

افتح عناوين URL والمخططات URI المخصصة على أي جهاز. احفظ الروابط العميقة المستخدمة بشكل متكرر كمفضلة منظمة حسب التطبيق. اختبر معالجة تطبيقك للروابط العميقة دون كتابة عناوين URL يدويًا في محطة طرفية.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/3a990ef7c74f83c93b63c1654f74b3fa952b0b41abd31fe688cdaf2e29570f62.png" alt="الروابط العميقة" 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="مفتش قاعدة البيانات" 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="متصفح الملفات" width="700" /></p>

- تصفح دلائل بيئة الحماية للتطبيق
- رفع وتنزيل الملفات
- تحرير الملفات النصية بشكل مضمن
- يعمل مع حاويات تطبيقات iOS و Android

### الإشعارات الفورية

قم بتأليف حمولات JSON للإشعارات الفورية وإرسالها إلى محاكيات iOS. استخدم مكتبة القوالب المضمنة كنقطة بداية أو اكتب الحمولات من الصفر. التحقق من صحة JSON في الوقت الفعلي يسلط الضوء على الأخطاء قبل الإرسال.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/f640654be67c24c7248806987e62908316407c18648fc145109118f260443f7d.png" alt="الإشعارات الفورية" width="700" /></p>

- تأليف وإرسال حمولات الدفع إلى محاكيات iOS
- مكتبة قوالب الحمولات المضمنة
- التحقق من صحة JSON في الوقت الفعلي
- استهداف تطبيقات محددة بواسطة bundle ID

### المجموعات

أنشئ مجموعات قابلة لإعادة الاستخدام من إجراءات الأجهزة وطبقها على أجهزة متعددة مرة واحدة. تجمع المجموعات بين خطوات مثل تعيين الموقع، تبديل الوضع الداكن، وتثبيت تطبيق في سير عمل واحد قابل للتكرار. تأتي ثلاثة إعدادات مسبقة مع simvyn لتبدأ بها.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/fbf2ddbba1d3725321c80a914bf5b71ea6a2fc605fddbb73abd0b28385488af6.png" alt="المجموعات" width="700" /></p>

- إنشاء وتكرار وإدارة المجموعات المسماة
- تصفح كتالوج الإجراءات المصنف عبر جميع الوحدات
- إعادة ترتيب الخطوات بالسحب والإفلات
- تطبيق على أجهزة متعددة مع التحقق من التوافق
- ثلاثة إعدادات مسبقة مدمجة للبدء

### سجلات الانهيار

عرض تقارير تشخيص iOS (ملفات .ips) وسجلات انهيار Android من logcat وتفريغات tombstone. تصفح إدخالات الانهيار مع الطوابع الزمنية ومعلومات العملية. فحص تفاصيل الانهيار الكاملة دون البحث في أنظمة ملفات الجهاز.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/8f74a799448050bc37eace1d43865b13f3f47a0997c01dba650fd21e94f09ebf.png" alt="سجلات الانهيار" width="700" /></p>

- تحليل تقارير تشخيص iOS (.ips)
- تجميع انهيارات logcat في Android بواسطة PID والعلامة
- استرجاع تفريغات tombstone في Android
- قائمة انهيارات مع طوابع زمنية وعرض تفصيلي

### الحافظة

قراءة وكتابة حافظة الجهاز من لوحة القيادة أو CLI. مفيد للصق بيانات الاختبار بسرعة في التطبيقات أو فحص ما نسخه التطبيق.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/db889032abeb5f1d511dcfeb8c06c215bda851436f198a63db97f595b50853d6.png" alt="الحافظة" width="700" /></p>

- قراءة محتويات الحافظة الحالية
- كتابة نص إلى حافظة الجهاز
- يعمل مع محاكيات iOS وأجهزة محاكاة Android

### الوسائط

ادفع الصور ومقاطع الفيديو مباشرة إلى ألبوم الكاميرا أو معرض الجهاز. قم بإسقاط الملفات على لوحة القيادة لحقنها بدون كابلات أو بريد إلكتروني أو نقل سحابي.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/c63ce5411dc17b5d329c2af381c035d86164f5544928b0c76fe7d05346473561.png" alt="الوسائط" width="700" /></p>

- إضافة الصور ومقاطع الفيديو إلى معرض الجهاز عبر السحب والإفلات
- يدعم الملفات الكبيرة حتى 500 ميجابايت
- يعمل مع محاكيات iOS وأجهزة محاكاة Android

### إعدادات الأداة

قم بتكوين خادم simvyn، إدارة التخزين، وعرض التشخيصات. يتضمن مولد تقرير تصحيح لتقديم المشكلات.

<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7ba043d473d21d4bb5477582539ffd9a4c57600ec20c22ee9d7e63146cbbfbb2.png" alt="إعدادات الأداة" width="700" /></p>

- تكوين منفذ الخادم، الفتح التلقائي، وفاصل الاستقصاء
- نظرة عامة على استخدام التخزين مع خيار مسح البيانات
- التشخيصات: إصدار Xcode، توفر devicectl، إصدار adb
- تقرير تصحيح بنقرة واحدة لتقديم الأخطاء

## دليل المجموعات

تتيح لك المجموعات حزم إجراءات أجهزة متعددة في تسلسل قابل لإعادة الاستخدام وتطبيقها على أي مجموعة من الأجهزة بنقرة واحدة.

### إنشاء مجموعة

افتح لوحة المجموعات من الشريط الجانبي. انقر على **مجموعة جديدة** وأعطها اسماً. تبدأ المجموعة فارغة — ستضيف خطوات من كتالوج الإجراءات.

### إضافة خطوات

انقر على **إضافة خطوة** لتصفح كتالوج الإجراءات المصنف. يتم تنظيم الإجراءات حسب الوحدة — إعدادات الجهاز، الموقع، إدارة التطبيقات، والمزيد. حدد إجراءً، قم بتكوين معلماته بشكل مضمن (الإحداثيات، معرفات الحزم، قيم التبديل)، وسيظهر في مجموعتك. اسحب الخطوات لإعادة ترتيبها.

### تطبيق مجموعة

انقر على **تطبيق** لفتح نافذة التطبيق. حدد جهازًا مستهدفًا واحدًا أو أكثر من قائمة الأجهزة. يظهر ملخص التوافق يوضح الخطوات التي سيتم تخطيها على المنصات غير المتوافقة (مثل إجراءات iOS فقط على جهاز Android). اضغط **Cmd+Enter** للتنفيذ. تظهر مصفوفة حالة حية تقدم كل خطوة وكل جهاز في الوقت الفعلي.

### تكامل لوحة الأوامر

تظهر المجموعات المحفوظة في لوحة الأوامر (**Cmd+K**). ابحث عن مجموعة بالاسم وطبقها مباشرة مع منتقي الأجهزة — لا حاجة للانتقال إلى لوحة المجموعات.

### المجموعات الابتدائية

تأتي ثلاثة إعدادات مسبقة مدمجة مع simvyn:

- **الوضع الداكن + الإعدادات المحلية اليابانية** — يفعل الوضع الداكن ويضبط الإعدادات المحلية على اليابانية
- **إعداد لقطة الشاشة** — يهيئ تجاوزات شريط الحالة للحصول على لقطات شاشة نظيفة لمتجر التطبيقات
- **إعادة تعيين حالة الجهاز** — يمسح الموقع ويعيد تعيين الإعدادات ويمسح بيانات التطبيق

### استخدام CLI```bash
simvyn collections list                         # List all collections
simvyn collections apply <name> <devices...>    # Apply a collection to devices