區塊鏈 App 產生器 Visual Studio 程式碼擴充疑難排解

您可以使用下列方法來疑難排解 Blockchain App Builder Visual Studio Code 擴充的系統問題。

先決條件問題

如果您修改或升級 Blockchain App Builder 所需的任何先決條件軟體，可能會發生錯誤。您可以使用已安裝的相依性功能來檢查您的區塊鏈 App 產生器安裝是否仍符合先決條件。在 Visual Studio 程式碼的區塊鏈 App 產生器歡迎頁面中，按一下安裝的相依性。就會顯示一個表格，其中顯示區塊鏈 App 產生器所使用的必要版本和實際安裝的元件版本。星號 ( *) 指示必要的元件。

嘗試安裝 Blockchain App Builder 時若先決條件檢查失敗，但發生錯誤和警告，您可能會在 Visual Studio 程式碼的輸出窗格中見到類似以下範例的錯誤：

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

這是因為對等容器無法正確重新啟動。

解決方案：在環境窗格中選取您的本機環境，然後按一下滑鼠右鍵並選取重建本機環境，即可重新建立程式實際執行。嘗試重新部署。

重設擴充功能資料

您的區塊鏈 App 產生器使用者資料可能損毀。此選項會清除區塊鏈 App 產生器中的資料，不會影響本機儲存的任何項目。

從 [ 檢視 ] 功能表開啟 [ 指令選盤 ]。
在 [Command Palette] (指令選盤) 中，輸入 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
```