区块链应用程序构建器 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.20.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

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

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

重置扩展数据

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

从 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
```