安裝並設定 Blockchain App Builder CLI

支援下列平台：

• macOS
• Oracle Linux 8.0 或 9.0
• Microsoft Windows 10 或 11

完成安裝程序之後：

• 驗證您的安裝：
• 如果您使用 Go chaincode 專案，請完成其他組態步驟。

必備條件

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

附註：

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

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

• macOS
• Linux
• Windows

先決條件

• 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 的測試)。請勿使用版本 18 之前或之後的 Node.js 版本。
• npm v8.x 或 v9.x (以 9.5.0 和 9.5.1 進行測試)
• 請前往 v1.23.2 或更新版本，但不要前往 v1.24 或更新版本。安裝 Blockchain App Builder 之後，請參閱 Go Chaincode 專案的其他設定。
• 如果您要使用 Blockchain App Builder 的同步化功能，請安裝 Git，然後依照下列命令設定您的使用者名稱和電子郵件。在 <your_name> 和 <email> 的位置指定您的使用者名稱和電子郵件地址。

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

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

使用 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

先決條件

• Docker v20.10.0 或更新版本
• Docker 撰寫 v1.23.0 或更新版本
• 最新版本的 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 專案的其他設定。
• 如果您要使用 Blockchain App Builder 的同步化功能，請安裝 Git，然後依照下列命令設定您的使用者名稱和電子郵件。在 <your_name> 和 <email> 的位置指定您的使用者名稱和電子郵件地址。

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

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

使用 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

安裝 Docker

請確定已更新 dnf 並根據您的核心指向目前的儲存庫。

1. 輸入下列命令以新增 Docker 至儲存區域清單：

   sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo

2. 輸入下列命令以安裝 Docker：

   dnf install docker-ce -y --allowerasing

3. 輸入下列命令以啟動 Docker 即服務：

   sudo systemctl enable --now docker

4. 輸入下列命令以確保目前的使用者可以存取 Docker：

   sudo groupadd docker
   sudo usermod -aG docker $USER

5. 輸入下列命令以重新啟動系統：

   sudo reboot

安裝 Docker 編寫

1. 輸入下列 curl 命令以取得 Docker Compose：

   sudo curl -L https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compos

2. 輸入下列命令以新增「Docker 編寫」的執行檔權限：

   sudo chmod +x /usr/local/bin/docker-compose

先決條件

• 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 設定值 > 容器程式實際執行。

安裝 Blockchain App Builder

從 Oracle Blockchain Platform 主控台之區塊鏈 App 產生器窗格的開發人員工具頁籤下載區塊鏈 App 產生器 CLI 套裝程式 (oracle-ochain-cli-x.x.x.tgz)。

• macOS
• Linux
• Windows

1. 輸入下列命令以安裝 Xcode 或 XCode 命令行工具 (xcode-select)。

   sudo xcode-select –install

2. 輸入下列命令來安裝區塊鏈 App 產生器 (請針對您正在安裝的版本調整 .tgz 檔案的名稱)：

   npm install -g oracle-ochain-cli-x.x.x.tgz

Mac OS Catalina 可能有 xcode-select 問題。如果發生這些問題，請使用下列命令重設並重新啟動 xcode-select：

xcode-select –-reset

1. 輸入下列命令來安裝區塊鏈 App 產生器 (請針對您正在安裝的版本調整 .tgz 檔案的名稱)：

   npm install -g oracle-ochain-cli-x.x.x.tgz

2. 以目前使用者身分登出，然後再次登入，讓群組成員身分生效。

安裝完所有先決條件軟體之後，請輸入下列命令來安裝區塊鏈 App 產生器 (請為您正在安裝的版本調整 .tgz 檔案的名稱)：

npm install -g oracle-ochain-cli-x.x.x.tgz

驗證「安裝」

在終端機中輸入 ochain -v。輸出顯示 Blockchain App Builder CLI 的用法、選項和命令。

Go Chaincode 專案的其他設定

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

• macOS
• Linux
• Windows

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