Formations — 1 037 leçons en français

Accueil › Angular › Organiser un monorepo

Organiser un monorepo

Librairies et monoreposavance

Un workspace multi-projets regroupe plusieurs applications et librairies dans un seul angular.json. L'application initiale de ng new reste à la racine ; les projets ajoutés ensuite vivent sous projects/ :

ng generate application boutique
ng generate library acme-ui
ng generate library acme-donnees

Dans ce cas, ng generate library ajoute un chemin TypeScript dans le tsconfig.json racine, pour que boutique importe acme-ui directement depuis les sources du workspace, sans passer par npm à chaque changement local. Cette proximité a un revers : rien n'empêche techniquement une librairie d'importer une autre librairie, dans les deux sens — créant un cycle de dépendances qui rend le projet plus difficile à construire et à raisonner.

À mesure qu'un monorepo grandit (plusieurs applications, plusieurs librairies), tout reconstruire et retester à chaque changement devient coûteux. Le principe à retenir est de ne construire et tester que ce qui a réellement changé, et ce qui en dépend. Angular CLI seul ne fournit pas cet outillage nativement ; c'est ce que des outils tiers comme Nx apportent au-dessus d'un workspace Angular : un graphe de dépendances entre projets, un cache de build/test, et des générateurs de code.

Les termes à connaître

Workspace multi-projets

Un même workspace Angular (angular.json) peut contenir plusieurs projets — applications et librairies — chacun avec sa propre configuration de build, de test et de service. L'application créée par ng new vit à la racine ; les projets ajoutés ensuite (ng generate application, ng generate library) vivent par défaut sous projects/.

Chemin TypeScript (path mapping)

Entrée dans compilerOptions.paths du tsconfig.json racine qui fait correspondre le nom d'une librairie du workspace (ex. acme-ui) à l'emplacement de ses sources ou de son build, pour que les applications du même workspace puissent l'importer sans passer par npm.

Cycle de dépendances entre projets

Situation où le projet A dépend du projet B qui dépend, directement ou indirectement, du projet A. Casse la possibilité de construire ou tester les projets indépendamment, et complique la compréhension du graphe de dépendances.

Monorepo

Un seul dépôt de code source hébergeant plusieurs projets (plusieurs applications, plusieurs librairies) versionnés ensemble, par opposition à un dépôt séparé par projet (polyrepo / multi-dépôts).

Nx

Outil de build tiers, très utilisé pour les monorepos Angular, qui s'ajoute au-dessus d'un workspace pour apporter un graphe de dépendances entre projets, un cache de build/test, et des générateurs de code. Angular CLI seul ne fournit pas ces capacités.

Graphe de dépendances (project graph)

Représentation des dépendances réelles entre projets d'un monorepo (quel projet importe quel autre), utilisée pour déterminer quels projets sont affectés par un changement et dans quel ordre les construire.

Cache de build/test

Mécanisme qui réutilise le résultat d'un build ou d'une exécution de tests déjà effectuée pour un ensemble de fichiers inchangé, plutôt que de le refaire depuis zéro. Angular CLI seul ne propose pas de cache de ce type entre exécutions pour un workspace multi-projets.

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.