تطبيقات وأدوات نموذجية لـ Gea Stack. هذا المستودع هو معرض التطبيقات المستخدم من قبل المحاكي والأهداف المدمجة و Gea OS وأهداف Apple وإضافة VS Code/Cursor والعروض التسويقية. كل مثال هو حزمة صغيرة تحتوي على بيان gea في package.json.

ما يوجد هنا: apps/* تطبيقات Gea. معظمها تطبيقات TSX تستهدف الويب و ESP32 و/أو Gea OS. apps/*/package.json بيان التطبيق وتوافق الأهداف والسكريبتات وبيانات التعريف الخاصة بالمشغل. tools/dialer-browser أداة مساعدة صغيرة من جانب المتصفح لسير عمل الاتصال. package.json علامة مساحة العمل لمجموعة الأمثلة. docs الكتالوج وإرشادات المساهمة.

البدء السريع: تشغيل الفحوصات لمثال فردي: cd apps/watch npm install npm run check npm run build. بعض الأمثلة تحمل أيضًا اختبارات، تحمي في الغالب تخطيطًا أو إعداد جهاز لن يكتشفه أي شيء آخر -- npm test في مجلد التطبيق يشغلها. حلقة الويب تُدار من المحاكي، وهو مستودع منفصل: geastack/simulator. تقرأ سكريبتاته التطبيقات من جذر مشروع التطبيقات، الذي تأخذه من GEA_APPS_ROOT -- هذا المستودع، أو مستودعك الخاص. لا يوجد افتراضي، لذا قم بتعيينه أو مرر --app-dir؛ لا شيء يفترض أن المستودعين يقعان بجانب بعضهما البعض. cd /path/to/simulator GEA_APPS_ROOT=/path/to/examples ./targets/web/dev-web.mjs watch # حلقة التطوير GEA_APPS_ROOT=/path/to/examples ./targets/web/build-web.sh watch # البناء للويب ./targets/web/dev-web.mjs --app-dir /path/to/examples/apps/watch # أو سمِّ تطبيقًا واحدًا. قم ببرمجة لوحة متوافقة عبر Gea CLI: npx gea flash watch --board <alias> npx gea flash watch --board <alias> --monitor.

التوثيق: docs/EXAMPLE-CATALOG.md: فئات الأمثلة، توافق الأهداف، وكيفية استخدام البيانات. docs/DEVELOPMENT.md: كيفية إضافة واختبار وصيانة تطبيق نموذجي.

أساسيات بيان التطبيق: يجب أن يحتوي كل تطبيق قابل للبناء على package.json مع حقل gea: {"gea": {"id": "watch","name": "Watch","entry": "index.tsx","runtime": "gea","targets": {"web": true,"esp32": true,"geaos": true}}}. يتم استهلاك البيان من قبل المحاكي وسكريبتات اللوحات المدمجة و Gea OS وأهداف Apple وإضافة IDE. حافظ على دقته.

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

الترخيص: MIT (انظر LICENSE). استخدمه، غيّره، اشحن منتجات مغلقة المصدر عليه، بدون شروط. الكود الوحيد في Gea Stack تحت ترخيص مختلف هو دعم اللوحات المدمجة (targets و @geastack/chips، GPL-3.0-only): شحن برنامج ثابت مغلق المصدر من خلالها يتطلب ترخيصًا تجاريًا. اتصل بـ [email protected] للحصول على الشروط التجارية والدعم والبنيات المستضافة.

الكيانات الرئيسية: الشركات: Gea Stack، GeaOS، Apple، VS Code، Cursor

الأسئلة الشائعة: ما هو الغرض من مستودع geastack/examples؟

يعمل مستودع geastack/examples كمعرض التطبيقات لـ Gea Stack، حيث يوفر تطبيقات وأدوات نموذجية يستخدمها المحاكي والأهداف المدمجة و Gea OS وأهداف Apple وإضافة VS Code/Cursor والعروض التسويقية.

سؤال شائع: ما هو الغرض من مستودع geastack/examples؟

إجابة شائعة: يعمل مستودع geastack/examples كمعرض التطبيقات لـ Gea Stack، حيث يوفر تطبيقات وأدوات نموذجية يستخدمها المحاكي والأهداف المدمجة و Gea OS وأهداف Apple وإضافة VS Code/Cursor والعروض التسويقية.