Accueil › Angular › Le CLI et la structure d'un projet
Le CLI et la structure d'un projet
Démarrer avec Angulardebutant
Le CLI Angular (ng) est l'outil officiel pour créer et faire évoluer un projet. ng new ma-boutique crée un projet complet en posant quelques questions (feuille de style, SSR, tests unitaires...). Le résultat est une application standalone : pas de NgModule racine, tout démarre depuis main.ts.
// main.ts
import { bootstrapApplication } from '@angular/platform-browser';
import { appConfig } from './app/app.config';
import { App } from './app/app';
bootstrapApplication(App, appConfig).catch((err) => console.error(err));
bootstrapApplication prend le composant racine (App) et une configuration qui regroupe tous les providers de l'application : routeur, client HTTP, détection de changements...
// app.config.ts
import { ApplicationConfig, provideZonelessChangeDetection } from '@angular/core';
import { provideRouter } from '@angular/router';
import { provideHttpClient } from '@angular/common/http';
import { routes } from './app.routes';
export const appConfig: ApplicationConfig = {
providers: [
provideZonelessChangeDetection(),
provideRouter(routes),
provideHttpClient(),
],
};
Le fichier angular.json décrit, pour chaque projet du workspace, comment le construire, le servir et le tester. Commandes courantes : ng serve (serveur de développement), ng build (construction de production), ng generate (générer du code). Le builder par défaut, @angular/build:application, s'appuie sur esbuild pour la construction et Vite pour ng serve — rapide, sans configuration à écrire.
Les termes à connaître
- Angular CLI
Outil en ligne de commande officiel (
ng) pour créer, développer, tester et construire un projet Angular. Il s'installe globalement (npm install -g @angular/cli) ou s'utilise vianpx.- ng new
Commande qui crée un nouveau workspace Angular. Elle pose quelques questions interactives (feuille de style, SSR, tests unitaires...) puis génère un projet prêt à l'emploi, standalone par défaut.
- bootstrapApplication
Fonction (
@angular/platform-browser) qui démarre une application standalone à partir d'un composant racine et d'une configuration, sans passer par unNgModuleracine.- app.config.ts / ApplicationConfig
Fichier qui centralise la configuration de l'application : la liste des providers globaux (routeur, client HTTP, détection de changements...). Remplace le rôle que jouait
AppModuleavant l'approche standalone.- angular.json
Fichier de configuration du workspace CLI. Il décrit, pour chaque projet, comment le construire, le servir et le tester (builder utilisé, options, budgets de taille...).
- @angular/build:application
Builder par défaut d'un projet Angular récent : esbuild pour la construction (
ng build), Vite pour le serveur de développement (ng serve). Remplace l'ancien builder basé sur Webpack.- ng generate (ng g)
Commande qui génère du code à partir de schematics : composant, service, directive, pipe, garde de route... Respecte automatiquement les conventions du projet.
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.