Formations — 1 037 leçons en français

Accueil › Déploiement & mise en production › Étape 1 — Du projet au dossier livrable

Étape 1 — Du projet au dossier livrable

Mettre en ligne une application Angulardebutant

La mise en ligne commence par un dossier. Une commande suffit à le produire.

ng build
Votre projet src/app/… package.json angular.json ng build compile le TypeScript élague le code mort minifie et empreinte browser/ index.html main-A7F3C2.js styles-9B21E0.css une commande un dossier Rien ne s'exécute côté serveur : le résultat est un ensemble de fichiers, servis tels quels.

Le résultat se trouve dans dist/<projet>/browser/ — depuis Angular 17, pas un niveau au-dessus. Publier dist/<projet>/ donne une page blanche sans message.

Deux réglages à poser avant la première mise en ligne.

La configuration de production, dans environment.prod.ts : URL de l'API, indicateurs de fonctionnalités. Jamais de secret — un front s'exécute chez l'utilisateur, tout ce qu'il contient est lisible.

Un budget, pour que le bundle ne double pas sans que personne ne s'en aperçoive :

"budgets": [
  { "type": "initial", "maximumWarning": "600kB", "maximumError": "900kB" }
]

Et la vérification qui épargne la mauvaise surprise : servir le dossier produit, pas ng serve.

npx http-server dist/boutique/browser -p 4200

Les termes à connaître

ng build

Commande qui compile l'application pour la production : TypeScript transpilé, modèles compilés, code mort retiré, fichiers minifiés et nommés avec une empreinte. Sans option, la configuration production est utilisée depuis Angular 12.

Dossier `browser`

Depuis Angular 17, le build range le résultat dans dist/<projet>/browser/. C'est ce dossier-là qu'on publie, pas dist/<projet>/ — l'erreur donne une page blanche sans message.

Élagage (tree shaking)

Suppression du code jamais atteint. Une bibliothèque importée mais inutilisée disparaît du bundle — à condition d'importer précisément, pas le paquet entier.

Budget

Seuil de taille déclaré dans angular.json. Dépassé, le build émet un avertissement ou échoue. C'est le seul garde-fou automatique contre un bundle qui double sans que personne ne le remarque.

fileReplacements

Mécanisme d'angular.json qui remplace un fichier par un autre selon la configuration — typiquement environment.ts par environment.prod.ts. Le remplacement a lieu au build : la valeur est figée dans le bundle.

Source map

Fichier qui relie le code minifié au code source, pour lire une pile d'appels lisible. Utile à la supervision, mais à ne pas publier tel quel : il expose l'intégralité du code source.

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.