区块链应用构建器 Visual Studio Code 扩展故障排除

使用以下信息解决 Blockchain App Builder Visual Studio Code 扩展的系统问题。

先决条件问题

如果您修改或升级区块链应用构建器所需的任何先决条件软件，可能会发生错误。您可以使用 Installed Dependencies 函数检查区块链应用程序构建器的安装是否仍符合先决条件。在 Visual Studio Code 中的 Blockchain App Builder 欢迎页面上，单击 Installed Dependencies 。此时将显示一个表，其中显示 Blockchain App Builder 使用的组件所需的版本和实际安装的版本。必需的组件用星号 ( * ) 表示。

如果在尝试安装 Blockchain App Builder 时，先决条件检查失败并出现错误和警告，您可能会在 Visual Studio Code 的输出窗格中看到类似以下示例的错误：

Error:
Aborting installation. Error:
Found 1 error(s) in pre-requisites check, failed with following errors:
1. Golang version mismatch. Expected 1.21.x, but found 1.18.5.

Found 3 warning(s) in pre-requisites check.
1. Docker is not installed. Please install Docker >= 18.09.0. To deploy chaincodes in the local environment, 
please install the recommended version of Docker.
2. Docker Compose is not installed. Please install Docker Compose >= 1.23.0. To deploy chaincodes in the 
local environment, please install the recommended version of Docker Compose.
3. Git is not installed. To sync chaincodes, please install the Git according to the documentation.

部署故障

由于部署失败、部署损坏、Docker 对等容器已满或者本地网络中停止的 Docker 对等设备，您可能会看到类似以下文本的错误：

============ Started instantiate Chaincode ============
[2028-19-01T19:25:lO.372] [ERROR] default - Error instantiating Chaincode GollGl on channel mychannel, detailed 
error: Error: error starting container: error starting container: Failed to generate platform-specific docker 
build: Failed to pull hyperledger/fabric-ccenv:latest : API error (404): manifest for hyperledger/ 
fabric-ccenv:latest not found: manifest unknown: manifest unknown [2020-19-01T19:25:10.372] (INFO) default -
============ Finished instantiate Chaincode ============
[2020-19-01119:25:10.372] [ERROR] default - Error: Error instantiating Chaincode Goll01 on channel mychannel, 
detailed error: Error: error starting container: error starting container: Failed to generate platfom-specific 
docker build: Failed to pull hyperledger/fabric-ccenv: latest : API error (404): manifest for hyperledger/ 
fabric-ccenv:lalest not found: manifest unknown: manifest unknown exited: signal: terminated 
INFO: exited: signal: terminated

ERROR: Error in Chaincode deployment

这是因为对等容器无法重新正常启动。

解决方案：通过在环境窗格中选择本地环境，右键单击并选择重建本地环境来重建运行时。尝试再次部署。

重置扩展数据

区块链应用程序构建器用户数据可能会损坏。重置扩展数据可清除区块链应用构建器中的数据，而不会影响本地存储的任何内容。

从视图菜单中打开命令选项板。
在命令选项板中，键入重置扩展。
选择 Oracle Blockchain Platform Reset Extension Data 。Visual Studio Code 清除现有区块链数据并重新加载默认安装数据。这不会影响存储在系统本地的文件，但您必须将它们导入 Visual Studio Code 并重新配置以前设置的任何环境。

macOS:Xcode

在 macOS 升级后，或者如果未安装 Xcode，您可能会在错误日志中看到类似以下内容的错误：

gyp: No Xcode or CLT version detected!
gyp ERR! configure error
gyp ERR! stack Error: `gyp` failed with exit code: 1
gyp ERR! stack     at

要解决此行为，请打开终端窗口并运行以下命令：
```
sudo rm -rf $(xcode-select --print-path)
xcode-select --install
```