التثبيت
واجهة سطر أوامر 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
هذا السكربت:
- يكتشف نظام التشغيل وبنية المعالج
- يحمّل الملف الثنائي الأصلي الصحيح من إصدارات GitHub
- يضعه في
~/.orb/bin/ - يضيف
~/.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 دقائق.