安装和配置区块链应用程序构建器 CLI

支持以下平台：

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

完成安装过程后：

• 验证安装。
• 如果您使用的是 Go 链代码项目，请完成其他配置步骤。

Prerequisites

在本地系统上安装 Blockchain App Builder CLI 之前，必须先安装先决条件。

注意：

Blockchain App Builder 与 Oracle Blockchain Platform 及其编译器协调。如果使用以下部分中提到的先决条件以外的任何版本，则将链代码部署到远程 Oracle Blockchain Platform 网络可能会失败。

安装 Blockchain App Builder 时，首先会运行先决条件检查。如果先决条件检查失败，则安装过程将停止。

• macOS
• Linux
• Windows

先决条件

• Rancher Desktop（使用 1.4.1 进行测试）。区块链应用程序构建器也可以与 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。安装区块链应用程序构建器后，请参阅 Go Chaincode 项目的附加设置。
• 如果要使用区块链应用程序构建器的同步功能，请安装 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。安装区块链应用程序构建器后，请参阅 Go Chaincode 项目的附加设置。
• 如果要使用区块链应用程序构建器的同步功能，请安装 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 编写：

   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.4.1 进行测试）。区块链应用程序构建器也可以与 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。安装区块链应用程序构建器后，请参阅 Go Chaincode 项目的附加设置。
• 如果要使用区块链应用程序构建器的同步功能，请安装 Git 并配置用户名和电子邮件，如下面的命令中所示。在 <your_name> 和 <email> 的位置指定您的用户名和电子邮件地址。

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

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

安装 Rancher 桌面

完成以下步骤在 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 设置和容器运行时。

安装区块链应用构建器

从 Oracle Blockchain Platform 控制台的 Blockchain App Builder 窗格上的 Developer Tools（开发人员工具）选项卡下载 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 环境变量。这允许 Go 查找您的工作区并运行代码。

• 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 文件，在系统范围内应用更改。

在主目录 C:\Users\<username>\go 中创建 go/ 目录。