إنتقل إلى المحتوى الرئيسي

التثبيت

المتطلبات​

  • Node.js 18.0 أو أعلى
  • npm 8.0 أو أعلى (يأتي مع Node.js)
  • Git (لميزات التحكم في الإصدارات)

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

npm install -g archicore

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

archicore --version
# ArchiCore v0.1.0

المصادقة​

قبل استخدام ArchiCore، تحتاج إلى المصادقة:

archicore login

هذا سيقوم بـ:

  1. فتح متصفحك على صفحة تسجيل الدخول إلى ArchiCore
  2. بعد تسجيل الدخول، تكوين CLI تلقائياً
  3. تخزين بيانات الاعتماد بشكل آمن

تدفق رمز الجهاز (بدون واجهة)​

للخوادم بدون متصفح:

archicore login --device-code

هذا يعرض رمزاً لإدخاله في ArchiCore Device Auth.

تهيئة مشروع​

انتقل إلى دليل مشروعك وقم بتشغيل:

cd /مسار/مشروعك
archicore init

هذا ينشئ دليل .archicore/ مع التكوين الافتراضي.

التحديث​

npm update -g archicore

إلغاء التثبيت​

npm uninstall -g archicore

لإزالة التكوين أيضاً:

rm -rf ~/.archicore

ملاحظات خاصة بالمنصة​

Windows​

استخدم PowerShell أو Git Bash. موجه الأوامر يعمل لكن بميزات محدودة.

# PowerShell
npm install -g archicore

Linux​

قد تحتاج sudo للتثبيت العالمي:

sudo npm install -g archicore

أو قم بتكوين npm لاستخدام دليل محلي:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g archicore

macOS​

npm install -g archicore

إذا حصلت على أخطاء صلاحيات:

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
npm install -g archicore

استكشاف الأخطاء وإصلاحها​

"EACCES: تم رفض الإذن"​

لا تستخدم sudo npm install. بدلاً من ذلك، أصلح صلاحيات npm:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

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

تأكد من أن bin العالمي لـ npm في PATH:

export PATH="$(npm bin -g):$PATH"

أضف إلى ~/.bashrc أو ~/.zshrc لجعله دائماً.

خلف وكيل (Proxy)​

npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
npm install -g archicore