安裝並設定區塊鏈 App 產生器 CLI

支援下列平台：

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

完成安裝程序之後：

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

必備條件

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

附註：

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

安裝 Blockchain App Builder 時，會先執行先決條件檢查。如果先決條件檢查失敗，安裝程序便會停止。

• macOS
• Linux
• Windows

先決條件

• 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)。請勿使用早於或晚於版本 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>"

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

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

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

先決條件

• 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。

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 產生器

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

• macOS
• Linux
• Windows

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

   sudo xcode-select –install

2. 輸入下列命令來安裝 Blockchain App Builder (調整您正在安裝之版本的 .tgz 檔案名稱)：

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

請注意，Mac OS Catalina 可能發生 xcode-select 問題。如果您遇到這些問題，請使用下列指令重設並重新啟動 xcode-select：

xcode-select –-reset

1. 輸入下列命令來安裝 Blockchain App Builder (調整您正在安裝之版本的 .tgz 檔案名稱)：

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

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

安裝所有先決條件軟體之後，請輸入下列命令來安裝 Blockchain App Builder (請調整您正在安裝之版本的 .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。