المحرر

‏VS Code وGitHub مع Mokxi

احتفظ بمشاريعك في مستودع GitHub الخاص بك، وعدّل الكود في VS Code، وشغّله في Mokxi.

هناك ثلاث طرق للعمل على مشروع خارج المتصفح، وكلها تستخدم الملفات نفسها، لذا يمكنك المزج بينها: الحفظ إلى GitHub من المحرر، واستنساخ المستودع وفتحه في VS Code، والمزامنة من VS Code أو من الطرفية، ثم فتحه في Mokxi مرة أخرى.

كيف يبدو المشروع المحفوظ

كل حفظ إلى GitHub، وكل أمر mokxi pull، وكل مشروع يفتحه VS Code له التنسيق نفسه:

الملف ما هي
Blink/Blink.ino الكود، كمجلد Arduino IDE، مع بقية تبويباته بجانبه
diagram.mokxi.json المشروع كاملاً: القطع والأسلاك والملاحظات والكود. يفتحه Mokxi كما هو
README.md ما هو المشروع، مع شارة افتح في Mokxi
.vscode/extensions.json يوصي بإضافة Mokxi عند فتح المجلد في VS Code
.vscode/settings.json أي مشروع Mokxi هذا المجلد
.vscode/tasks.json أوامر push وpull وrun وcompile وupload كمهام VS Code
.gitignore يترك حالة المزامنة ومخرجات البناء من سطر الأوامر جانباً

يأخذ المجلد اسم المشروع، لذا يفتحه Arduino IDE كما هو (File > Open > Blink/Blink.ino). المشروع الذي فيه لوحتان يحصل على مجلد لكل لوحة، مثل Traffic_Lights_uno1/ وTraffic_Lights_esp1/.

عدّل الكود في المجلد، لا داخل diagram.mokxi.json: عندما يقرأ Mokxi المستودع مجدداً، يكون للمجلد الأولوية. التبويب الذي تحذفه من المجلد يُحذف من المشروع، والملف الجديد فيه يصبح تبويباً جديداً.

ملف README و.gitignore وملفات .vscode ملكك بمجرد أن توجد: يكتبها Mokxi في المرة الأولى ويترك تعديلاتك وشأنها بعد ذلك.

الحفظ إلى GitHub من المحرر

  1. افتح تصدير في رأس المحرر.
  2. تحت GitHub، اضغط ربط GitHub. سيطلب منك GitHub السماح لـ Mokxi بالكتابة في مستودعاتك العامة. علّم تضمين المستودعات الخاصة أولاً إن أردت الخاصة أيضاً.
  3. عد إلى المحرر، افتح تصدير مرة أخرى واضغط الحفظ إلى GitHub.
  4. اختر مستودع جديد (يسميه Mokxi باسم المشروع) أو واحداً من مستودعاتك، واكتب رسالة commit إن أردت، ثم اضغط الحفظ إلى GitHub.

ستحصل على رابط إلى الـ commit على GitHub. كل حفظ لاحق هو commit جديد على الفرع نفسه. السطر أعلى البطاقة يخبرك أين أنت:

  • Synced with ada/blink (main): GitHub فيه هذا المشروع تماماً.
  • Changes not saved to ada/blink yet: غيّرت المشروع منذ ذلك الحين.
  • ada/blink has newer commits: أحدهم دفع إلى المستودع. استخدم فتح من GitHub للحصول عليها.

الفتح من GitHub

افتح تصدير واضغط فتح من GitHub، ثم اختر أحد مستودعاتك أو الصق أي مستودع تستطيع قراءته (owner/name أو رابط github.com).

  • المستودع المحفوظ من Mokxi يُفتح كما حُفظ، مع أي تعديلات أُجريت على مجلد الكود على GitHub أو في VS Code.
  • مستودع كود Arduino العادي (مجلد فيه ملف .ino) يُفتح أيضاً. يضعه Mokxi على لوحة Uno، أو ESP32 عندما يتضمن الكود WiFi. غيّر اللوحة إن كان مخصصاً للوحة أخرى.

ما كان مفتوحاً من قبل يوضع على الرف أولاً، كما في فتح JSON، فلا يضيع شيء. شارة افتح في Mokxi في README للمستودع المحفوظ تفتح المشروع مباشرة.

الربط والفصل

يطلب Mokxi من GitHub الوصول إلى المستودعات فقط عند ضغطك ربط GitHub، ولا يطلبه أبداً عند تسجيل الدخول. إنه إذن منفصل عن تسجيل الدخول بـ GitHub، ويعمل بالطريقة نفسها إن سجّلت الدخول بحساب Google أو Microsoft أو البريد الإلكتروني.

يُخزَّن الوصول مشفراً مع حسابك ولا يُستخدم إلا عند ضغطك حفظ أو فتح. لا شيء آخر في Mokxi يقرأه، ولا يُرسل أبداً إلى متصفحك.

لفصل الاتصال، اذهب إلى الإعدادات > الحسابات المرتبطة واضغط قطع الاتصال. يلغي Mokxi وصوله لدى GitHub ويحذفه. وإغلاق حسابك يفعل الشيء نفسه. يمكنك أيضاً إلغاؤه على GitHub، تحت Settings > Applications > Authorized OAuth Apps.

لا تُتاح مزامنة GitHub لطلاب الفصل ولا لحسابات الأطفال.

VS Code

ثبّت Mokxi من VS Code Marketplace (ابحث عن Mokxi في عرض Extensions)، أو من Open VSX في VSCodium وCursor. المجلد المحفوظ من Mokxi يوصي به بالفعل.

تشغيل الدائرة في VS Code

افتح مجلد مشروع: مشروع Mokxi، أو مشروع Wokwi (wokwi.toml وdiagram.json) أو كود. اضغط تشغيل المحاكي (زر التشغيل على الكود أو المخطط). تعمل الدائرة في لوحة بجانب الكود، على المحرك نفسه الذي يعمل عليه محرر Mokxi، وتظهر طرفية الشاشة التسلسلية لـ Mokxi ما تكتبه اللوحات؛ اكتب سطراً هناك واضغط Enter لإرساله. حفظ الكود أو المخطط، أو بناء جديد من أداة البناء، يشغّله من جديد. زرا الإيقاف وإعادة التشغيل في شريط عنوان اللوحة وفي شريط الحالة.

المشروع الذي فيه بناء (البرنامج الثابت الذي يحدده wokwi.toml، أو بناء PlatformIO، أو بناء arduino-cli) يشغّل ذلك البناء؛ وإلا فتترجم اللوحة الكود كما يفعل المحرر. لا يحتاج أي من هذا إلى حساب.

الاختبارات والـ lint وCI

  • ملفات السيناريوهات (mokxi.test.yaml، *.test.yaml، وملفات Wokwi *.scenario.yaml) تظهر في عرض Testing في VS Code. كل سيناريو اختبار تحته خطواته؛ يشير الفشل إلى سطر الخطوة، مع آخر أسطر المخرج التسلسلي.
  • ‏Mokxi: Check the Circuit (Lint) يضع مشاكل التوصيلات في لوحة المشاكل. ويعمل أيضاً عند حفظ المخطط.
  • ‏Mokxi: Screenshot a Display يحفظ الشاشة كصورة PNG في اللحظة التي تختارها.
  • ‏Mokxi: Set Up CI (GitHub Actions أو GitLab) يكتب ملف الـ workflow، أو ملف GitLab CI، أو كليهما، وأول mokxi.test.yaml إذا لم يكن في المشروع واحد. انظر اختبارات المحاكاة في CI.

مشاريع Mokxi الخاصة بك

  1. اضغط أيقونة Mokxi في شريط النشاط ثم اضغط تسجيل الدخول. وافق على الرمز القصير في متصفحك، أو الصق رمزاً من الإعدادات > المطوّر.
  2. تظهر مشاريعك في الشريط الجانبي. اضغط على أحدها لفتحه كمجلد.
  3. حرّر الكود. تحصل الملفات .ino على تلوين Arduino، مع مقتطفات مثل sketch وblink وbutton وevery.
  4. اضغط Sync (السحابة في شريط عنوان المحرر) لإرساله إلى Mokxi.
  5. خيار Open in Mokxi (عنصر Mokxi في شريط الحالة) يفتحه في المحرر داخل متصفحك.

يرفض Sync الكتابة فوق عمل أُنجز في المتصفح منذ آخر مزامنة لك، ويرفض Pull التخلّي عن تعديلات لم تُزامنها. يخبرك كل منهما بالسبب ويتيح لك الاختيار. الفتح والمزامنة والسحب والرفع جزء من باقة Pro.

الترجمة والرفع

يستخدم الأمر Mokxi: Compile (arduino-cli) أداة arduino-cli إن كانت لديك، مع ظهور الأخطاء في لوحة المشكلات، بينما يقوم الأمر Mokxi: Compile and Upload to Mokxi بالمزامنة والترجمة وتخزين البناء مع المشروع، بحيث يشغّل mokxi.com ما بنيته بالضبط. لا تحتاج إلى arduino-cli للوحة المحاكي، فهي تترجم الكود بنفسها.

سطر الأوامر

تعمل الأمور نفسها من الطرفية باستخدام npx @mokxi/cli. انظر سطر أوامر mokxi.

npx @mokxi/cli login
npx @mokxi/cli pull https://mokxi.com/p/abc123 blink
cd blink && git init
npx @mokxi/cli push
npx @mokxi/cli run --timeout 5s

أي الباقات

GitHub sync and the command line are on every plan. mokxi run and mokxi test compile and simulate on your own machine, so they are free and need no sign-in. In VS Code, the simulator panel, tests, lint, screenshots, Set Up CI and Compile are free and need no account too. Your Mokxi projects in VS Code (opening, Sync, Pull and Compile and Upload to Mokxi) are part of Pro (and the student price and Classroom); without it, the extension says so and offers the 7-day Pro trial where you can still start it. CI runs (the GitHub Action, or the command line tool in a CI job) are free for public repositories; for private ones, CI comes with Pro (and the student price, Classroom, the trial, Lifetime, and Ultra for accounts that still have it); see اختبارات المحاكاة في CI. If you used either in the 60 days before October 12, 2026, you keep it until December 11, 2026, and the tool tells you so. mokxi run --cloud and mokxi simulate run on Mokxi's servers and use the API minutes your plan includes; the developers page lists them.