Angular Academy · Leçon

Publier sur npm

Versionnez et publiez votre bibliothèque

Publier sur npm est une leçon Angular Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Angular Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Angular Academy comprend 4 leçons au total.

Partager votre bibliothèque avec le monde entier

Une fois compilée au format Angular Package Format, une bibliothèque est publiée dans un registre, généralement npm, afin que tout projet puisse l’installer avec npm install. Cette leçon présente le versionnage et le processus de publication.

Publier la sortie dist, pas le code source

Vous publiez le paquet compilé dans dist/<lib>, qui contient le package.json généré et les paquets compilés, jamais le projet source brut. C’est la compilation qui le rend utilisable.

ng build ui-kit --configuration production
cd dist/ui-kit

Versionnage sémantique

Les paquets npm utilisent le versionnage sémantique : MAJOR.MINOR.PATCH. Incrémentez PATCH pour les corrections, MINOR pour les fonctionnalités compatibles avec les versions précédentes et MAJOR pour les modifications incompatibles. Les utilisateurs s’appuient sur ce système pour mettre à niveau leurs dépendances en toute sécurité.

0.0.1 -> 0.1.0   # new feature, no breaks (minor)
0.1.0 -> 0.1.1   # bug fix (patch)
0.1.1 -> 1.0.0   # breaking change (major)

Définir la version

La version provient du package.json propre à la bibliothèque. Mettez-la à jour avant la compilation ou utilisez npm version pour l’incrémenter de manière cohérente.

# inside projects/ui-kit (or use the field directly)
npm version minor   # bumps and tags the version

Se connecter à npm

Authentifiez-vous auprès du registre avant la publication. npm login enregistre un jeton afin d’autoriser la commande de publication.

npm login
# enter username, password / token, email

Publier

Depuis le dossier du paquet compilé, exécutez npm publish. npm téléverse le paquet et le rend installable avec son nom et sa version.

cd dist/ui-kit
npm publish

Paquets à portée

Les paquets d’organisation utilisent une portée comme @myorg/ui-kit. Sur npm, les paquets à portée sont privés par défaut ; transmettez --access public pour les publier publiquement.

npm publish --access public

Installer la bibliothèque publiée

Les utilisateurs l’ajoutent ensuite comme n’importe quelle dépendance et l’importent depuis son API publique. Angular trouve le paquet FESM et les types grâce au package.json généré.

npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';

Préversions et balises

Publiez les versions instables avec une balise de distribution comme next afin qu’elles ne deviennent pas la version par défaut latest. Les utilisateurs choisissent explicitement de les utiliser.

npm publish --tag next
npm install ui-kit@next

Registres privés

Pour les bibliothèques réservées à un usage interne, publiez-les dans un registre privé (paquets privés npm, GitHub Packages ou Verdaccio) en configurant .npmrc. Le processus de publication reste identique : seuls l’URL du registre et l’authentification changent.

Automatiser dans l’intégration continue

Les équipes matures publient depuis l’intégration continue lors d’une version balisée : le pipeline compile la bibliothèque, exécute les tests et lance npm publish avec un jeton enregistré. Cela évite les erreurs manuelles et permet de relier les versions aux validations.

Vérification rapide

Que publiez-vous sur npm ?

Récapitulatif

Publiez la sortie compilée dist/<lib>, versionnée avec le versionnage sémantique. Incrémentez la version, exécutez npm login, puis npm publish (ajoutez --access public pour les paquets à portée et --tag next pour les préversions). Les utilisateurs exécutent npm install et importent depuis l’API publique. Automatisez la publication dans l’intégration continue pour plus de fiabilité.

Questions Fréquemment Posées

La leçon « Publier sur npm » est-elle gratuite ?

Oui — le texte complet de « Publier sur npm » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Angular Academy, passe à CoddyKit PRO. Le cours Angular Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Publier sur npm » ?

Versionnez et publiez votre bibliothèque Tu pratiques Angular Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Angular Academy ?

Aucune expérience préalable n'est requise. Angular Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Publier sur npm » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Angular Academy ?

Oui. Chaque leçon Angular Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Angular Academy