التثبيت

واجهة سطر أوامر Orb (orb) هي ملف ثنائي أصلي مُصرَّف من Rust. تعمل على Linux وmacOS وWindows بدون أي تبعيات وقت التشغيل. التطبيقات المولّدة تحتاج Node.js، لكن المُصرِّف نفسه لا يحتاج.

متطلبات النظام

المتطلب	الغرض
أي نظام تشغيل (Linux، macOS، Windows)	الملف الثنائي orb متاح لجميع المنصات الرئيسية
Node.js 18+	مطلوب لتشغيل التطبيقات المولّدة (مخرجات orb compile هي مشاريع TypeScript/React)
npm أو pnpm	مدير حزم لتثبيت تبعيات التطبيق المولّد

الملف الثنائي orb نفسه ليس له أي تبعيات وقت تشغيل. Node.js مطلوب فقط عندما تُصرِّف برنامج .orb وتريد تشغيل التطبيق المولّد.

التثبيت عبر السكربت (macOS / Linux)

الطريقة الأسرع للتثبيت:

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

هذا السكربت:

1. يكتشف نظام التشغيل وبنية المعالج
2. يحمّل الملف الثنائي الأصلي الصحيح من إصدارات GitHub
3. يضعه في ~/.orb/bin/
4. يضيف ~/.orb/bin إلى PATH (بتحديث ملف إعدادات الصدفة)

بعد التثبيت، افتح طرفية جديدة (أو نفّذ source لملف الإعدادات) وتحقق:

orb --version

التثبيت عبر npm (جميع المنصات)

إذا كان Node.js مثبتاً لديك:

npm install -g @almadar/orb

حزمة npm تتضمن سكربت postinstall يحمّل الملف الثنائي الأصلي الصحيح لمنصتك. الحزمة نفسها غلاف خفيف: كل عمل التصريف يتم بواسطة الملف الثنائي الأصلي، وليس بواسطة Node.js.

هذه الطريقة تعمل على جميع المنصات بما في ذلك Windows، حيث سكربت الصدفة غير متاح.

التثبيت عبر Homebrew (macOS)

brew tap almadar-io/tap
brew install orb

Homebrew يعالج التحديثات تلقائياً مع brew upgrade orb.

التحميل اليدوي

حمّل ملفاً ثنائياً مُعداً مسبقاً مباشرة من صفحة إصدارات GitHub.

المنصة	البنية	اسم الملف
Linux	x86_64	orb-linux-x64
Linux	ARM64	orb-linux-arm64
macOS	Intel	orb-darwin-x64
macOS	Apple Silicon	orb-darwin-arm64
Windows	x86_64	orb-windows-x64.exe

بعد التحميل:

# macOS / Linux
chmod +x orb-*
mv orb-* /usr/local/bin/orb

# تحقق
orb --version

على Windows، ضع ملف .exe في مجلد موجود في PATH، أو أضف موقعه إلى PATH عبر إعدادات النظام.

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

نفّذ الأمر التالي للتأكد من أن كل شيء يعمل:

orb --version

يجب أن ترى مخرجات مثل orb 0.x.y مع رقم الإصدار.

للتأكد من أن المُصرِّف يمكنه توليد الكود، يمكنك أيضاً تنفيذ:

orb --help

هذا يطبع جميع الأوامر المتاحة: validate، compile، dev، format، وغيرها.

حول قالب الغلاف (Shell Template)

عندما تنفذ orb compile، يولّد المُصرِّف تطبيقاً كاملاً بـ TypeScript (واجهة React، خادم Express، أنواع مشتركة). هذا المشروع المولّد يحتاج Node.js وnpm لتثبيت التبعيات والتشغيل.

العلاقة:

your-app.orb          (المصدر: برنامج Orb الخاص بك)
      |
  orb compile          (ملف ثنائي أصلي، لا يحتاج Node.js)
      |
  my-app/              (مشروع TypeScript مولّد)
    packages/client/   (React + Vite، يحتاج Node.js)
    packages/server/   (Express، يحتاج Node.js)
    packages/shared/   (أنواع مشتركة)

المُصرِّف هو ملف ثنائي أصلي. المخرجات هي مشروع Node.js. هذان شاغلان منفصلان: يمكنك التصريف على جهاز بدون Node.js، ثم نشر الكود المولّد في مكان آخر.

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

مع تثبيت واجهة سطر الأوامر، انتقل إلى البداية السريعة لبناء وتشغيل أول تطبيق Orb في أقل من 5 دقائق.