プラグイン
プラグインは、asdfがNode.jsやRuby、Elixirなどの様々なツールを取り扱えるようにするためのものです。
様々なツールをサポートするために使用されるプラグインAPIについては、プラグインの作成をご覧ください。
追加
下記コマンドでは、GitのURLからプラグインを追加します:
shell
asdf plugin add <name> <git-url>
# asdf plugin add elm https://github.com/vic/asdf-elmasdf plugin add <name> <git-url>
# asdf plugin add elm https://github.com/vic/asdf-elmまたは下記のコマンドで、プラグインリポジトリのショートネームを指定して追加します:
shell
asdf plugin add <name>
# asdf plugin add erlangasdf plugin add <name>
# asdf plugin add erlang推奨
リポジトリのショートネームに依存しないために、git-urlを使用することを推奨します。
インストール済みプラグイン一覧
shell
asdf plugin list
# asdf plugin list
# java
# nodejsasdf plugin list
# asdf plugin list
# java
# nodejsshell
asdf plugin list --urls
# asdf plugin list
# java https://github.com/halcyon/asdf-java.git
# nodejs https://github.com/asdf-vm/asdf-nodejs.gitasdf plugin list --urls
# asdf plugin list
# java https://github.com/halcyon/asdf-java.git
# nodejs https://github.com/asdf-vm/asdf-nodejs.git全プラグインのショートネーム一覧
shell
asdf plugin list allasdf plugin list all全プラグインのショートネーム一覧については、プラグインショートネームの一覧もご覧ください。
更新
shell
asdf plugin update --allasdf plugin update --all特定のプラグインパッケージを更新したい場合は、下記のように指定してください。
shell
asdf plugin update <name>
# asdf plugin update erlangasdf plugin update <name>
# asdf plugin update erlangこの更新コマンドは、プラグインリポジトリの origin の デフォルトブランチ における 最新コミット を取得します。バージョニングされたプラグインの更新機能については、現在開発中です(#916)。
削除
bash
asdf plugin remove <name>
# asdf plugin remove erlangasdf plugin remove <name>
# asdf plugin remove erlangプラグインを削除すると、当該プラグインでインストールされたすべてのツールが削除されます。これは、各ツールの未使用バージョンを手っ取り早くクリーンアップ/プルーニングするのに有用です。
ショートネームリポジトリの同期
ショートネームリポジトリはローカルマシンに同期され、定期的に更新されます。同期のタイミングの条件は、次のとおりです:
- 同期イベントは、下記コマンドによってトリガーされます:
asdf plugin add <name>asdf plugin list all
- 構成設定の
disable_plugin_short_name_repositoryオプションがyesの場合、同期は中止されます。詳しくはasdfの構成設定のリファレンスをご覧ください。 - もし、過去
X分の間に同期が行われていない場合、同期が開始されます。Xのデフォルト値は60ですが、.asdfrcファイルのplugin_repository_last_check_durationオプションで変更することができます。詳しくはasdfの構成設定のリファレンスをご覧ください。