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

Prerequisites

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

注意：

区块链应用构建器可与 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 测试）。请勿使用早于或晚于版本 18 的 Node.js 版本。
npm v8.x 或 v9.x（使用 9.5.0 和 9.5.1 进行测试）
转到 v1.21.9 或更高版本，但不转到 v1.22 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for Go Chaincode Projects 。
如果要使用区块链应用程序构建器的同步功能，请安装 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 的情况下运行更多命令。

输入以下命令以安装 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
```

先决条件

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.21.9 或更高版本，但不转到 v1.22 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for Go Chaincode Projects 。
如果要使用区块链应用程序构建器的同步功能，请安装 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 的情况下运行更多命令。

输入以下命令以安装 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
```

安装 Docker

确保 dnf 已更新并基于内核指向当前系统信息库。

输入以下命令以将 Docker 添加到资料档案库列表中：

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

输入以下命令以安装 Docker：
```
dnf install docker-ce -y --allowerasing
```
输入以下命令以启动 Docker 作为服务：
```
sudo systemctl enable --now docker
```
输入以下命令以确保当前用户有权访问 Docker：
```
sudo groupadd docker
sudo usermod -aG docker $USER
```
输入以下命令以重新启动系统：
```
sudo reboot
```

安装 Docker 编写

输入以下 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

输入以下命令以向 Docker 编写添加可执行权限：
```
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.21.9 或更高版本，但不转到 v1.22 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for Go Chaincode Projects 。
如果要使用区块链应用程序构建器的同步功能，请安装 Git 并配置用户名和电子邮件，如以下命令中所示。在 <your_name> 和 <email> 的位置指定您的用户名和电子邮件地址。
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

安装 Rancher 桌面

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

安装区块链应用构建器

从 Oracle Blockchain Platform 控制台的 Blockchain App Builder 窗格上的 Developer Tools 选项卡下载 Blockchain App Builder CLI 包 (oracle-ochain-cli-x.x.x.tgz)。

输入以下命令以安装 Xcode 或 XCode 命令行工具 (xcode-select)。
```
sudo xcode-select –install
```
输入以下命令以安装 Blockchain App Builder（针对要安装的版本调整 .tgz 文件的名称）：
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```

请注意，Mac OS Catalina 可能存在 xcode-select 问题。如果您遇到这些问题，请使用以下命令重置并重新启动 xcode-select：

xcode-select –-reset

输入以下命令以安装 Blockchain App Builder（针对要安装的版本调整 .tgz 文件的名称）：
```
npm install -g oracle-ochain-cli-x.x.x.tgz
```
以当前用户身份注销，然后重新登录，使组成员资格生效。

安装所有先决条件软件后，输入以下命令以安装 Blockchain App Builder（针对要安装的版本调整 .tgz 文件的名称）：

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

验证安装

在终端中，键入 ochain -v。输出显示区块链应用程序构建器 CLI 使用情况、选项和命令。

执行链代码项目的附加设置

要开发 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。