Installieren und Konfigurieren der Blockchain App Builder-Erweiterung für Visual Studio Code

Sie können die Blockchain App Builder-Erweiterung für Visual Studio Code von der Oracle Blockchain Platform-Konsole herunterladen.

Folgende Plattformen werden unterstützt:
  • 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 Oracle Blockchain Platform und seine Compiler. Wenn Sie andere Versionen der Voraussetzungen als die im folgenden Abschnitt genannten verwenden, verläuft das Deployment Ihres Chaincodes in einem Oracle Blockchain Platform-Remotenetzwerk möglicherweise nicht erfolgreich.

Wenn Sie Blockchain App Builder installieren, wird zuerst eine Voraussetzungsprüfung ausgeführt. Wenn die Prüfung der Voraussetzungen nicht erfolgreich verläuft, wird der Installationsprozess gestoppt.

Voraussetzungen

  • Rancher Desktop (geprüft mit 1.19.3). 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.19.3 zu prüfen, klicken Sie auf Kubernetes-Einstellungen > Containerlaufzeit.
  • 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 Node.js-Version, 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 oder nodenv 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 von der Seite Voraussetzungen erkannt wird.

    Verwenden Sie keine Versionen von Node.js, die früher oder später als Version 18 sind.

  • Gehen Sie zu Version 1.23.2 oder höher, aber nicht zu Version 1.24 oder höher. Informationen zum Installieren 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 das Synchronisierungsfeature 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 anstelle 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 Version von Visual Studio Code, indem Sie den folgenden Befehl ausführen: code --version

Installieren von Node.js und npm mit nvm

Wenn Sie nvm zur Installation von Node.js und npm verwenden, können Sie weitere Befehle ohne sudo ausführen.
  1. Geben Sie den folgenden Befehl zur Installation von nvm ein:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Fügen Sie das folgende Code-Snippet zur entsprechenden Datei 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
  3. Melden sie sich ab und dann wieder bei ihrem betriebssystem an.
  4. Geben Sie den folgenden Befehl ein, um die nvm-Installation zu prüfen:
    nvm version
  5. Geben Sie den folgenden Befehl ein, um Node.js und npm zu installieren:
    nvm install 18.16.0
  6. Geben Sie den folgenden Befehl ein, um Node.js 18.16.0 als Standard in nvm festzulegen:
    nvm alias default 18.16.0
    Die Ausgabe des Befehls lautet wie folgt:
    default -> 18.16.0 (-> v18.16.0)

Voraussetzungen

  • Docker v18.09.0 oder höher
  • Docker Compose v1.23.0 oder höher
  • Die neueste Version 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 Node.js-Version, 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 oder nodenv 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 von der Seite Voraussetzungen erkannt wird.

    Verwenden Sie keine Versionen von Node.js, die früher oder später als Version 18 sind.

  • Gehen Sie zu Version 1.23.2 oder höher, aber nicht zu Version 1.24 oder höher. Informationen zum Installieren 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 das Synchronisierungsfeature 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 anstelle 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 Version von Visual Studio Code, indem Sie den folgenden Befehl ausführen: code --version

Installieren von Node.js und npm mit nvm

Wenn Sie nvm zur Installation von Node.js und npm verwenden, können Sie weitere Befehle ohne sudo ausführen.
  1. Geben Sie den folgenden Befehl zur Installation von nvm ein:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Fügen Sie das folgende Code-Snippet zur entsprechenden Datei 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
  3. Melden sie sich ab und dann wieder bei ihrem betriebssystem an.
  4. Geben Sie den folgenden Befehl ein, um die nvm-Installation zu prüfen:
    nvm version
  5. Geben Sie den folgenden Befehl ein, um Node.js und npm zu installieren:
    nvm install 18.16.0
  6. Geben Sie den folgenden Befehl ein, um Node.js 18.16.0 als Standard in nvm festzulegen:
    nvm alias default 18.16.0
    Die Ausgabe des Befehls lautet wie folgt:
    default -> 18.16.0 (-> v18.16.0)

Voraussetzungen

  • Rancher Desktop (geprüft mit 1.19.3). Blockchain App Builder kann auch mit Docker arbeiten, wurde jedoch mit Rancher Desktop getestet und verifiziert.
  • Die neueste Version von Node.js Version 18 (getestet mit 18.15.0 und 18.16.0). Verwenden Sie keine Versionen von Node.js, die früher oder später als Version 18 sind.
  • npm v8.x oder v9.x (getestet mit 9.5.0 und 9.5.1)
  • Gehen Sie zu Version 1.23.2 oder höher, aber nicht zu Version 1.24 oder höher. Informationen zum Installieren von Blockchain App Builder finden Sie unter Zusätzliches Setup für Go Chaincode-Projekte.
  • Wenn Sie das Synchronisierungsfeature 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 anstelle von <your_name> und <email> an. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"

Rancher Desktop installieren

Gehen Sie folgendermaßen vor, um Rancher Desktop auf Microsoft Windows zu installieren.
  1. Wenn Docker auf Ihrem lokalen Computer installiert ist, deinstallieren Sie es vollständig.
  2. Laden Sie Rancher Desktop herunter und installieren Sie es.
  3. Nachdem der Installationsassistent abgeschlossen ist, führen Sie vor dem Öffnen von Rancher Desktop die folgenden Befehle aus:
    wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
  4. Öffnen Sie Rancher Desktop, um den Setup-Prozess abzuschließen.
  5. Stellen Sie nach der Installation von Rancher Desktop sicher, dass die Containerlaufzeit auf dockerd (moby) gesetzt ist. Um die Containerlaufzeit in Rancher Desktop 1.19.3 zu prüfen, klicken Sie auf Kubernetes-Einstellungen > Containerlaufzeit.

Blockchain App Builder-Erweiterung installieren

  1. Laden Sie die Erweiterung auf der Registerkarte Entwicklungstools 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.
  2. Öffnen Sie in Visual Studio Code den Bereich Erweiterungen, und wählen Sie im Menü Weitere Aktionen die Option Aus VSIX installieren aus.
  3. Suchen Sie die heruntergeladene Datei oracle-ochain-extension-x.x.x.vsix, und klicken Sie auf Install. (Korrigieren Sie den Namen der Datei .vsix für die Version, die Sie installieren.)
  4. Starten Sie Visual Studio Code neu, um die Installation der Erweiterung abzuschließen.
  5. Um die Validierungsfunktionen der Spezifikationsdatei zu verwenden, mit denen die Spezifikationsdatei beim Eingeben automatisch validiert wird, installieren Sie die YAML-Erweiterung von Red Hat. Ö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.

Die Blockchain App Builder-Befehlszeilenschnittstelle (CLI) wird automatisch als Teil der Erweiterung für Visual Studio Code installiert, wenn Sie sie noch nicht separat installiert haben. Die CLI-Befehle können von 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 aus ausführen können.

Weitere Einrichtung für Go Chaincode-Projekte

Um ein Go-Projekt zu entwickeln, müssen Sie die Umgebungsvariable GOPATH festlegen. Auf diese Weise können Sie Ihren Workspace suchen und Ihren Code ausführen.

Bevor Sie die Umgebungsvariable GOPATH festlegen, stellen Sie sicher, dass im Verzeichnis $HOME ein Ordner go/ vorhanden ist. Wenn nicht, geben Sie den folgenden Befehl ein, um ein go/-Verzeichnis in Ihrem Home-Verzeichnis zu erstellen:
mkdir $HOME/go
Legen Sie die Umgebungsvariable GOPATH fest, indem Sie die folgenden Variablen zur entsprechenden Datei hinzufügen: ~/.bash_profile, ~/.profile, ~/.bashrc oder ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Nachdem Sie die Datei bearbeitet haben, führen Sie den folgenden Befehl aus, damit die Änderungen sofort wirksam werden:
source ~/.bash_profile

Alternativ können Sie die Änderung systemweit anwenden, indem Sie die vorherigen Variablen zur Datei /etc/bashrc hinzufügen.

Bevor Sie die Umgebungsvariable GOPATH festlegen, stellen Sie sicher, dass im Verzeichnis $HOME ein Ordner go/ vorhanden ist. Wenn nicht, geben Sie den folgenden Befehl ein, um ein go/-Verzeichnis in Ihrem Home-Verzeichnis zu erstellen:
mkdir $HOME/go
Legen Sie die Umgebungsvariable GOPATH fest, indem Sie die folgenden Variablen zur entsprechenden Datei hinzufügen: ~/.bash_profile, ~/.profile, ~/.bashrc oder ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Nachdem Sie die Datei bearbeitet haben, führen Sie den folgenden Befehl aus, damit die Änderungen sofort wirksam werden:
source ~/.bash_profile

Alternativ können Sie die Änderung systemweit anwenden, indem Sie die vorherigen Variablen zur Datei /etc/bashrc hinzufügen.

Erstellen Sie ein go/-Verzeichnis im Home-Verzeichnis: C:\Users\<username>\go.