Formations — 1 037 leçons en français

Accueil › Angular › Publier et faire évoluer une librairie

Publier et faire évoluer une librairie

Librairies et monoreposavance

Une librairie se publie avec ng build acme-ui (toujours en configuration de production pour la distribution), puis npm publish depuis le dossier de sortie (dist/acme-ui), où se trouve le package.json réellement publié — distinct du package.json racine du workspace.

ng build acme-ui
cd dist/acme-ui
npm publish
# ou, sur un registre privé d'entreprise déjà configuré dans .npmrc :
npm publish --registry https://npm.acme-corp.interne

Le nom du package (@acme-corp/ui) et sa portée déterminent où il atterrit : portée publique npm, ou portée privée d'entreprise. Ce qui compte le plus pour les consommateurs, c'est la discipline de versionnement sémantique : une rupture d'API pour un composant n'est pas seulement « le composant ne marche plus », c'est tout changement qui casse un usage correct existant — un input() renommé, un sélecteur modifié, un type de sortie changé. Avant de retirer quelque chose, on le déprécie (@deprecated avec l'alternative), pour laisser le temps aux consommateurs de migrer. Avant de publier pour de vrai, npm pack permet de vérifier le contenu exact du tarball et de le tester dans une application locale.

Les termes à connaître

Versionnement sémantique (SemVer)

Convention de numérotation MAJEUR.MINEUR.CORRECTIF : un correctif ne change pas l'API, un mineur l'étend sans casser l'existant, un majeur peut introduire des ruptures. Appliquée à une librairie de composants, la question centrale est : « qu'est-ce qui compte comme une rupture d'API pour un composant ? »

Rupture d'API (breaking change)

Pour un composant, tout changement qui casse la compilation ou le comportement d'un consommateur qui utilisait l'API publique correctement : renommer ou retirer une entrée (input()), changer le type d'une sortie, modifier un sélecteur, changer le comportement par défaut d'une option existante.

npm pack

Commande qui construit un tarball .tgz du package tel qu'il serait publié, sans le publier sur le registre. Permet d'inspecter son contenu exact ou de l'installer localement dans une application de test avant publication réelle.

Registre privé / portée d'entreprise

Un package.json publié avec un nom @acme-corp/ui (portée npm) peut être publié sur le registre public npm sous cette portée, ou sur un registre privé d'entreprise (configuré via .npmrc et le champ publishConfig), sans changer la façon dont les consommateurs internes l'installent.

Journal des modifications (changelog)

Fichier CHANGELOG.md qui documente, version par version, ce qui a été ajouté, corrigé ou cassé. Pour une librairie de composants consommée par plusieurs équipes, c'est la référence pour savoir si une mise à jour nécessite une adaptation du code consommateur.

Dépréciation

Signal explicite (commentaire JSDoc @deprecated, avec la raison et l'alternative) qu'une partie de l'API publique sera retirée dans une future version majeure, sans encore casser les consommateurs actuels. Donne le temps de migrer avant la rupture réelle.

Schematic ng-add

Schematic exécuté par ng add nom-librairie, déclaré dans le package.json de la librairie ("ng-add": {...}) et dans sa collection de schematics. Automatise l'installation initiale : ajout de providers dans la configuration de l'application, ajout de styles globaux, etc.

Migration ng update

Schematic déclaré via le champ ng-update du package.json, exécuté par ng update nom-librairie, qui adapte automatiquement le code d'une application lors du passage à une nouvelle version majeure de la librairie (ex. renommage automatique d'un input).

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.