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

以下内容可用于解决 Blockchain App Builder Visual Studio Code 扩展的系统问题。

先决条件问题

如果修改或升级 Blockchain App Builder 所需的任何先决条件软件，则可能会出错。您可以使用已安装的相关性功能来检查您的区块链应用程序构建器安装是否仍满足先决条件。在 Visual Studio Code 中的区块链应用程序构建器欢迎页面上，单击已安装的相关项。此时将显示一个表，其中显示了 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

这是因为对等容器无法再次正确启动。

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

重置扩展数据

您的区块链应用程序构建器用户数据可能被破坏。此选项会从区块链应用程序构建器清除数据，而不会影响本地存储的任何内容。

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

Mac OSX:Xcode

在 Mac OSX 升级之后，或者如果未安装 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
```