Installation

Sharp est une bibliothèque de traitement d'image haute performance pour Node.js, supportant de nombreux formats d'image et opérations.

Exigences système

• Node.js: Version 18.0.0 ou supérieure
• Plateforme: Windows, macOS, Linux
• Architecture: x64, ARM64

Méthodes d'installation

Utiliser npm

npm install sharp

Utiliser pnpm

pnpm add sharp

Utiliser yarn

yarn add sharp

Binaires pré-compilés

Sharp télécharge automatiquement les binaires pré-compilés adaptés à votre plateforme. Si le téléchargement d'installation échoue, vous pouvez choisir de modifier le site miroir contenant les binaires sharp et libvips :

Configurer la source miroir

# Utiliser le miroir 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"

# Ou utiliser le miroir GitHub
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

Installation manuelle

Si l'installation automatique échoue, vous pouvez installer manuellement :

# Nettoyer le cache
npm cache clean --force

# Réinstaller
npm install sharp --ignore-scripts=false

Vérifier l'installation

Créez un fichier de test pour vérifier l'installation :

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

console.log('Version Sharp:', sharp.versions.sharp);
console.log('Version libvips:', sharp.versions.vips);

// Tester la fonctionnalité de base
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('Sharp installé avec succès !');
  })
  .catch((err) => {
    console.error('Échec de l'installation de Sharp:', err);
  });

Problèmes courants

Échec d'installation

Si vous rencontrez des problèmes d'installation, essayez :

1. Mettre à jour Node.js: Assurez-vous d'utiliser la dernière version
2. Nettoyer le cache: npm cache clean --force
3. Supprimer node_modules: Supprimez et réinstallez
4. Vérifier le réseau: Assurez-vous d'avoir accès au registre npm

Problèmes spécifiques à la plateforme

Windows

• Assurez-vous d'avoir installé Visual Studio Build Tools
• Si vous utilisez WSL, assurez-vous d'installer dans l'environnement Linux

macOS

• Assurez-vous d'avoir installé Xcode Command Line Tools
• Si vous utilisez une puce M1/M2, assurez-vous d'utiliser la version ARM64

Linux

• Installer les outils de développement nécessaires : sudo apt-get install build-essential
• Pour Alpine Linux : apk add --no-cache vips-dev

Environnement de développement

Support TypeScript

Sharp inclut des définitions TypeScript complètes :

npm install --save-dev @types/node

Outils de développement

Il est recommandé d'utiliser les outils suivants pour le développement :

• VS Code: Excellent support TypeScript
• ESLint: Vérification de la qualité du code
• Prettier: Formatage du code

Prochaines étapes

Une fois l'installation terminée, consultez le Guide de démarrage rapide pour apprendre à utiliser Sharp.