Alfresco - Installer l'environnement de développement ADF

Outils requis pour l'environnement de développement

  1. Un éditeur TypeScript
  2. NodeJS - la dernière version LTS
  3. Un navigateur Web récent (et supporté)
  4. Une instance Alfresco Content Services et/ou une instance Alfresco Process Services
  5. Docker (ou Docker Desktop) pour exécuter les instances Alfresco

Installer l'éditeur TypeScript

  • Tous les développements Angular sont réalisés à l'aide du langage TypeScript. Il est fortement recommandé d'utiliser un bon éditeur de texte pour réaliser cette tâche.
  • Je recommandes l'utilisation de l'éditeur Visual Studio Code, un outil gratuit, léger et très puissant de Microsoft. Il dispose d'un vaste écosystème d'extensions pour encore améliorer l'expérience de développement.
  • Autres éditeurs : VSCodium, Atom, Brackets, Notepad++, Eclipse, WebStorm

Pour télécharger et installer Visual Studio Code, cliquez sur le lien suivant : https://code.visualstudio.com/Download

Installer NodeJS

La dernière version LTS de NodeJS doit être installée.

NodeJS peut être téléchargé à partir du lien suivant : https://nodejs.org/fr/download

Je recommandes d'installer NodeJS à l'aide de NVM (Node Version Management) qui permet d'avoir plusieurs versions de NodeJS.

Instructions pour Linux et MacOS:

1. Télécharger et installer NVM

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

2. Ajouter les lignes suivantes au fichier ~/.zshenv

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

3. Au lieu de redémarrer une console de commande:

\. "$HOME/.nvm/nvm.sh"

4. Télécharger et installer NodeJS

nvm install 22

5. Vérifier la version NodeJS et la version NPM

node -v # should return "v22.21.1"
npm -v # should return "10.9.4"

Installer Angular CLI

Angular CLI est un outil en ligne de commande qui vous permet de générer la structure, de développer, de tester, de déployer et de maintenir des applications Angular directement depuis un interpréteur de commandes.

Pour installer Angular CLI :

npm install -g @angular/cli

Notes :

  • Sur les ordinateurs clients Windows, l'exécution des scripts PowerShell est désactivée par défaut ; la commande ci-dessus risque donc de provoquer une erreur. Pour autoriser l'exécution des scripts PowerShell - ce qui est nécessaire pour les binaires npm installés globalement -, vous devez définir la stratégie d'exécution suivante :
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
  • Sur certains environnements de type Unix, les scripts globaux peuvent appartenir à l'utilisateur root ; la commande ci-dessus risque donc d'échouer en raison d'une erreur de permission. Utilisez `sudo` pour exécuter la commande en tant qu'utilisateur root et saisissez votre mot de passe lorsque vous y êtes invité :
sudo npm install -g @angular/cli

Installer NX

Nx est une plateforme de build puissante, open source et agnostique vis-à-vis des technologies, conçue pour gérer efficacement des bases de code de toute envergure. Qu'il s'agisse de petits projets isolés ou de vastes monorepos d'entreprise, Nx offre la plateforme idéale pour passer efficacement du développement d'une fonctionnalité dans votre éditeur à une pull request validée (au statut « vert »).

Pour installer NX :

npm install -g nx

Créer un nouvel espace de travail

# Créer l'espace de travail NX

npx create-nx-workspace

Et répondre aux questions suivantes:
- Where would you like to create your workspace? Saisir le nom de votre espace de travail
- Which stack do you want to use? Sélectionner « None »
- Would you like to use Prettier for code formatting? Sélectionner « No »
- Which AI agents, if any, would you like to set up? Ne pas sélectionner d'agent AI (faire cela plus tard)
- Which CI provider would you like to use? Sélectionner « Do it later » (skip)
- Would you like remote caching to make your build faster? Sélectionner « No »

# Installer les dépendances

cd <votre espace de travail NX>
npm install

# Installer ADF Generators

nx add @alfresco/adf-generators