asdf/assets/ja-jp_manage_plugins.md.Cbru-sBo.lean.js

import{_ as a,c as i,a2 as l,o as e}from"./chunks/framework.C9NVOr0y.js";const g=JSON.parse('{"title":"プラグイン","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/manage/plugins.md","filePath":"ja-jp/manage/plugins.md","lastUpdated":1704890757000}'),t={name:"ja-jp/manage/plugins.md"};function n(h,s,p,d,k,r){return e(),i("div",null,s[0]||(s[0]=[l(`<h1 id="プラグイン" tabindex="-1">プラグイン <a class="header-anchor" href="#プラグイン" aria-label="Permalink to &quot;プラグイン&quot;">​</a></h1><p>プラグインは、<code>asdf</code>がNode.jsやRuby、Elixirなどの様々なツールを取り扱えるようにするためのものです。</p><p>様々なツールをサポートするために使用されるプラグインAPIについては、<a href="/ja-jp/plugins/create.html">プラグインの作成</a>をご覧ください。</p><h2 id="追加" tabindex="-1">追加 <a class="header-anchor" href="#追加" aria-label="Permalink to &quot;追加&quot;">​</a></h2><p>下記コマンドでは、GitのURLからプラグインを追加します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">git-ur</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">l</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add elm https://github.com/vic/asdf-elm</span></span></code></pre></div><p>または下記のコマンドで、プラグインリポジトリのショートネームを指定して追加します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add erlang</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">推奨</p><p>リポジトリのショートネームに依存しないために、<code>git-url</code>を使用することを推奨します。</p></div><h2 id="インストール済みプラグイン一覧" tabindex="-1">インストール済みプラグイン一覧 <a class="header-anchor" href="#インストール済みプラグイン一覧" aria-label="Permalink to &quot;インストール済みプラグイン一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs</span></span></code></pre></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --urls</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java            https://github.com/halcyon/asdf-java.git</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          https://github.com/asdf-vm/asdf-nodejs.git</span></span></code></pre></div><h2 id="全プラグインのショートネーム一覧" tabindex="-1">全プラグインのショートネーム一覧 <a class="header-anchor" href="#全プラグインのショートネーム一覧" aria-label="Permalink to &quot;全プラグインのショートネーム一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span></span></code></pre></div><p>全プラグインのショートネーム一覧については、<a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer">プラグインショートネームの一覧</a>もご覧ください。</p><h2 id="更新" tabindex="-1">更新 <a class="header-anchor" href="#更新" aria-label="Permalink to &quot;更新&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --all</span></span></code></pre></div><p>特定のプラグインパッケージを更新したい場合は、下記のように指定してください。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin update erlang</span></span></code></pre></div><p>この更新コマンドは、プラグインリポジトリの <em>origin</em> の <em>デフォルトブランチ</em> における <em>最新コミット</em> を取得します。バージョニングされたプラグインの更新機能については、現在開発中です(<a href="https://github.com/asdf-vm/asdf/pull/916" target="_blank" rel="noreferrer">#916</a>)。</p><h2 id="削除" tabindex="-1">削除 <a class="header-anchor" href="#削除" aria-label="Permalink to &quot;削除&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> remove</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin remove erlang</span></span></code></pre></div><p>プラグインを削除すると、当該プラグインでインストールされたすべてのツールが削除されます。これは、各ツールの未使用バージョンを手っ取り早くクリーンアップ/プルーニングするのに有用です。</p><h2 id="ショートネームリポジトリの同期" tabindex="-1">ショートネームリポジトリの同期 <a class="header-anchor" href="#ショートネームリポジトリの同期" aria-label="Permalink to &quot;ショートネームリポジトリの同期&quot;">​</a></h2><p>ショートネームリポジトリはローカルマシンに同期され、定期的に更新されます。同期のタイミングの条件は、次のとおりです:</p><ul><li>同期イベントは、下記コマンドによってトリガーされます: <ul><li><code>asdf plugin add &lt;name&gt;</code></li><li><code>asdf plugin list all</code></li></ul></li><li>構成設定の<code>disable_plugin_short_name_repository</code>オプションが<code>yes</code>の場合、同期は中止されます。詳しくは<a href="/ja-jp/manage/configuration.html">asdfの構成設定</a>のリファレンスをご覧ください。</li><li>もし、過去<code>X</code>分の間に同期が行われていない場合、同期が開始されます。 <ul><li><code>X</code>のデフォルト値は<code>60</code>ですが、<code>.asdfrc</code>ファイルの<code>plugin_repository_last_check_duration</code>オプションで変更することができます。詳しくは<a href="/ja-jp/manage/configuration.html">asdfの構成設定</a>のリファレンスをご覧ください。</li></ul></li></ul>`,26)]))}const c=a(t,[["render",n]]);export{g as __pageData,c as default};