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
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
productionest 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, pasdist/<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.jsonqui remplace un fichier par un autre selon la configuration — typiquementenvironment.tsparenvironment.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.
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.