Aller au contenu principal

Installation

Prérequis

  • Node.js 18.0 ou supérieur
  • npm 8.0 ou supérieur (fourni avec Node.js)
  • Git (pour les fonctionnalités de contrôle de version)

Installer via npm

npm install -g archicore

Vérifier l'Installation

archicore --version
# ArchiCore v0.1.0

Authentification

Avant d'utiliser ArchiCore, vous devez vous authentifier :

archicore login

Cela va :

  1. Ouvrir votre navigateur sur la page de connexion ArchiCore
  2. Après connexion, configurer automatiquement le CLI
  3. Stocker les identifiants en toute sécurité

Flux de Code d'Appareil (Sans Interface)

Pour les serveurs sans navigateur :

archicore login --device-code

Cela affiche un code à entrer sur ArchiCore Device Auth.

Initialiser un Projet

Naviguez vers le répertoire de votre projet et exécutez :

cd /chemin/vers/votre/projet
archicore init

Cela crée un répertoire .archicore/ avec la configuration par défaut.

Mise à Jour

npm update -g archicore

Désinstallation

npm uninstall -g archicore

Pour également supprimer la configuration :

rm -rf ~/.archicore

Notes Spécifiques aux Plateformes

Windows

Utilisez PowerShell ou Git Bash. L'invite de commandes fonctionne mais a des fonctionnalités limitées.

# PowerShell
npm install -g archicore

Linux

Vous pourriez avoir besoin de sudo pour l'installation globale :

sudo npm install -g archicore

Ou configurez npm pour utiliser un répertoire local :

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g archicore

macOS

npm install -g archicore

Si vous obtenez des erreurs de permission :

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
npm install -g archicore

Dépannage

"EACCES: permission refusée"

N'utilisez pas sudo npm install. Corrigez plutôt les permissions npm :

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

"archicore: commande non trouvée"

Assurez-vous que le bin global npm est dans PATH :

export PATH="$(npm bin -g):$PATH"

Ajoutez à ~/.bashrc ou ~/.zshrc pour le rendre permanent.

Derrière un Proxy

npm config set proxy http://proxy.entreprise.com:8080
npm config set https-proxy http://proxy.entreprise.com:8080
npm install -g archicore