初めての人のための予備知識

初めて開発ツールをインストールする際には、環境を整えるためのいくつかの手順を踏む必要があります。

ただし、これらの作業には何通りかの方法があります。 ここに記載されていない情報については、使用しているオペレーティングシステムのマニュアルを参照してください。

ここでの説明は、あなたが macOS コンピュータを使用していることを想定しています。 Linux の開発環境をお持ちの方は、お使いの Linux ディストリビューションやバージョンによって、以下の手順が異なります。

以下は DFINITY Canister SDK をインストールする前に、知っておくべきことです。

  • ターミナルでコマンドを開き、実行する方法

  • パッケージと依存関係を確認し、インストールする方法

  • 新しいディレクトリを作成し、そこに移動する方法

  • 使用しているプラットフォームの PATH を確認して更新する方法

このセクションでは、基本的な開発環境を準備する方法について説明します。

ターミナルを開く

チュートリアル を試す際には、ターミナルを開いてディレクトリに移動し、DFINITY Canister SDK をインストールしたり、ローカルで動作している Internet Computer を起動・停止する方法を知っておく必要があります。

macOS でターミナルアプリケーションを開くには

  1. Finder を開きます。

  2. アプリケーション」をクリックし、「ユーティリティ」を開いて、「ターミナル」をダブルクリックします。

    または、+spacebar を押して「検索」を開き、「 terminal 」と入力します。

    ターミナルは、コマンドを入力し実行する場所です。 コマンドを実行するには、命令を入力するか、コピー&ペーストしてから、Return を押します。

  3. pwd コマンドを実行し、Return を押して、現在の PATH を確認します。

    pwd

    このコマンドは、 /Users/<ユーザー名> のように、現在いるディレクトリの PATH を表示します。

    ターミナルを開いた後、 Shell をクリックし、New Window または New Tab を選択することで、いつでも新しいターミナルを開くことができます。

    デフォルトでは、新しいターミナルは常にホームディレクトリで開かれ、 PATH は /Users/<ユーザー名> のようになります。

パッケージの確認

Homebrew アプリケーションは、macOS 用のパッケージマネージャで、ローカルの開発環境に必要なパッケージ(外部プログラム)のインストールやアップデートを簡単に行うことができます。

node.js パッケージは、フロントエンドユーザーインターフェース開発のための JavaScript ランタイム環境とモジュールを提供します。 node.js パッケージは、プログラムをビルドする際には必要ありませんが、グラフィカル・ユーザー・インターフェースを使用する場合には、おそらく必要になるでしょう。

開発環境がLinuxの場合、パッケージのインストールや依存関係の管理に、Homebrew ではなく任意のパッケージマネージャーを使用することができます。

パッケージの確認とインストール:

  1. Homebrew パッケージマネージャーがインストールされているかどうか、以下のコマンドで確認してください。

    brew --version

    バージョン情報が返ってきた場合は、次のステップに進みます。 Homebrewが インストールされていない場合は、以下のコマンドをコピーしてターミナルに貼り付けます。

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
  2. 以下のコマンドを実行して、node.js パッケージマネージャがインストールされているかどうかを確認します。

    node --version

    サポートされている node.js の最低バージョンは 12 であり、長期的にサポートされるバージョンのみをサポートしています(これらはバージョン番号が偶数になります)。バージョン情報が返ってきて、node のバージョンが 12 以上であれば、そのまま 作業フォルダの作成 に進みます。 もし node.js がインストールされていないか、バージョンが 12 より古い場合には、以下のコマンドをコピーしてターミナルに貼り付けます。

    brew install node@16

作業フォルダの作成

通常、ターミナルはホームディレクトリである、/Users/<ユーザー名> のような PATH で開きます。 ワークスペースを整頓するために、Internet Computer プロジェクト用に別のフォルダを作成してもよいでしょう。

Internet Computer プロジェクト用作業フォルダの作成は任意ですが、作成するとプロジェクト間の検索や移動が容易になります。 チュートリアル のうち、クイックスタート 以外のものを試す場合に特に便利です。

新しい作業フォルダを作成するには:

  1. ローカルコンピュータでターミナルを開きます(まだ開いていない場合)。

  2. 以下のコマンドを実行して、ホームディレクトリに ic-projects という名前の新しいフォルダを作成します。

    mkdir ic-projects
  3. 以下のコマンドを実行して、新しい作業フォルダに移動します。

    cd ic-projects

PATH 内のディレクトリの表示

環境変数 PATH は、オペレーティングシステムが、実行可能なプログラムの場所を特定するために使用される重要な設定です。 すべてのオペレーティングシステムはプログラムを探すための独自のディレクトリリストを持っており、 DFINITY Canister SDK コマンドラインの実行ファイル - dfx - がリストのいずれかにあることを確認するため、PATH 環境変数の表示および変更の方法を知っておく必要があります。

macOS コンピュータでは、 dfx 実行ファイルのデフォルトの場所は /usr/local/bin で、このディレクトリは通常、デフォルトのリストに含まれています。 そのため、macOSを使用しているコンピュータでは、通常、PATH 変数の更新は必要ありません。 ただし、Linux ディストリビューションを使用している場合は、以下の方法を知っておきましょう。

  • dfx の実行ファイルの場所を確認する。

  • 現在の PATH に含まれるディレクトリのセットを確認する。

  • 必要に応じて、環境変数 PATH を変更する。

ほとんどのオペレーティング・システムでは、以下のようなコマンドを実行して、現在の PATH に含まれるディレクトリのセットを確認することができます。

export $PATH

DFINITY Canister SDK をインストールした後に、 dfx の実行ファイルの場所を確認するには、以下のコマンドを実行してください。

which dfx

現在の $PATH にリストされているディレクトリのいずれにも dfx の実行ファイルがない場合は、実行ファイルを移動するか、PATH の設定を変更する必要があります。 PATH を更新するための具体的な手順はお使いのオペレーティングシステムによって異なりますが、多くの場合、以下のようなコマンドを実行して、 ~/bin などの適切なディレクトリを指定します。

export PATH="<dfx コマンドが配置されているディレクトリ>:$PATH"

これで、DFINITY Canister SDK の インストール とコーディングを始める準備ができました!