安装和配置适用于 Visual Studio Code 的区块链应用程序构建器扩展

Prerequisites

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

注意：

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

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

先决条件

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 进行测试）和 npm v8.x 或 9.x（使用 9.5.0 和 9.5.1 进行测试）
通过运行以下命令检查 Node.js 版本：node --version

通过运行以下命令检查 npm 版本：npm --version

如果使用 nvm 或 nodenv 等管理器安装 Node.js 和 npm，请设置默认/全局版本，然后重新启动 Visual Studio Code，以便 Prerequisites 页检测到该版本。

请勿使用早于或晚于版本 18 的 Node.js 版本。
转到版本 v1.20.10。安装区块链应用程序构建器后，请参阅 Go Chaincode 项目的附加设置。
通过运行以下命令检查 Go 版本：go version
如果您计划使用区块链应用程序构建器的同步功能，请安装 Git 并配置您的用户名和电子邮件，如下面的命令所示。在 <your_name> 和 <email> 的位置指定您的用户名和电子邮件地址。
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```
Visual Studio Code 版本 1.66.0 或更高版本
通过运行以下命令检查 Visual Studio Code 版本：code --version

使用 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
```
该命令的输出为以下文本：
```
default -> 18.16.0 (-> v18.16.0)
```

先决条件

Docker v18.09.0 或更高版本
Docker 编写 v1.23.0 或更高版本
Node.js 版本 18 的最新版本（使用 18.15.0 和 18.16.0 进行测试）和 npm v8.x 或 v9.x（使用 9.5.0 和 9.5.1 进行测试）
通过运行以下命令检查 Node.js 版本：node --version

通过运行以下命令检查 npm 版本：npm --version

如果使用 nvm 或 nodenv 等管理器安装 Node.js 和 npm，请设置默认/全局版本，然后重新启动 Visual Studio Code，以便 Prerequisites 页检测到该版本。

请勿使用早于或晚于版本 18 的 Node.js 版本。
转到版本 v1.20.10。安装区块链应用程序构建器后，请参阅 Go Chaincode 项目的附加设置。
通过运行以下命令检查 Go 版本：go version
如果您计划使用区块链应用程序构建器的同步功能，请安装 Git 并配置您的用户名和电子邮件，如下面的命令所示。在 <your_name> 和 <email> 的位置指定您的用户名和电子邮件地址。
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```
Visual Studio Code 版本 1.66.0 或更高版本
通过运行以下命令检查 Visual Studio Code 版本：code --version

使用 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
```
该命令的输出为以下文本：
```
default -> 18.16.0 (-> v18.16.0)
```

先决条件

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。

如果本地计算机上安装了 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 设置和容器运行时。

安装 Blockchain App Builder 扩展

从 Oracle Blockchain Platform 控制台的 Blockchain App Builder 窗格上的 Developer Tools（开发人员工具）选项卡下载扩展。在区块链应用程序构建器窗格的下载部分下，选择 Visual Studio Code Extension 。
在 Visual Studio Code 中，打开 Extensions 面板，然后从 More Actions 菜单中，选择 Install from VSIX 。
找到下载的 oracle-ochain-extension-x.x.x.vsix 文件，然后单击安装。（调整要安装的版本的 .vsix 文件的名称。）
重新启动 Visual Studio Code 以完成扩展的安装。
要使用规范文件验证函数（在键入时自动验证规范文件），请从 Red Hat 安装 YAML 扩展名。打开扩展面板，搜索 YAML，安装 YAML 语言支持扩展，然后重新启动 Visual Studio Code。

安装后，可以使用 Visual Studio Code 左侧的 Oracle Blockchain App Builder 图标打开 Blockchain App Builder 面板。

此外，如果尚未单独安装 Blockchain App Builder 命令行界面 (command line interface，CLI)，该界面将作为 Visual Studio Code 扩展的一部分自动安装。CLI 命令可以从任何终端应用程序（包括 Visual Studio Code 控制台窗口）运行。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 文件，在系统范围内应用更改。

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