Installieren und Konfigurieren der Blockchain App Builder-Erweiterung für Visual Studio Code
Die Blockchain App Builder-Erweiterung für Visual Studio Code kann über die Oracle Blockchain Platform-Konsole heruntergeladen werden.
- macOS
- Oracle Linux 8.0 oder 9.0
- Microsoft Windows 10 oder 11
Voraussetzungen
Bevor Sie Blockchain App Builder auf Ihrem lokalen System installieren, müssen Sie die Voraussetzungen installieren.
Hinweis:
Blockchain App Builder koordiniert die Oracle Blockchain Platform und ihre Compiler. Wenn Sie andere Versionen der Voraussetzungen als die im folgenden Abschnitt genannten verwenden, verläuft das Deployment Ihres Chaincodes in einem Remote-Oracle Blockchain Platform-Netzwerk möglicherweise nicht erfolgreich.Wenn Sie Blockchain App Builder installieren, wird zuerst eine Voraussetzungsprüfung ausgeführt. Wenn die Voraussetzungsprüfung nicht erfolgreich verläuft, wird der Installationsprozess gestoppt.
Voraussetzungen
- Rancher Desktop (getestet mit 1.4.1). Blockchain App Builder kann auch mit Docker arbeiten, wurde jedoch mit Rancher Desktop getestet und verifiziert. Wenn Sie Rancher Desktop verwenden möchten, deinstallieren Sie Docker vollständig, bevor Sie Rancher Desktop installieren. Stellen Sie nach der Installation von Rancher Desktop sicher, dass die Containerlaufzeit auf dockerd (moby) gesetzt ist. Um die Containerlaufzeit in Rancher Desktop 1.4.1 zu prüfen, klicken Sie auf .
- Die neueste Version von Node.js Version 18 (getestet mit 18.15.0 und 18.16.0) und npm v8.x oder 9.x (getestet mit 9.5.0 und 9.5.1)
Prüfen Sie die Version Node.js, indem Sie den folgenden Befehl ausführen:
node --version
Prüfen Sie die npm-Version, indem Sie den folgenden Befehl ausführen:
npm --version
Wenn Sie einen Manager wie
nvm
odernodenv
zur Installation von Node.js und npm verwenden, legen Sie die Standard-/globale Version fest, und starten Sie Visual Studio Code neu, damit die Version auf der Seite Voraussetzungen erkannt wird.Verwenden Sie keine Versionen von Node.js vor oder nach Version 18.
- Go-Version v1.20.10. Informationen nach der Installation von Blockchain App Builder finden Sie unter Zusätzliches Setup für Go Chaincode-Projekte.
Prüfen Sie die Go-Version, indem Sie den folgenden Befehl ausführen:
go version
- Wenn Sie die Synchronisierungsfunktion von Blockchain App Builder verwenden möchten, installieren Sie Git, und konfigurieren Sie Ihren Benutzernamen und Ihre E-Mail-Adresse wie in den folgenden Befehlen dargestellt. Geben Sie Ihren Benutzernamen und Ihre E-Mail-Adresse an der Stelle von
<your_name>
und<email>
an.git config --global user.name "<your_name>"
git config --global user.email "<email>"
- Visual Studio Code Version 1.66.0 oder höher
Prüfen Sie die Visual Studio Code-Version, indem Sie den folgenden Befehl ausführen:
code --version
Installieren Sie Node.js und npm mit nvm
sudo
ausführen.
- Geben Sie zur Installation von nvm folgenden Befehl ein:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
- Fügen Sie der entsprechenden Datei das folgende Code-Snippet hinzu:
~/.bash_profile
,~/.profile
,~/.bashrc
oder~/.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
- Melden Sie sich ab und wieder bei Ihrem Betriebssystem an.
- Geben Sie den folgenden Befehl ein, um die nvm-Installation zu prüfen:
nvm version
- Geben Sie den folgenden Befehl ein, um Node.js und npm zu installieren:
nvm install 18.16.0
- Geben Sie den folgenden Befehl ein, um Node.js 18.16.0 als Standard in nvm festzulegen:
Die Ausgabe des Befehls lautet wie folgt:nvm alias default 18.16.0
default -> 18.16.0 (-> v18.16.0)
Voraussetzungen
- Docker v18.09.0 oder höher
- Docker Compose v1.23.0 oder höher
- Das neueste Release von Node.js Version 18 (getestet mit 18.15.0 und 18.16.0) und npm v8.x oder v9.x (getestet mit 9.5.0 und 9.5.1)
Prüfen Sie die Version Node.js, indem Sie den folgenden Befehl ausführen:
node --version
Prüfen Sie die npm-Version, indem Sie den folgenden Befehl ausführen:
npm --version
Wenn Sie einen Manager wie
nvm
odernodenv
zur Installation von Node.js und npm verwenden, legen Sie die Standard-/globale Version fest, und starten Sie Visual Studio Code neu, damit die Version auf der Seite Voraussetzungen erkannt wird.Verwenden Sie keine Versionen von Node.js vor oder nach Version 18.
- Go-Version v1.20.10. Informationen nach der Installation von Blockchain App Builder finden Sie unter Zusätzliches Setup für Go Chaincode-Projekte.
Prüfen Sie die Go-Version, indem Sie den folgenden Befehl ausführen:
go version
- Wenn Sie die Synchronisierungsfunktion von Blockchain App Builder verwenden möchten, installieren Sie Git, und konfigurieren Sie Ihren Benutzernamen und Ihre E-Mail-Adresse wie in den folgenden Befehlen dargestellt. Geben Sie Ihren Benutzernamen und Ihre E-Mail-Adresse an der Stelle von
<your_name>
und<email>
an.git config --global user.name "<your_name>"
git config --global user.email "<email>"
- Visual Studio Code Version 1.66.0 oder höher
Prüfen Sie die Visual Studio Code-Version, indem Sie den folgenden Befehl ausführen:
code --version
Installieren Sie Node.js und npm mit nvm
sudo
ausführen.
- Geben Sie zur Installation von nvm folgenden Befehl ein:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
- Fügen Sie der entsprechenden Datei das folgende Code-Snippet hinzu:
~/.bash_profile
,~/.profile
,~/.bashrc
oder~/.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
- Melden Sie sich ab und wieder bei Ihrem Betriebssystem an.
- Geben Sie den folgenden Befehl ein, um die nvm-Installation zu prüfen:
nvm version
- Geben Sie den folgenden Befehl ein, um Node.js und npm zu installieren:
nvm install 18.16.0
- Geben Sie den folgenden Befehl ein, um Node.js 18.16.0 als Standard in nvm festzulegen:
Die Ausgabe des Befehls lautet wie folgt:nvm alias default 18.16.0
default -> 18.16.0 (-> v18.16.0)
Voraussetzungen
- Rancher Desktop (getestet mit 1.4.1). Blockchain App Builder kann auch mit Docker arbeiten, wurde jedoch mit Rancher Desktop getestet und verifiziert.
- Das neueste Release der Node.js-Version 18 (getestet mit 18.15.0 und 18.16.0). Verwenden Sie keine Versionen von Node.js vor oder nach Version 18.
- npm v8.x oder v9.x (getestet mit 9.5.0 und 9.5.1)
- Gehe zu v1.20.10. Informationen nach der Installation von Blockchain App Builder finden Sie unter Zusätzliches Setup für Go Chaincode-Projekte.
- Wenn Sie die Synchronisierungsfunktion von Blockchain App Builder verwenden möchten, installieren Sie Git und konfigurieren Sie Ihren Benutzernamen und Ihre E-Mail-Adresse wie in den folgenden Befehlen dargestellt. Geben Sie Ihren Benutzernamen und Ihre E-Mail-Adresse an der Stelle von
<your_name>
und<email>
an.git config --global user.name "<your_name>"
git config --global user.email "<email>"
Installieren von Rancher Desktop
- Wenn Docker auf Ihrem lokalen Computer installiert ist, deinstallieren Sie es vollständig.
- Rancher Desktop herunterladen und installieren.
- Führen Sie nach Abschluss des Installationsassistenten vor dem Öffnen von Rancher Desktop die folgenden Befehle aus:
wsl --install wsl --set-default-version 2 wsl --setdefault rancher-desktop
- Öffnen Sie Rancher Desktop, um den Einrichtungsprozess abzuschließen.
- Stellen Sie nach der Installation von Rancher Desktop sicher, dass die Containerlaufzeit auf dockerd (moby) gesetzt ist. Um die Containerlaufzeit in Rancher Desktop 1.4.1 zu prüfen, klicken Sie auf .
Installieren Sie die Blockchain App Builder-Erweiterung
- Laden Sie die Erweiterung von der Registerkarte Entwicklertools im Bereich Blockchain App Builder der Oracle Blockchain Platform-Konsole herunter. Wählen Sie im Bereich Blockchain App Builder im Abschnitt Herunterladen die Option Visual Studio Code Extension aus.
- Öffnen Sie in Visual Studio Code den Bereich Erweiterungen, und wählen Sie im Menü Weitere Aktionen die Option Aus VSIX installieren aus.
- Suchen Sie die heruntergeladene Datei
oracle-ochain-extension-x.x.x.vsix
, und klicken Sie auf Installieren. (Korrigieren Sie den Namen der Datei.vsix
für die Version, die Sie installieren.) - Starten Sie Visual Studio Code neu, um die Installation der Erweiterung abzuschließen.
- Installieren Sie die YAML-Erweiterung von Red Hat, um die Validierungsfunktionen der Spezifikationsdatei zu verwenden, die bei der Eingabe die Spezifikationsdatei automatisch validieren. Öffnen Sie den Bereich Erweiterungen, suchen Sie nach YAML, installieren Sie die YAML Language Support-Erweiterung, und starten Sie Visual Studio Code neu.
Nach der Installation können Sie das Oracle Blockchain App Builder-Symbol auf der linken Seite von Visual Studio Code verwenden, um den Bereich Blockchain App Builder zu öffnen.
Darüber hinaus wird die Blockchain App Builder-Befehlszeilenschnittstelle (CLI) automatisch als Teil der Erweiterung für Visual Studio Code installiert, wenn Sie sie noch nicht separat installiert haben. Die CLI-Befehle können in jeder Terminalanwendung ausgeführt werden, einschließlich des Visual Studio Code-Konsolenfensters. Blockchain App Builder wird global installiert, sodass Sie die CLI-Befehle von jedem Speicherort im Dateisystem ausführen können.
Zusätzliches Setup für Go Chaincode-Projekte
Um ein Go-Projekt zu entwickeln, müssen Sie die Umgebungsvariable GOPATH
festlegen. Damit können Sie Ihren Arbeitsbereich suchen und Ihren Code ausführen.
GOPATH
festlegen, stellen Sie sicher, dass im Verzeichnis $HOME
ein Ordner go/
vorhanden ist. Andernfalls geben Sie den folgenden Befehl ein, um ein go/
-Verzeichnis in Ihrem Home-Verzeichnis zu erstellen:mkdir $HOME/go
GOPATH
fest, indem Sie der entsprechenden Datei die folgenden Variablen hinzufügen: ~/.bash_profile
, ~/.profile
, ~/.bashrc
oder ~/.zshrc
.export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
source ~/.bash_profile
Alternativ können Sie die Änderung systemweit anwenden, indem Sie die vorherigen Variablen der Datei /etc/bashrc
hinzufügen.
GOPATH
festlegen, stellen Sie sicher, dass im Verzeichnis $HOME
ein Ordner go/
vorhanden ist. Andernfalls geben Sie den folgenden Befehl ein, um ein go/
-Verzeichnis in Ihrem Home-Verzeichnis zu erstellen:mkdir $HOME/go
GOPATH
fest, indem Sie der entsprechenden Datei die folgenden Variablen hinzufügen: ~/.bash_profile
, ~/.profile
, ~/.bashrc
oder ~/.zshrc
.export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
source ~/.bash_profile
Alternativ können Sie die Änderung systemweit anwenden, indem Sie die vorherigen Variablen der Datei /etc/bashrc
hinzufügen.
Erstellen Sie ein go/
-Verzeichnis im Home-Verzeichnis: C:\Users\<username>\go
.