# Installation

# Prérequis

  • Vue 2.7 (version finale ; 2.6 et versions antérieures non prises en charge, IE11 non pris en charge)
  • Node 20 + pnpm 10 recommandés

# Installation via un gestionnaire de paquets

npm install @lh-ui/vue2
# ou
pnpm add @lh-ui/vue2
# ou
yarn add @lh-ui/vue2

La seule dépendance à l'exécution de @lh-ui/vue2 est @lh-ui/share (couche partagée : fonctions pures du core / theme / constants / locales / types / source des styles des composants), installé automatiquement.

# Installation depuis un serveur privé

Si le paquet est hébergé sur un serveur privé et non sur le registry public, installez-le de l'une des manières suivantes.

# Méthode 1 : lien direct vers le tarball

Il suffit que le serveur offre un hébergement de fichiers statiques. Déposez le lh-ui-vue2-x.y.z.tgz produit par npm pack dans un répertoire du serveur, puis :

npm install https://votre-domaine/pkg/lh-ui-vue2-1.0.0.tgz
# ou
pnpm add https://votre-domaine/pkg/lh-ui-vue2-1.0.0.tgz
# ou
yarn add https://votre-domaine/pkg/lh-ui-vue2-1.0.0.tgz

Avec le lien direct vers le tarball, @lh-ui/share est toujours résolu depuis le registry courant : vérifiez que ce paquet est visible sur le registry public ou sur votre registry privé.

# Méthode 2 : registry auto-hébergé (par exemple Verdaccio)

Un registry auto-hébergé permet le tirage semver et la gestion des versions. Dans le .npmrc à la racine du projet, routez précisément le scope (la source d'installation des autres paquets n'est pas affectée) :

@lh-ui:registry=https://votre-domaine/

Installez ensuite comme d'habitude :

pnpm add @lh-ui/vue2

# Import manuel des styles

// Variables de thème (clair + sombre)
import '@lh-ui/vue2/theme.css'
// Import individuel des styles d'un composant (facultatif — l'entrée complète les inclut déjà)
import '@lh-ui/vue2/style/button'

# Stratégie de version

  • La mise à jour de @lh-ui/share doit respecter la discipline « release de share d'abord → mise à niveau et régression de la bibliothèque UI → puis release ».
  • État actuel : @lh-ui/vue2 a publié la version 1.0.0, @lh-ui/share est en 0.1.0.

Copyright © 2024-2026 FengMo WenXue