安裝並設定 Visual Studio 程式碼的區塊鏈 App 產生器擴充功能

您可以從 Oracle Blockchain Platform 主控台下載 Visual Studio Code 的 Blockchain App Builder 擴充功能。

支援下列平台：
  • macOS
  • Oracle Linux 8.0 或 9.0
  • Microsoft Windows 10 或 11

必備條件

在本機系統上安裝 Blockchain App Builder 之前，必須先安裝先決條件。

附註：

Blockchain App Builder 與 Oracle Blockchain Platform 及其編譯器協調一致。如果您使用下列部分以外的任何先決條件版本，將鏈碼部署到遠端 Oracle Blockchain Platform 網路可能會失敗。

安裝區塊鏈 App 產生器時，會先執行先決條件檢查。如果先決條件檢查失敗，安裝程序就會停止。

先決條件

  • Rancher Desktop (測試版本為 1.19.3)。區塊鏈 App 產生器也可以與 Docker 搭配使用，但已經使用 Rancher Desktop 進行測試和驗證。如果您計畫使用 Rancher Desktop，請在安裝 Rancher Desktop 之前完全解除安裝 Docker。安裝 Rancher Desktop 之後，請確定容器程式實際執行設為 dockerd (moby) 。若要驗證 Rancher Desktop 1.19.3 中的容器程式實際執行，請按一下 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 或更新版本，但不要前往 v1.24 或更新版本。安裝 Blockchain App Builder 之後，請參閱 Go Chaincode 專案的其他設定。

    執行下列命令來檢查 Go 版本：go version

  • 如果您計畫使用區塊鏈 App 產生器的同步功能，請安裝 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 撰寫 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 或更新版本，但不要前往 v1.24 或更新版本。安裝 Blockchain App Builder 之後，請參閱 Go Chaincode 專案的其他設定。

    執行下列命令來檢查 Go 版本：go version

  • 如果您計畫使用區塊鏈 App 產生器的同步功能，請安裝 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.19.3)。區塊鏈 App 產生器也可以與 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 或更新版本，但不要前往 v1.24 或更新版本。安裝 Blockchain App Builder 之後，請參閱 Go Chaincode 專案的其他設定。
  • 如果您想要使用區塊鏈 App 產生器的同步功能，請安裝 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.19.3 中的容器程式實際執行，請按一下 Kubernetes 設定值 > 容器程式實際執行。

安裝區塊鏈 App 產生器擴充功能

  1. 從 Oracle Blockchain Platform 主控台之區塊鏈 App 產生器窗格中的開發人員工具頁籤下載擴充功能。在區塊鏈 App 產生器窗格的下載區段下，選取 Visual Studio 程式碼擴充功能。
  2. 在 Visual Studio Code 中，開啟擴充功能面板，然後從其他動作功能表中選取從 VSIX 安裝。
  3. 找出下載的 oracle-ochain-extension-x.x.x.vsix 檔案，然後按一下安裝。(請為正在安裝的版本調整 .vsix 檔案的名稱。)
  4. 重新啟動 Visual Studio 程式碼以完成擴充的安裝。
  5. 若要使用規格檔案驗證功能，該功能會在您輸入時自動驗證規格檔案，請從 Red Hat 安裝 YAML 副檔名。開啟擴充功能面板、搜尋 YAML、安裝「YAML 語言支援」擴充功能，然後重新啟動 Visual Studio Code。

安裝之後，您可以使用 Visual Studio 程式碼左側的 Oracle Blockchain App Builder 圖示開啟區塊鏈 App 產生器面板。

如果您尚未個別安裝 Blockchain App Builder 命令行介面 (CLI)，系統會自動將其安裝為 Visual Studio Code 擴充的一部分。CLI 命令可以從任何終端機應用程式執行，包括 Visual Studio Code 主控台視窗。Blockchain App Builder 是全球安裝的，因此您可以從檔案系統中的任何位置執行 CLI 命令。

Go Chaincode 專案的其他設定

若要開發 Go 專案，您必須設定 GOPATH 環境變數。這可讓「前往」尋找您的工作區並執行您的程式碼。

設定 GOPATH 環境變數之前，請確定 $HOME 目錄中存在 go/ 資料夾。如果沒有，請輸入下列命令在主目錄中建立 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 環境變數之前，請確定 $HOME 目錄中存在 go/ 資料夾。如果沒有，請輸入下列命令在主目錄中建立 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。