Skip to content

コア

コアとなるasdfのコマンドはかなり少量ですが、多くのワークフローを円滑に進めることができます。

インストール & セットアップ

はじめようのガイドで説明されています。

実行

shell
asdf exec <command> [args...]

現在のバージョンのShimでコマンドを実行します。

環境変数

shell
asdf env <command> [util]

情報

shell
asdf info

OS、シェル、およびasdfのデバッグ情報を表示するヘルパーコマンドです。バグレポート作成時に共有してください。

Shimの再作成

shell
asdf reshim <name> <version>

特定のパッケージ・バージョンのShimを再作成します。デフォルトでは、Shimはプラグインによってツールのインストール中に作成されます。npm CLIなどのツールは、実行ファイルをグローバルインストールができます(例:npm install -g yarnコマンドでYarnをインストール)が、これらの実行ファイルはプラグインのライフサイクルを通してインストールされないため、Shimはまだ存在しません。そのような時に、例えばasdf reshim nodejs <version>を実行すると、nodejs<version>に対して、yarnのような新しい実行ファイルのShimを強制的に再作成させることができます。

Shimのバージョン

shell
asdf shim-versions <command>

<command>のShimを提供するプラグインおよびバージョンを一覧で表示します。

例えば、Node.jsにはnodenpmという2つの実行ファイルが提供されています。asdf-nodejsプラグインで、複数のバージョンのツールがインストールされている場合、shim-versionsは下記のような一覧を返します:

shell
 asdf shim-versions node
nodejs 14.8.0
nodejs 14.17.3
nodejs 16.5.0
shell
 asdf shim-versions npm
nodejs 14.8.0
nodejs 14.17.3
nodejs 16.5.0

更新

asdfには、Git依存のアップデートコマンドが用意されています(推奨されるインストール方法を使用した場合)。別の方法でインストールした場合、その方法の手順に従ってください:

方法最新の安定リリースmasterブランチの最新コミット
asdf (Git経由)asdf updateasdf update --head
Homebrewbrew upgrade asdfbrew upgrade asdf --fetch-HEAD
Pacman新しいPKGBUILDをダウンロードしてリビルド、
または好みのAURヘルパーを使用

アンインストール

asdfをアンインストールするには以下の手順に従ってください:

Bash & Git
  1. ~/.bashrcで、asdf.shおよびコマンド補完をsourceしている行を削除します:
shell
. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"
  1. $HOME/.asdfディレクトリを削除します:
shell
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Git (macOS)
  1. ~/.bash_profileで、asdf.shおよびコマンド補完をsourceしている行を削除します:
shell
. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"
  1. $HOME/.asdfディレクトリを削除します:
shell
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Homebrew
  1. ~/.bashrcで、asdf.shおよびコマンド補完をsourceしている行を削除します:
shell
. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash

コマンド補完については、Homebrewで説明されている方法で設定されている可能性があるため、そちらのガイドに従って削除する行を見つけてください。

  1. パッケージマネージャでアンインストールします:
shell
brew uninstall asdf --force
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Homebrew (macOS)

macOS Catalina以降では、デフォルトのシェルがZSHに変更されました。もし、~/.bash_profileに設定が見つからない場合は、~/.zshrcにある可能性があります。その場合は、ZSHの手順をご覧ください。

  1. ~/.bash_profileで、asdf.shおよびコマンド補完をsourceしている行を削除します:
shell
. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash

コマンド補完については、Homebrewで説明されている方法で設定されている可能性があるため、そちらのガイドに従って削除する行を見つけてください。

  1. パッケージマネージャでアンインストールします:
shell
brew uninstall asdf --force
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Bash & Pacman
  1. ~/.bashrcで、asdf.shおよびコマンド補完をsourceしている行を削除します:
shell
. /opt/asdf-vm/asdf.sh
  1. パッケージマネージャでアンインストールします:
shell
pacman -Rs asdf-vm
  1. $HOME/.asdfディレクトリを削除します:
shell
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Fish & Git
  1. ~/.config/fish/config.fishで、asdf.fishをsourceしている行を削除します:
shell
source ~/.asdf/asdf.fish

そして、次のコマンドで、コマンド補完を削除します:

shell
rm -rf ~/.config/fish/completions/asdf.fish
  1. $HOME/.asdfディレクトリを削除します:
shell
rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Fish & Homebrew
  1. ~/.config/fish/config.fishで、asdf.fishをsourceしている行を削除します:
shell
source "(brew --prefix asdf)"/libexec/asdf.fish
  1. パッケージマネージャでアンインストールします:
shell
brew uninstall asdf --force
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Fish & Pacman
  1. ~/.config/fish/config.fishで、asdf.fishをsourceしている行を削除します:
shell
source /opt/asdf-vm/asdf.fish
  1. パッケージマネージャでアンインストールします:
shell
pacman -Rs asdf-vm
  1. $HOME/.asdfディレクトリを削除します:
shell
rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Elvish & Git
  1. ~/.config/elvish/rc.elvで、asdfモジュールを使用している行を削除します:
shell
use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

そして、次のコマンドで、asdfモジュールを削除します:

shell
rm -f ~/.config/elvish/lib/asdf.elv
  1. $HOME/.asdfディレクトリを削除します:
shell
if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Elvish & Homebrew
  1. ~/.config/elvish/rc.elvで、asdfモジュールを使用している行を削除します:
shell
use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

そして、次のコマンドで、asdfモジュールを削除します:

shell
rm -f ~/.config/elvish/lib/asdf.elv
  1. パッケージマネージャでアンインストールします:
shell
brew uninstall asdf --force
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
Elvish & Pacman
  1. ~/.config/elvish/rc.elvで、asdfモジュールを使用している行を削除します:
shell
use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

そして、次のコマンドで、asdfモジュールを削除します:

shell
rm -f ~/.config/elvish/lib/asdf.elv
  1. パッケージマネージャでアンインストールします:
shell
pacman -Rs asdf-vm
  1. $HOME/.asdfディレクトリを削除します:
shell
if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
ZSH & Git
  1. ~/.zshrcで、asdf.shおよびコマンド補完をsourceしている行を削除します:
shell
. "$HOME/.asdf/asdf.sh"
# ...
fpath=(${ASDF_DIR}/completions $fpath)
autoload -Uz compinit
compinit

または、ZSHフレームワークプラグインを使用します。

  1. $HOME/.asdfディレクトリを削除します:
shell
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
ZSH & Homebrew
  1. ~/.zshrcで、asdf.shをsourceしている行を削除します:
shell
. $(brew --prefix asdf)/libexec/asdf.sh
  1. パッケージマネージャでアンインストールします:
shell
brew uninstall asdf --force && brew autoremove
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"
ZSH & Pacman
  1. ~/.zshrcで、asdf.shをsourceしている行を削除します:
shell
. /opt/asdf-vm/asdf.sh
  1. パッケージマネージャでアンインストールします:
shell
pacman -Rs asdf-vm
  1. $HOME/.asdfディレクトリを削除します:
shell
rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"
  1. asdfのすべての構成ファイルを削除するために次のコマンドを実行します:
shell
rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

たったこれだけです! 🎉