Zum Hauptinhalt springen

Installation

Anforderungen​

  • Node.js 18.0 oder höher
  • npm 8.0 oder höher (kommt mit Node.js)
  • Git (für Versionskontrollfunktionen)

Installation über npm​

npm install -g archicore

Installation überprüfen​

archicore --version
# ArchiCore v0.1.0

Authentifizierung​

Bevor Sie ArchiCore verwenden, müssen Sie sich authentifizieren:

archicore login

Dies wird:

  1. Ihren Browser zur ArchiCore-Anmeldeseite öffnen
  2. Nach der Anmeldung das CLI automatisch konfigurieren
  3. Anmeldedaten sicher speichern

Device Code Flow (Headless)​

Für Server ohne Browser:

archicore login --device-code

Dies zeigt einen Code an, den Sie bei ArchiCore Device Auth eingeben.

Projekt initialisieren​

Navigieren Sie zu Ihrem Projektverzeichnis und führen Sie aus:

cd /pfad/zu/ihrem/projekt
archicore init

Dies erstellt ein .archicore/ Verzeichnis mit Standardkonfiguration.

Aktualisieren​

npm update -g archicore

Deinstallieren​

npm uninstall -g archicore

Um auch die Konfiguration zu entfernen:

rm -rf ~/.archicore

Plattformspezifische Hinweise​

Windows​

Verwenden Sie PowerShell oder Git Bash. Die Eingabeaufforderung funktioniert, hat aber eingeschränkte Funktionen.

# PowerShell
npm install -g archicore

Linux​

Sie benötigen möglicherweise sudo für globale Installation:

sudo npm install -g archicore

Oder konfigurieren Sie npm für ein lokales Verzeichnis:

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

Bei Berechtigungsfehlern:

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

Fehlerbehebung​

"EACCES: Zugriff verweigert"​

Verwenden Sie nicht sudo npm install. Beheben Sie stattdessen die npm-Berechtigungen:

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

"archicore: Befehl nicht gefunden"​

Stellen Sie sicher, dass das globale npm-bin in PATH ist:

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

Fügen Sie es zu ~/.bashrc oder ~/.zshrc hinzu, um es permanent zu machen.

Hinter einem Proxy​

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