asdfはなぜ動くのか。asdfの詳細とShimによるバージョン切り替えの仕組みを読み解く。

この記事ではマルチランタイムバージョン管理ツール「asdf」の仕組みを読み解いていきます。

私自身あまり理解していない状態から徐々に読み解いていきますので、途中で理解が間違っている事があるかと思います。

その点はご容赦ください。


なお、asdfのインストールと設定については以下で解説しています。

まずは触れてみたいという方は以下をご覧ください。

https://blog.yukiapps.com/2025/03/asdf-mac.html


それでは参りましょう。


asdfの構成

構成は以下のようになります。

図にするとこんな感じでしょうか。









「asdfコア」「プラグイン」「Shim」が重要なキーワードになりそうです。

まずは「Shim」とは何かについて解説した後に、一つずつ深掘りしていきます。


Shimとは何か

「shim（シム）」とは英語で、クサビ上の木材など部品の隙間や割れ目を埋める物の事です。


プログラミングの分野においては、プログラムの間に挟まる薄いレイヤー（ラッパーようなもの）を指します。

asdfにおいては、実行ファイルの前にShimを挟むことでバージョンを管理しています。

Shimとはラッパーのようなものと覚えておいて良いかと思います。

Wikipediaを参考：https://en.wikipedia.org/wiki/Shim_(computing)


Shimの概念を理解したところで、asdfの各コンポーネントについて深堀りしていきます。


asdfコアの主な役割

asdfコアの主な役割は以下のようになります。
  • 設定ファイル（.tool-versions）読み取る
  • プラグインをインストールする
  • .tool-versionsとプラグインを参照してShimを生成
  • インストール済みの実行ファイルを元にShimを生成
asdfコアの役割として、プラグインを管理するだけでなくShimの生成もあるようです。

Shimについては
「shimが実行される」ではなく、
「shimを介して実行ファイルが実行される」が正しそうです。

図を修正すると以下のような感じでしょうか。











次にプラグインについて見ていきます。


asdfのプラグインの主な役割

プラグインの役割は以下のようになります。
  • asdfコアに任意のツールを操作する機能を提供する
    • インストール
    • インストール可能なバージョンの表示
    • 最新安定バージョンの表示 等
プラグイン自体はasdfコアに機能を提供するものであり、実際に実行するのはコアの役割のようです。
また、プラグインはShimの生成には関わらないようです。

図を修正します。











asdfのプラグインの作成

プラグインは公式のものを使うか、自分で作ることもできます。
自分で作る際は、asdfが提供するテンプレートを使います。
テンプレートを対話的に更新していくスクリプトも用意されています。

詳しくは公式サイトを参照。

asdfのShimの主な役割

Shimの役割は以下です。
  • asdfコアを介して指定されたコマンドを実行する

つまり、adfによって管理されているコマンドを実行する際、まずはShimが呼び出されます。

Shimはasdfコマンドが記述されたシンプルなbashスクリプトです。


生成と実行時に分けて図を作り直します。

インストールと設定時の流れは以下のようになります。









実際にコマンドを実行する際は以下のようになります。









asdfの初期設定で環境変数の$PATHを修正しているため、コマンドはまずはShimがあるか探しにいきます。

Shimがあればそこからasdfコアが呼び出され、asdfが管理しているコマンドが実行されるという流れです。


asdfのバージョン切り替えの仕組みがなんとなく理解できました。

今回はここまでにしようと思います。


次はソースコードを読んで実装を詳しく見てみたいですね。

何かの参考になれば幸いです😃

コメント

コメントを投稿

このブログの人気の投稿

Unreal Engineでマウスカーソルを表示させる方法を解説

イメージ
Unreal Engineでマウスカーソルを表示させる方法について解説します。 Unreal Engineではどうも初期状態ではゲーム画面でマウスカーソルを表示しないようです。 一般的なゲームではマウスカーソルを表示していないことも多いのでそうなっているとかどこかで見た気がします。 スマホ向けのゲームを作っていてタッチ操作のシミュレーションのためにマウスを使いたく、マウスカーソルを表示させる方法を調べたので解説します。 ステップ１：Get Player Controllerノードを配置する まず操作キャラクターのアクタのBlueprintを開きます。 イベントグラフ内で右クリックして、「Get Player Controller」ノードを配置します。 「Get Player Controller」で取得したPlayer Controllerをマウスカーソルを表示させる操作に利用します。 ステップ２：Show Mouse Cursorノードを配置する 「Get Player Controller」のReturn Valueのピンから線を伸ばして、「Show Mouse Cursor」ノードを検索して配置します。 何もないところで右クリックして、「状況に合わせて表示」にチェックが入った状態で「Show Mouse Cursor」を探しても検索結果の候補に出てこないので注意しましょう。 ステップ３：Show Mouse Cursorノードの「Show Mouse Cursor」のチェックボックスをONにする。 Show Mouse Cursorノードの「Show Mouse Cursor」のチェックボックスをチェックしてONにしましょう。 ステップ４：Show Mouse Cursorノードを「Event BeginPlay」などに接続する 最後にShow Mouse Cursorノードを「Event BeginPlay」などのノードから繋げて実行されるようにします。 これでマウスカーソルが表示されるようになります。 以上、Unreal Engineでマウスカーソルを表示させる方法を解説しました。 ChatGPTに聞いたら「設定から変更する」と嘘をつかてしまい調べるのに時間がかかりました。 Unreal Engineに関する情報はChatGPTさんもまだ詳しくないかもしれ...
続きを読む

Unreal Engineでアクタとの当たり判定を行う（Event ActorBeginOverlapイベントを追加する）方法について解説

イメージ
 Unreal Engineでアクタとの当たり判定を行う方法について解説します。 当たり判定の検出にはいくつか方法がありますが、この記事ではEvent ActorBeginOverlapというイベントを追加して当たり判定を検出する方法について説明します。 Event ActorBeginOverlapイベントとは？ Event ActorBeginOverlapとは、「アクタに対して他のアクタが重なったことを検出すると動き出すイベント」のことです。 特定のエリアに入ったことを検知したり、アクタ同士が重なったことを検知して何かをさせたい時に使います。 次にEvent ActorBeginOverlapをBlueprintで使う方法を解説していきます。 ステップ１：アクタの追加 まず、新しいブループリントアクタを作成します。 コンテンツブラウザで右クリックし、「新規作成」→「ブループリントクラス」を選択します。 「アクタ」をベースクラスとして選択し、新しいブループリントを作成します。 ステップ2: コリジョンコンポーネントの追加 次に、アクタにコリジョンコンポーネントを追加します。 作成したブループリントアクタをダブルクリックして開きます。 左側の「コンポーネント」タブで「追加」をクリックし、「Box Collision」を検索してBox Collisionを選択して追加します。 追加したBox Collisionコンポーネントを選択し、Unreal Engineの画面の右側の「詳細」タブで「Generate Overlap Events」の設定を検索して、有効になっていることを確認します。 「Generate Overlap Events」にチェックが入っていなかったら、チェックを入れておきましょう。 ステップ３：Event ActorBeginOverlapノードを追加する 次にアクタのイベントグラフを開きます。 イベントグラフ内で右クリックをして「Event ActorBeginOverlap」を検索し、Event ActorBeginOverlapノードを追加します。 この追加したイベントノードに処理をつなげていくことで、他のアクタと重なった時の処理を実装することができます。 ステップ４：Event ActorBeginOverlapノードに処理を追加す...
続きを読む

Unreal EngineのBlueprintでアセットを読み込んでレベルに配置する方法

イメージ
Unreal Engine(アンリアルエンジン)を使用して、ゲーム開発を行う際、あらかじべレベルにアクター（オブジェクト）を配置する以外に、ゲームの進行に応じて動的にアクターを配置したい時も多いです。 今回は、Blueprint（ブループリント）を使ってアセットを読み込み、レベルに配置する基本的な手順を解説します。 この記事ではUnreal Engine5.4.1を使って解説します。 ステップ1: アセットの準備 まずはじめに、使用したいアセットを用意します。 アセットは、テクスチャ、タイルマップ、サウンドファイルなど、ゲームに使用する各種リソースを指します。 今回は例として、「コンテンツブラウザで右クリック→Paper 2D→スプライト」と選択してスプライトを作成し、適当なテクスチャを貼ってファイル名に「S_Sample」と名前をつけておきます。 この部分は自分が配置したいアセットに読み替えてください。 ステップ2: Blueprintの作成 新しいBlueprintを作成します。 「コンテンツブラウザで右クリック→ブループリントクラス」を選択。 次に、blueprintクラスの親クラスの選択で「アクタ」を選択します。 「アクタ」を最も基本的なクラスで、レベルに配置できるという以外は特徴のないクラスです。 今回は「アセットをレベルに配置する」というテストをするだけなので、「アクタ」で十分という事になります。 新しく作ったBlueprintに「BP_Add_Component_Sample」と名前をつけておきます。 名前は何でも良いですが、他と区別できるようにしておくと後から自分で見た時も分かりやすくなります。 ステップ3: アセットの読み込み 新しく作ったBlueprintをダブルクリックで開き、「Construction Script」のタブを選択します。 Blueprintのノードを配置するには「Consruction Script」または「イベントグラフ」のタブを選択する事になりますが、今回は「Consruction Script」を選びます。 「Consruction Script」はゲームが始まる前に予め準備をしておくための場所になります。 Blueprintをビューポートでレベルに配置した時点で動作確認ができるので、 Blueprintのテストをするに...
続きを読む