स्थापना

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 का उपयोग कैसे करें, इसके लिए त्वरित प्रारंभ गाइड देखें।