Pular para o conteúdo principal

Instalação

Requisitos​

  • Node.js 18.0 ou superior
  • npm 8.0 ou superior (vem com Node.js)
  • Git (para recursos de controle de versão)

Instalar via npm​

npm install -g archicore

Verificar Instalação​

archicore --version
# ArchiCore v0.1.0

Autenticação​

Antes de usar o ArchiCore, você precisa autenticar:

archicore login

Isso irá:

  1. Abrir seu navegador na página de login do ArchiCore
  2. Após o login, configurar automaticamente o CLI
  3. Armazenar credenciais de forma segura

Fluxo de Código de Dispositivo (Headless)​

Para servidores sem navegador:

archicore login --device-code

Isso exibe um código para inserir em ArchiCore Device Auth.

Inicializar um Projeto​

Navegue até o diretório do seu projeto e execute:

cd /caminho/para/seu/projeto
archicore init

Isso cria um diretório .archicore/ com configuração padrão.

Atualizar​

npm update -g archicore

Desinstalar​

npm uninstall -g archicore

Para também remover a configuração:

rm -rf ~/.archicore

Notas Específicas por Plataforma​

Windows​

Use PowerShell ou Git Bash. O Prompt de Comando funciona mas tem recursos limitados.

# PowerShell
npm install -g archicore

Linux​

Você pode precisar de sudo para instalação global:

sudo npm install -g archicore

Ou configure o npm para usar um diretório 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

Se você receber erros de permissão:

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

Solução de Problemas​

"EACCES: permissão negada"​

Não use sudo npm install. Em vez disso, corrija as permissões do npm:

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

"archicore: comando não encontrado"​

Certifique-se de que o bin global do npm está no PATH:

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

Adicione ao ~/.bashrc ou ~/.zshrc para tornar permanente.

Atrás de um Proxy​

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