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

Prerequisites

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

注意：

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

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

先决条件

Rancher Desktop（使用 1.19.3 测试）。Blockchain App Builder 也可以与 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 测试）
Go v1.23.2 或更高版本，但不 Go v1.24 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for 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 的情况下运行更多命令。

输入以下命令以安装 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 Compose 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 测试）
Go v1.23.2 或更高版本，但不 Go v1.24 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for 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 的情况下运行更多命令。

输入以下命令以安装 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 Compose 添加可执行权限：
```
sudo chmod +x /usr/local/bin/docker-compose
```

先决条件

Rancher Desktop（使用 1.19.3 测试）。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 测试）
Go v1.23.2 或更高版本，但不 Go v1.24 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for 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.19.3 中验证容器运行时，请单击 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。输出显示 Blockchain App Builder CLI 使用情况、选项和命令。

Go Chaincode 项目的附加设置

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