よくある問題
Dropstone CLIのインストールおよび実行時によくある問題を修正します。インストール失敗、認証問題、更新エラーのステップバイステップの解決策。
Dropstoneユーザーが遭遇する最も一般的な問題と、その修正手順です。実行時エラーや機能別のデバッグについては、CLIトラブルシューティングページを参照してください。
macOSでのインストール失敗
「Command not found: brew」
まずHomebrewが必要です。一度だけインストールしてください:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Apple Siliconの場合、HomebrewをPATHに追加します:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
その後、Dropstoneのインストールを再実行します:
brew tap blankline-org/dropstone-cli
brew install dropstone
「Cannot install: package already exists」
既存のインストールを強制的に上書きします:
brew uninstall dropstone
brew install dropstone
Homebrewタップの更新に失敗
キャッシュをクリアして再タップします:
brew untap blankline-org/dropstone-cli
brew cleanup
brew tap blankline-org/dropstone-cli
brew install dropstone
Windowsでのインストール失敗
「irm is not recognized as an internal or external command」
CMDではなくPowerShellを使用しています。PowerShellに切り替えるか:
irm https://dropstone.io/install.ps1 | iex
またはCMDインストーラーを使用します:
curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd
「The token '&&' is not a valid statement separator」
PowerShellでCMDコマンドを実行しようとしています。上記のPowerShellコマンドに切り替えてください。
保留中の更新が適用されない
dropstone updateが成功を報告したのにdropstone --versionがまだ古いバージョンを示す場合、ターミナルを再起動してください。Windowsでは次回起動時に新しいバイナリが適用されます。
それでも解決しない場合は、強制再インストールを実行します:
irm https://dropstone.io/install.ps1 | iex
認証
「Failed to sign in」
dropstoneを再度実行します。初回起動時にはPKCEベースのサインインのためにdropstone.io/loginが開きます。- ブラウザフローが失敗した場合は、代わりにトークンを貼り付けます。dropstone.io/accountでトークンを取得し、サインインプロンプトで「Paste a token」を選択します。
「Session expired」
Dropstone内から/loginを実行して認証情報を更新します。
間違ったアカウントでログインしている
アカウントを切り替えるには、Dropstone内から/loginを実行し、ブラウザのプロンプトで正しいアカウントを選択します。
更新の問題
dropstone updateが「Update Available」と表示するが何もしない
これは通常、自動インストーラーがバイナリのディレクトリへの書き込み権限を持っていないことを意味します。元の方法で再インストールしてください:
| プラットフォーム | コマンド |
|---|---|
| macOS(Homebrew) | brew upgrade dropstone |
| macOS / Linux(スクリプト) | curl -fsSL https://dropstone.io/install | bash |
| Windows(PowerShell) | irm https://dropstone.io/install.ps1 | iex |
古いバージョンのまま
インストールされているものを確認します:
dropstone --version
download.dropstone.io/latest.txtの最新版と比較します。一致しない場合は、上記のプラットフォームコマンドで再インストールしてください。
まだ問題が解決しない場合?
上記のいずれでも問題が解決しない場合は、より詳細なCLIトラブルシューティングページを参照するか、dropstone.io/contactで以下の情報を含めて問題を報告してください:
- OSとバージョン
dropstone --versionの出力- 完全なエラーメッセージと実行した正確なコマンド