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

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

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

必備條件

在本機系統上安裝區塊鏈 App 產生器之前，您必須先安裝先決條件。

附註：

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

安裝 Blockchain App Builder 時，會先執行先決條件檢查。如果先決條件檢查失敗，安裝處理作業就會停止。

先決條件

  • Rancher 桌面 (通過 1.4.1 測試)。Blockchain App Builder 也可以與 Docker 搭配使用，但已經使用 Rancher Desktop 進行測試和驗證。如果您打算使用 Rancher Desktop，請先完全解除安裝 Docker，再安裝 Rancher Desktop。安裝 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 程式碼，讓先決條件頁面偵測到版本。

    請勿使用早於或晚於版本 18 的 Node.js 版本。

  • 請執行 v1.23.2 或更新版本，但不要執行 v1.24 或更新版本。安裝 Blockchain App 產生器之後，請參閱 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 --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 程式碼，讓先決條件頁面偵測到版本。

    請勿使用早於或晚於版本 18 的 Node.js 版本。

  • 請執行 v1.23.2 或更新版本，但不要執行 v1.24 或更新版本。安裝 Blockchain App 產生器之後，請參閱 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 --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 桌面 (通過 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 或更新版本，但不要執行 v1.24 或更新版本。安裝 Blockchain App 產生器之後，請參閱 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.4.1 中的容器程式實際執行，請按一下 Kubernetes 設定值 > 容器程式實際執行。

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

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

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

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

Go Chaincode 專案的其他設定

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

設定 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。