Dropstone Docs

Problemas comuns

Corrija problemas comuns de instalação e execução do Dropstone CLI. Soluções passo a passo para instalações com falha, problemas de autenticação e erros de atualização.

Os problemas mais comuns que os usuários do Dropstone enfrentam, com as etapas para resolvê-los. Para erros de execução e depuração por recurso, consulte a página Solução de problemas da CLI.

A instalação falha no macOS

"Command not found: brew"

Você precisa do Homebrew primeiro. Instale-o uma vez:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

No Apple Silicon, adicione também o Homebrew ao seu PATH:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Em seguida, execute novamente a instalação do Dropstone:

brew tap blankline-org/dropstone-cli
brew install dropstone

"Cannot install: package already exists"

Force a sobrescrita da instalação existente:

brew uninstall dropstone
brew install dropstone

O tap do Homebrew falha ao atualizar

Limpe o cache e refaça o tap:

brew untap blankline-org/dropstone-cli
brew cleanup
brew tap blankline-org/dropstone-cli
brew install dropstone

A instalação falha no Windows

"irm is not recognized as an internal or external command"

Você está no CMD, não no PowerShell. Ou mude para o PowerShell:

irm https://dropstone.io/install.ps1 | iex

Ou use o instalador do CMD:

curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd

"The token '&&' is not a valid statement separator"

Você está no PowerShell tentando executar o comando do CMD. Use o comando do PowerShell acima.

Atualização pendente não foi aplicada

Se dropstone update relatou sucesso, mas dropstone --version ainda mostra a versão antiga, reinicie o terminal. No Windows, o novo binário é trocado no próximo início.

Se isso ainda não ajudar, force a reinstalação:

irm https://dropstone.io/install.ps1 | iex

Autenticação

"Failed to sign in"

  1. Execute dropstone novamente. No primeiro início, ele abre dropstone.io/login para o login baseado em PKCE.
  2. Se o fluxo do navegador falhar, cole um token. Obtenha um em dropstone.io/account e escolha "Paste a token" no prompt de login.

"Session expired"

Execute /login de dentro do Dropstone para atualizar suas credenciais.

Preso na conta errada

Para trocar de conta, execute /login de dentro do Dropstone e escolha a conta correta no prompt do navegador.

Problemas de atualização

dropstone update informa "Update Available" mas não faz nada

Isso geralmente significa que o instalador automático não tem permissão de escrita no diretório do binário. Reinstale usando o método original:

PlataformaComando
macOS (Homebrew)brew upgrade dropstone
macOS / Linux (script)curl -fsSL https://dropstone.io/install | bash
Windows (PowerShell)irm https://dropstone.io/install.ps1 | iex

Preso em uma versão antiga

Verifique o que está instalado:

dropstone --version

Compare com a versão mais recente em download.dropstone.io/latest.txt. Se não corresponderem, reinstale usando o comando da plataforma acima.

Ainda com problemas?

Se nenhuma das opções acima resolveu o seu problema, consulte a página mais detalhada Solução de problemas da CLI, ou abra um chamado em dropstone.io/contact com:

  • Seu sistema operacional e versão
  • A saída de dropstone --version
  • A mensagem de erro completa e o comando exato que você executou
Ctrl+I