Preskoči na vsebino

تحميل أداة المدار

أداة المدار (orb) هي أداة سطر الأوامر للتحقق من صحة مخططات المدار وتصريفها والعمل معها.

التثبيت السريع​

npm (موصى به)​

curl -fsSL https://orb.almadar.io/install.sh | sh

npm​

npm install -g @almadar/orb

Homebrew (macOS/Linux)​

brew install almadar/tap/orb

Cargo (لمطوري Rust)​

cargo install orb-cli

التحميل حسب المنصة​

Linux​

المعماريةالصيغةالتحميل
x86_64tar.gzorb-linux-x86_64.tar.gz
x86_64deborb_x86_64.deb
x86_64rpmorb-x86_64.rpm
ARM64tar.gzorb-linux-aarch64.tar.gz

التثبيت (tar.gz):

tar -xzf orb-linux-x86_64.tar.gz
sudo mv orb /usr/local/bin/

macOS​

المعماريةالصيغةالتحميل
Intel (x86_64)tar.gzorb-macos-x86_64.tar.gz
Apple Silicon (ARM64)tar.gzorb-macos-aarch64.tar.gz
Universalpkgorb-macos.pkg

Windows​

المعماريةالصيغةالتحميل
x86_64ziporb-windows-x86_64.zip
x86_64msiorb-windows-x86_64.msi

التثبيت (winget):

winget install Almadar.Orb

التحقق من التثبيت​

orb --version
# Orb CLI v1.0.0

orb --help
# المدار - فيزياء البرمجيات
#
# الاستخدام:
#     orb <أمر>
#
# الأوامر:
#     validate   التحقق من صحة مخطط .orb
#     compile    تصريف المخطط إلى الهدف
#     format     تنسيق مخطط .orb
#     dev        تشغيل خادم التطوير
#     test       تشغيل اختبارات آلة الحالة
#     new        إنشاء مشروع جديد
#     help       طباعة هذه الرسالة

الاستخدام الأساسي​

التحقق من المخطط​

orb validate my-app.orb
# ✓ المخطط صالح
# ✓ ٣ مدارات، ٥ سمات، ٨ كيانات

التصريف إلى TypeScript​

orb compile my-app.orb --shell typescript --output ./generated
# ✓ تم توليد ٢٤ ملف
# ✓ المخرجات: ./generated

تشغيل خادم التطوير​

orb dev my-app.orb
# جاري تشغيل خادم تطوير المدار...
# ✓ تم تحميل المخطط: my-app.orb
# ✓ الخادم: http://localhost:3000
# ✓ العميل: http://localhost:5173
# 
# جاري مراقبة التغييرات...

تشغيل الاختبارات​

orb test my-app.orb
# جاري تشغيل اختبارات آلة الحالة...
# ✓ TaskLifecycle: ١٢ انتقال تم اختباره
# ✓ UserAuth: ٨ انتقالات تم اختبارها
# ✓ تم تقييم جميع الحراس
# 
# الاختبارات: ٢٠ نجحت، ٠ فشلت

إنشاء مشروع جديد​

orb new my-app
# ✓ تم إنشاء my-app/
# ✓ تم إنشاء my-app/schema.orb
# ✓ تم إنشاء my-app/orb.config.json
#
# ابدأ الآن:
#   cd my-app
#   orb dev

الإعدادات​

أنشئ ملف orb.config.json في جذر مشروعك:

{
  "$schema": "https://almadar.io/schemas/config.json",
  "schema": "./schema/my-app.orb",
  "output": "./src/generated",
  "shell": "typescript",
  "locale": "ar",
  "features": {
    "hotReload": true,
    "generateTypes": true,
    "generateDocs": true
  }
}

ثم قم بتشغيل:

orb compile
# يستخدم الإعدادات من orb.config.json

دعم اللغة العربية​

المدار يدعم اللغة العربية بشكل كامل لرسائل الخطأ والمخرجات:

orb validate schema.orb --locale ar
# ✓ المخطط صالح
# ✓ ٣ مدارات، ٥ سمات، ٨ كيانات

الخطوات التالية​

استكشاف الأخطاء​

"الأمر غير موجود"​

تأكد من أن الملف التنفيذي في مسار PATH:

# تحقق من مكان تثبيت orb
which orb

# أضف إلى PATH إذا لزم الأمر (أضف إلى ~/.bashrc أو ~/.zshrc)
export PATH="$PATH:/path/to/orb"

رفض الصلاحيات (Linux/macOS)​

chmod +x /usr/local/bin/orb

تحتاج مساعدة؟ انضم إلى Discord أو افتح مشكلة.