التثبيت

Sharp هي مكتبة معالجة صور عالية الأداء لـ Node.js، تدعم تنسيقات صور متعددة وعمليات.

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

• Node.js: الإصدار 18.0.0 أو أحدث
• المنصة: Windows, macOS, Linux
• البنية: x64, ARM64

طرق التثبيت

استخدام npm

npm install sharp

استخدام pnpm

pnpm add sharp

استخدام yarn

yarn add sharp

الملفات الثنائية المسبقة التجميع

سيقوم Sharp تلقائيًا بتنزيل الملفات الثنائية المسبقة التجميع المناسبة لمنصتك. إذا فشل التنزيل أثناء التثبيت، يمكنك اختيار تغيير موقع المرآة الذي يحتوي على الملفات الثنائية لـ sharp و libvips:

تعيين موقع المرآة

# استخدام مرآة Taobao

#pnpm
pnpm config set sharp_binary_host "https://npmmirror.com/mirrors/sharp"
pnpm config set sharp_libvips_binary_host "https://npmmirror.com/mirrors/sharp-libvips"

#npm
npm config set sharp_binary_host "https://npmmirror.com/mirrors/sharp"
npm config set sharp_libvips_binary_host "https://npmmirror.com/mirrors/sharp-libvips"

# أو استخدام مرآة GitHub
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

التثبيت اليدوي

إذا فشل التثبيت التلقائي، يمكنك التثبيت يدويًا:

# مسح التخزين المؤقت
npm cache clean --force

# إعادة التثبيت
npm install sharp --ignore-scripts=false

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

إنشاء ملف اختبار للتحقق من التثبيت:

// test-sharp.js
import sharp from 'sharp';

console.log('إصدار Sharp:', sharp.versions.sharp);
console.log('إصدار libvips:', sharp.versions.vips);

// اختبار الوظيفة الأساسية
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('تم تثبيت Sharp بنجاح!');
  })
  .catch((err) => {
    console.error('فشل تثبيت Sharp:', err);
  });

المشاكل الشائعة

فشل التثبيت

إذا واجهت مشاكل في التثبيت، يرجى المحاولة:

1. تحديث Node.js: تأكد من استخدام أحدث إصدار
2. مسح التخزين المؤقت: npm cache clean --force
3. حذف node_modules: احذف وأعد التثبيت
4. التحقق من الشبكة: تأكد من إمكانية الوصول إلى مستودع npm

مشاكل خاصة بالمنصة

Windows

• تأكد من تثبيت Visual Studio Build Tools
• إذا كنت تستخدم WSL، تأكد من التثبيت في بيئة Linux

macOS

• تأكد من تثبيت Xcode Command Line Tools
• إذا كنت تستخدم شريحة M1/M2، تأكد من استخدام إصدار ARM64

Linux

• تثبيت أدوات التطوير الضرورية: sudo apt-get install build-essential
• بالنسبة لـ Alpine Linux: apk add --no-cache vips-dev

بيئة التطوير

دعم TypeScript

يحتوي Sharp على تعريفات TypeScript كاملة:

npm install --save-dev @types/node

أدوات التطوير

يُنصح باستخدام الأدوات التالية للتطوير:

• VS Code: دعم ممتاز لـ TypeScript
• ESLint: فحص جودة الكود
• Prettier: تنسيق الكود

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

بعد التثبيت، راجع دليل البدء السريع لمعرفة كيفية استخدام Sharp.