1. Oracle Blockchain Platformの使用
  2. ローコード・ブロックチェーン・アプリケーション・ビルダーを使用したチェーンコードの構築
  3. Visual Studio Code用のブロックチェーン・アプリケーション・ビルダー拡張機能の使用
  4. Visual Studio Codeのブロックチェーン・アプリケーション・ビルダー拡張機能のインストールおよび構成

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

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

前提条件

  • 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.21.9以降。ただし、Go v1.22以降は不可。ブロックチェーン・アプリケーション・ビルダーのインストール後、「Goチェーンコード・プロジェクトの追加設定」を参照してください。

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

  • ブロックチェーン・アプリケーション・ビルダーの同期機能を使用する場合は、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のバージョンは使用しないでください。

  • Go v1.21.9以降。ただし、Go v1.22以降は不可。ブロックチェーン・アプリケーション・ビルダーのインストール後、「Goチェーンコード・プロジェクトの追加設定」を参照してください。

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

  • ブロックチェーン・アプリケーション・ビルダーの同期機能を使用する場合は、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でテスト)。ブロックチェーン・アプリケーション・ビルダーは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でテスト済)
  • Go v1.21.9以降。ただし、Go v1.22以降は不可。ブロックチェーン・アプリケーション・ビルダーのインストール後、「Goチェーンコード・プロジェクトの追加設定」を参照してください。
  • ブロックチェーン・アプリケーション・ビルダーの同期機能を使用する場合は、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 Code拡張機能」を選択します。
  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拡張機能をインストールします。「Extensions」パネルを開き、YAMLを検索し、YAML Language Support拡張機能をインストールしてから、Visual Studio Codeを再起動します。

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

また、ブロックチェーン・アプリケーション・ビルダーのコマンドライン・インタフェース(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。