Visual Studio Codeのブロックチェーン・アプリケーション・ビルダー拡張機能のインストールおよび構成

Visual Studio Codeのブロックチェーン・アプリケーション・ビルダー拡張機能は、Oracle Blockchain Platformコンソールからダウンロードできます。

次のプラットフォームがサポートされています。
  • macOS
  • Oracle Linux 8.0または9.0
  • Microsoft Windows 10または11

前提条件

ブロックチェーン・アプリケーション・ビルダーをローカル・システムにインストールする前に、前提条件をインストールする必要があります。

ノート:

ブロックチェーン・アプリケーション・ビルダーは、Oracle Blockchain Platformとそのコンパイラと連携します。次の項で説明した前提条件以外のバージョンを使用する場合、チェーンコードをリモートのOracle Blockchain Platformネットワークにデプロイすると失敗する可能性があります。

Blockchain App Builderをインストールすると、前提条件チェックが最初に実行されます。前提条件チェックが失敗すると、インストール・プロセスが停止します。

前提条件

  • Rancher Desktop(1.4.1でテスト)Blockchain App BuilderはDockerでも動作しますが、Rancher Desktopでテストおよび検証されています。Rancher Desktopを使用する場合は、Rancher Desktopをインストールする前にDockerを完全にアンインストールしてください。Rancher Desktopをインストールした後、コンテナ・ランタイムがdockerd (moby)に設定されていることを確認します。Rancher Desktop 1.4.1でコンテナ・ランタイムを確認するには、「Kubernetes設定」→「コンテナ・ランタイム」をクリックします。
  • Node.jsバージョン18の最新リリース(18.15.0および18.16.0でテスト済)、およびnpm v8.xまたは9.x (9.5.0および9.5.1でテスト済)

    Node.jsバージョンを確認するには、次のコマンドを実行します: node --version

    次のコマンドを実行して、npmバージョンを確認します: npm --version

    nvmやnodenvなどのマネージャを使用してNode.jsおよびnpmをインストールする場合は、デフォルト/グローバル・バージョンを設定し、「前提条件」ページでバージョンが検出されるようにVisual Studio Codeを再起動します。

    バージョン18より前または後のNode.jsのバージョンは使用しないでください。

  • v1.23.2 以降は実行しますが、Go v1.24以降は実行しません。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。

    次のコマンドを実行してGoバージョンを確認します: go version

  • Blockchain App Builderの同期機能を使用する場合は、Gitをインストールし、次のコマンドに示すようにユーザー名と電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Codeバージョン1.66.0以降

    次のコマンドを実行して、Visual Studio Codeのバージョンを確認します: code --version

nvmを使用したNode.jsおよびnpmのインストール

nvmを使用してNode.jsおよびnpmをインストールすると、sudoを使用せずにさらにコマンドを実行できます。
  1. 次のコマンドを入力してnvmをインストールします:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. 該当するファイル~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrcにコード・スニペットを追加します。
    export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
  3. オペレーティング・システムからログアウトし、再びオペレーティング・システムにログインします。
  4. 次のコマンドを入力して、nvmのインストールを確認します。
    nvm version
  5. Node.jsおよびnpmをインストールするには、次のコマンドを入力します。
    nvm install 18.16.0
  6. 次のコマンドを入力して、nvmでNode.js 18.16.0をデフォルトとして設定します。
    nvm alias default 18.16.0
    コマンドの出力内容は次のとおりです。
    default -> 18.16.0 (-> v18.16.0)

前提条件

  • Docker v18.09.0以降
  • Docker Compose v1.23.0以降
  • Node.jsバージョン18の最新リリース(18.15.0および18.16.0でテスト済)、およびnpm v8.xまたはv9.x (9.5.0および9.5.1でテスト済)

    Node.jsバージョンを確認するには、次のコマンドを実行します: node --version

    次のコマンドを実行して、npmバージョンを確認します: npm --version

    nvmやnodenvなどのマネージャを使用してNode.jsおよびnpmをインストールする場合は、デフォルト/グローバル・バージョンを設定し、「前提条件」ページでバージョンが検出されるようにVisual Studio Codeを再起動します。

    バージョン18より前または後のNode.jsのバージョンは使用しないでください。

  • v1.23.2 以降は実行しますが、Go v1.24以降は実行しません。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。

    次のコマンドを実行してGoバージョンを確認します: go version

  • Blockchain App Builderの同期機能を使用する場合は、Gitをインストールし、次のコマンドに示すようにユーザー名と電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Codeバージョン1.66.0以降

    次のコマンドを実行して、Visual Studio Codeのバージョンを確認します: code --version

nvmを使用したNode.jsおよびnpmのインストール

nvmを使用してNode.jsおよびnpmをインストールすると、sudoを使用せずにさらにコマンドを実行できます。
  1. 次のコマンドを入力してnvmをインストールします:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. 該当するファイル~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrcにコード・スニペットを追加します。
    export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
  3. オペレーティング・システムからログアウトし、再びオペレーティング・システムにログインします。
  4. 次のコマンドを入力して、nvmのインストールを確認します。
    nvm version
  5. Node.jsおよびnpmをインストールするには、次のコマンドを入力します。
    nvm install 18.16.0
  6. 次のコマンドを入力して、nvmでNode.js 18.16.0をデフォルトとして設定します。
    nvm alias default 18.16.0
    コマンドの出力内容は次のとおりです。
    default -> 18.16.0 (-> v18.16.0)

前提条件

  • Rancher Desktop(1.4.1でテスト)Blockchain App BuilderはDockerでも動作しますが、Rancher Desktopでテストおよび検証されています。
  • Node.jsバージョン18の最新リリース(18.15.0および18.16.0でテスト済)。バージョン18より前または後のNode.jsのバージョンは使用しないでください。
  • npm v8.xまたはv9.x (9.5.0および9.5.1でテスト済)
  • v1.23.2 以降は実行しますが、Go v1.24以降は実行しません。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
  • Blockchain App Builderの同期機能を使用する場合は、Gitをインストールし、次のコマンドに示すようにユーザー名と電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"

Rancherデスクトップのインストール

Microsoft WindowsにRancher Desktopをインストールするには、次のステップを実行します。
  1. Dockerがローカル・コンピュータにインストールされている場合は、完全にアンインストールします。
  2. Rancher Desktopをダウンロードしてインストールします。
  3. インストール・ウィザードの完了後、Rancher Desktopを開く前に、次のコマンドを実行します。
    wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
  4. Rancher Desktopを開き、設定プロセスを完了します。
  5. Rancher Desktopをインストールした後、コンテナ・ランタイムがdockerd (moby)に設定されていることを確認します。Rancher Desktop 1.4.1でコンテナ・ランタイムを確認するには、「Kubernetes設定」→「コンテナ・ランタイム」をクリックします。

ブロックチェーン・アプリケーション・ビルダー拡張機能のインストール

  1. Oracle Blockchain Platformコンソールのブロックチェーン・アプリケーション・ビルダー・ペインの開発者ツール・タブから拡張機能をダウンロードします。ブロックチェーン・アプリケーション・ビルダー・ペインの「ダウンロード」セクションで、Visual Studio Code拡張機能を選択します。
  2. Visual Studio Codeで、「Extension」パネルを開き、「More Actions」メニューから「Install from VSIX」を選択します。
  3. ダウンロードしたoracle-ochain-extension-x.x.x.vsixファイルを見つけて、「Install」をクリックします。(インストールするバージョンの.vsixファイルの名前を調整します。)
  4. Visual Studio Codeを再起動して、拡張機能のインストールを完了します。
  5. 入力時に仕様ファイルを自動的に検証する仕様ファイル検証関数を使用するには、Red HatからYAML拡張をインストールします。「拡張機能」パネルを開き、YAMLを検索し、YAML言語サポート拡張機能をインストールしてから、Visual Studio Codeを再起動します。

インストール後、Visual Studio Codeの左側にあるOracle Blockchainアプリケーション・ビルダー・アイコンを使用して、「ブロックチェーン・アプリケーション・ビルダー」パネルを開くことができます。

また、ブロックチェーン・アプリケーション・ビルダーのコマンドライン・インタフェース(CLI)は、Visual Studio Codeの拡張機能の一部として自動的にインストールされます(まだ個別にインストールしていない場合)。CLIコマンドは、Visual Studio Codeコンソール・ウィンドウを含む任意のターミナル・アプリケーションから実行できます。ブロックチェーン・アプリケーション・ビルダーはグローバルにインストールされるため、ファイル・システム内の任意の場所からCLIコマンドを実行できます。

チェーンコード・プロジェクトの実行の追加設定

Goプロジェクトを開発するには、GOPATH環境変数を設定する必要があります。これにより、Goはワークスペースを検索し、コードを実行できます。

GOPATH環境変数を設定する前に、go/フォルダが$HOMEディレクトリに存在することを確認してください。そうでない場合は、次のコマンドを入力して、ホーム・ディレクトリにgo/ディレクトリを作成します:
mkdir $HOME/go
該当するファイルに次の変数(~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrc)を追加して、GOPATH環境変数を設定します。
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
ファイルを編集したら、次のコマンドを実行して変更をただちに有効にします:
source ~/.bash_profile

または、前の変数を/etc/bashrcファイルに追加して、システム全体に変更を適用できます。

GOPATH環境変数を設定する前に、go/フォルダが$HOMEディレクトリに存在することを確認してください。そうでない場合は、次のコマンドを入力して、ホーム・ディレクトリにgo/ディレクトリを作成します:
mkdir $HOME/go
該当するファイルに次の変数(~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrc)を追加して、GOPATH環境変数を設定します。
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
ファイルを編集したら、次のコマンドを実行して変更をただちに有効にします:
source ~/.bash_profile

または、前の変数を/etc/bashrcファイルに追加して、システム全体に変更を適用できます。

ホーム・ディレクトリにgo/ディレクトリを作成します: C:\Users\<username>\go。