ইনস্টলেশন

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 বাইনারি ফাইল ধারণকারী মিরর সাইট পরিবর্তন করতে পারেন:

মিরর সোর্স সেট করুন

# টাওবাও মিরর ব্যবহার করুন

#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 কীভাবে ব্যবহার করবেন তা জানতে।