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ネットワークにデプロイすると失敗する可能性があります。

ブロックチェーン・アプリケーション・ビルダーをインストールすると、前提条件チェックが最初に実行されます。前提条件チェックが失敗すると、インストール・プロセスは停止します。

• macOS
• Linux
• ウィンドウ

前提条件

• Rancher Desktop (1.4.1でテスト済み)ブロックチェーン・アプリケーション・ビルダーは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は使用しないでください。

• Goバージョンv1.20.10。ブロックチェーン・アプリケーション・ビルダーのインストール後、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. 次のコマンドを入力して、Node.js 18.16.0をnvmのデフォルトとして設定します。

   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は使用しないでください。

• Goバージョンv1.20.10。ブロックチェーン・アプリケーション・ビルダーのインストール後、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. 次のコマンドを入力して、Node.js 18.16.0をnvmのデフォルトとして設定します。

   nvm alias default 18.16.0
   

   コマンドの出力内容は次のとおりです。

   default -> 18.16.0 (-> v18.16.0)

前提条件

• Rancher Desktop (1.4.1でテスト済み)ブロックチェーン・アプリケーション・ビルダーは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.20.10に移動します。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
• Blockchain App Builderの同期機能を使用する場合は、Gitをインストールし、次のコマンドに示すようにユーザー名と電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。

  git config --global user.name "<your_name>" 
  

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

Rancher Desktopのインストール

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コード拡張を選択します。
2. Visual Studio Codeで、「Extensions」パネルを開き、「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はワークスペースを検索し、コードを実行できます。

• macOS
• Linux
• ウィンドウ

GOPATH環境変数を設定する前に、go/フォルダが$HOMEディレクトリに存在することを確認してください。そうでない場合は、次のコマンドを入力して、ホーム・ディレクトリにgo/ディレクトリを作成します:

mkdir $HOME/go

該当するファイルに次の変数を追加して、GOPATH環境変数を設定します: ~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrc。

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

該当するファイルに次の変数を追加して、GOPATH環境変数を設定します: ~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrc。

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。