安装和配置适用于 Visual Studio Code 的 Blockchain App Builder 扩展

Prerequisites

在本地系统上安装区块链应用构建器之前，必须先安装这些先决条件。

注意：

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）和 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 版本。
Go v1.23.2 或更高版本，但不 Go v1.24 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for Go Chaincode Projects 。
通过运行以下命令检查 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 Compose 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 版本。
Go v1.23.2 或更高版本，但不 Go v1.24 或更高版本。安装 Blockchain App Builder 后，请参见 Additional Setup for Go Chaincode Projects 。
通过运行以下命令检查 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.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 设置 > 容器运行时。

安装 Blockchain App Builder 扩展

从 Oracle Blockchain Platform 控制台的 Blockchain App Builder 窗格的 Developer Tools 选项卡下载扩展。在 Blockchain App Builder（区块链应用程序构建器）窗格的下载部分下，选择 Visual Studio Code Extension（Visual Studio 代码扩展）。
在 Visual Studio Code 中，打开 Extensions 面板，然后从 More Actions（更多操作）菜单中，选择 Install from VSIX（从 VSIX 安装）。
找到下载的 oracle-ochain-extension-x.x.x.vsix 文件，然后单击 Install 。（调整要安装的版本的 .vsix 文件的名称。）
重新启动 Visual Studio Code 以完成扩展的安装。
要使用在键入时自动验证规范文件的规范文件验证函数，请从 Red Hat 安装 YAML 扩展。打开 Extensions（扩展）面板，搜索 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 扩展的一部分。可以从任何终端应用程序（包括 Visual Studio Code 控制台窗口）运行 CLI 命令。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。