Passa al contenuto principale

Installazione

Requisiti​

  • Node.js 18.0 o superiore
  • npm 8.0 o superiore (incluso con Node.js)
  • Git (per funzionalità di controllo versione)

Installare via npm​

npm install -g archicore

Verificare l'Installazione​

archicore --version
# ArchiCore v0.1.0

Autenticazione​

Prima di usare ArchiCore, devi autenticarti:

archicore login

Questo:

  1. Aprirà il browser sulla pagina di login di ArchiCore
  2. Dopo il login, configurerà automaticamente il CLI
  3. Memorizzerà le credenziali in modo sicuro

Flusso Device Code (Headless)​

Per server senza browser:

archicore login --device-code

Questo mostra un codice da inserire su ArchiCore Device Auth.

Inizializzare un Progetto​

Naviga nella directory del tuo progetto ed esegui:

cd /percorso/al/tuo/progetto
archicore init

Questo crea una directory .archicore/ con la configurazione predefinita.

Aggiornare​

npm update -g archicore

Disinstallare​

npm uninstall -g archicore

Per rimuovere anche la configurazione:

rm -rf ~/.archicore

Note Specifiche per Piattaforma​

Windows​

Usa PowerShell o Git Bash. Il Prompt dei comandi funziona ma ha funzionalità limitate.

# PowerShell
npm install -g archicore

Linux​

Potresti aver bisogno di sudo per l'installazione globale:

sudo npm install -g archicore

Oppure configura npm per usare una directory locale:

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

Se ricevi errori di permesso:

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

Risoluzione Problemi​

"EACCES: permesso negato"​

Non usare sudo npm install. Invece, correggi i permessi npm:

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

"archicore: comando non trovato"​

Assicurati che il bin globale npm sia nel PATH:

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

Aggiungi a ~/.bashrc o ~/.zshrc per renderlo permanente.

Dietro un Proxy​

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