コア
コアとなるasdf
のコマンドはかなり少量ですが、多くのワークフローを円滑に進めることができます。
インストール & セットアップ
はじめようのガイドで説明されています。
実行
asdf exec <command> [args...]
現在のバージョンのShimでコマンドを実行します。
環境変数
asdf env <command> [util]
情報
asdf info
OS、シェル、およびasdf
のデバッグ情報を表示するヘルパーコマンドです。バグレポート作成時に共有してください。
Shimの再作成
asdf reshim <name> <version>
特定のパッケージ・バージョンのShimを再作成します。デフォルトでは、Shimはプラグインによってツールのインストール中に作成されます。npm CLIなどのツールは、実行ファイルをグローバルインストールができます(例:npm install -g yarn
コマンドでYarnをインストール)が、これらの実行ファイルはプラグインのライフサイクルを通してインストールされないため、Shimはまだ存在しません。そのような時に、例えばasdf reshim nodejs <version>
を実行すると、nodejs
の<version>
に対して、yarn
のような新しい実行ファイルのShimを強制的に再作成させることができます。
Shimのバージョン
asdf shim-versions <command>
<command>
のShimを提供するプラグインおよびバージョンを一覧で表示します。
例えば、Node.jsにはnode
とnpm
という2つの実行ファイルが提供されています。asdf-nodejs
プラグインで、複数のバージョンのツールがインストールされている場合、shim-versions
は下記のような一覧を返します:
➜ asdf shim-versions node
nodejs 14.8.0
nodejs 14.17.3
nodejs 16.5.0
➜ asdf shim-versions npm
nodejs 14.8.0
nodejs 14.17.3
nodejs 16.5.0
更新
asdf
には、Git依存のアップデートコマンドが用意されています(推奨されるインストール方法を使用した場合)。別の方法でインストールした場合、その方法の手順に従ってください:
方法 | 最新の安定リリース | master ブランチの最新コミット |
---|---|---|
asdf (Git経由) | asdf update | asdf update --head |
Homebrew | brew upgrade asdf | brew upgrade asdf --fetch-HEAD |
Pacman | 新しいPKGBUILD をダウンロードしてリビルド、または好みのAURヘルパーを使用 |
アンインストール
asdf
をアンインストールするには以下の手順に従ってください:
Bash & Git
~/.bashrc
で、asdf.sh
およびコマンド補完をsourceしている行を削除します:
. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"
$HOME/.asdf
ディレクトリを削除します:
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Git (macOS)
~/.bash_profile
で、asdf.sh
およびコマンド補完をsourceしている行を削除します:
. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"
$HOME/.asdf
ディレクトリを削除します:
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Homebrew
~/.bashrc
で、asdf.sh
およびコマンド補完をsourceしている行を削除します:
. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash
コマンド補完については、Homebrewで説明されている方法で設定されている可能性があるため、そちらのガイドに従って削除する行を見つけてください。
- パッケージマネージャでアンインストールします:
brew uninstall asdf --force
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Homebrew (macOS)
macOS Catalina以降では、デフォルトのシェルがZSHに変更されました。もし、~/.bash_profile
に設定が見つからない場合は、~/.zshrc
にある可能性があります。その場合は、ZSHの手順をご覧ください。
~/.bash_profile
で、asdf.sh
およびコマンド補完をsourceしている行を削除します:
. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash
コマンド補完については、Homebrewで説明されている方法で設定されている可能性があるため、そちらのガイドに従って削除する行を見つけてください。
- パッケージマネージャでアンインストールします:
brew uninstall asdf --force
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Pacman
~/.bashrc
で、asdf.sh
およびコマンド補完をsourceしている行を削除します:
. /opt/asdf-vm/asdf.sh
- パッケージマネージャでアンインストールします:
pacman -Rs asdf-vm
$HOME/.asdf
ディレクトリを削除します:
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Fish & Git
~/.config/fish/config.fish
で、asdf.fish
をsourceしている行を削除します:
source ~/.asdf/asdf.fish
そして、次のコマンドで、コマンド補完を削除します:
rm -rf ~/.config/fish/completions/asdf.fish
$HOME/.asdf
ディレクトリを削除します:
rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Fish & Homebrew
~/.config/fish/config.fish
で、asdf.fish
をsourceしている行を削除します:
source "(brew --prefix asdf)"/libexec/asdf.fish
- パッケージマネージャでアンインストールします:
brew uninstall asdf --force
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Fish & Pacman
~/.config/fish/config.fish
で、asdf.fish
をsourceしている行を削除します:
source /opt/asdf-vm/asdf.fish
- パッケージマネージャでアンインストールします:
pacman -Rs asdf-vm
$HOME/.asdf
ディレクトリを削除します:
rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Elvish & Git
~/.config/elvish/rc.elv
で、asdf
モジュールを使用している行を削除します:
use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~
そして、次のコマンドで、asdf
モジュールを削除します:
rm -f ~/.config/elvish/lib/asdf.elv
$HOME/.asdf
ディレクトリを削除します:
if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Elvish & Homebrew
~/.config/elvish/rc.elv
で、asdf
モジュールを使用している行を削除します:
use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~
そして、次のコマンドで、asdf
モジュールを削除します:
rm -f ~/.config/elvish/lib/asdf.elv
- パッケージマネージャでアンインストールします:
brew uninstall asdf --force
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Elvish & Pacman
~/.config/elvish/rc.elv
で、asdf
モジュールを使用している行を削除します:
use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~
そして、次のコマンドで、asdf
モジュールを削除します:
rm -f ~/.config/elvish/lib/asdf.elv
- パッケージマネージャでアンインストールします:
pacman -Rs asdf-vm
$HOME/.asdf
ディレクトリを削除します:
if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
ZSH & Git
~/.zshrc
で、asdf.sh
およびコマンド補完をsourceしている行を削除します:
. "$HOME/.asdf/asdf.sh"
# ...
fpath=(${ASDF_DIR}/completions $fpath)
autoload -Uz compinit
compinit
または、ZSHフレームワークプラグインを使用します。
$HOME/.asdf
ディレクトリを削除します:
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
ZSH & Homebrew
~/.zshrc
で、asdf.sh
をsourceしている行を削除します:
. $(brew --prefix asdf)/libexec/asdf.sh
- パッケージマネージャでアンインストールします:
brew uninstall asdf --force && brew autoremove
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
ZSH & Pacman
~/.zshrc
で、asdf.sh
をsourceしている行を削除します:
. /opt/asdf-vm/asdf.sh
- パッケージマネージャでアンインストールします:
pacman -Rs asdf-vm
$HOME/.asdf
ディレクトリを削除します:
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
asdf
のすべての構成ファイルを削除するために次のコマンドを実行します:
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
たったこれだけです! 🎉