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

必備條件

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

附註：

Blockchain App Builder 與 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 程式碼，讓先決條件頁面偵測到該版本。

請勿使用早於或晚於版本 18 的 Node.js 版本。
Go 版本 v1.20.10。安裝 Blockchain App Builder 之後，請參閱 Go Chaincode Projects 的其他設定。
執行下列命令來檢查 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 --version

使用 nvm 安裝 Node.js 和 npm

使用 nvm 安裝 Node.js 和 npm 可讓您在沒有 sudo 的情況下執行更多指令。

輸入下列指令以安裝 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

將下列程式碼片段新增至適用的檔案：~/.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

登出，然後重新登入您的作業系統。
輸入下列指令以驗證 nvm 安裝：
```
nvm version
```
輸入下列命令以安裝 Node.js 和 npm：
```
nvm install 18.16.0
```
輸入下列指令，將 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 版本。
Go 版本 v1.20.10。安裝 Blockchain App Builder 之後，請參閱 Go Chaincode Projects 的其他設定。
執行下列命令來檢查 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 --version

使用 nvm 安裝 Node.js 和 npm

使用 nvm 安裝 Node.js 和 npm 可讓您在沒有 sudo 的情況下執行更多指令。

輸入下列指令以安裝 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

將下列程式碼片段新增至適用的檔案：~/.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

登出，然後重新登入您的作業系統。
輸入下列指令以驗證 nvm 安裝：
```
nvm version
```
輸入下列命令以安裝 Node.js 和 npm：
```
nvm install 18.16.0
```
輸入下列指令，將 Node.js 18.16.0 設為 nvm 中的預設值：
```
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.20.10。安裝 Blockchain App Builder 之後，請參閱 Go Chaincode Projects 的其他設定。
若要使用 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。

如果本機電腦上已安裝 Docker，請將其完全解除安裝。
下載並安裝 Rancher Desktop。
安裝精靈完成之後，開啟 Rancher Desktop 之前，請先執行下列命令：
```
wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
```
開啟 Rancher Desktop 以完成設定程序。
安裝 Rancher Desktop 之後，請確定容器程式實際執行已設為 dockerd (moby) 。若要驗證 Rancher Desktop 1.4.1 中的容器程式實際執行，請按一下 Kubernetes 設定值，然後按一下容器程式實際執行。

安裝區塊鏈 App 產生器擴充

從 Oracle Blockchain Platform 主控台之 Blockchain App Builder 窗格的開發人員工具頁籤下載擴充功能。在 Blockchain App Builder 窗格的下載區段下，選取 Visual Studio Code Extension 。
在 Visual Studio 程式碼中，開啟擴充功能面板，然後從其他動作功能表中選取從 VSIX 安裝。
尋找下載的 oracle-ochain-extension-x.x.x.vsix 檔案，然後按一下安裝。(請為您正在安裝的版本調整 .vsix 檔案的名稱。)
重新啟動 Visual Studio 程式碼以完成擴充功能安裝。
若要使用規格檔案驗證函數，可在您輸入時自動驗證規格檔案，請從 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 主控台視窗。區塊鏈 App 產生器已安裝在全球，因此您可以從檔案系統中的任何位置執行 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。