Installare e configurare l'estensione App Builder Blockchain per Visual Studio Code

È possibile scaricare l'estensione Blockchain App Builder per Visual Studio Code dalla console di Oracle Blockchain Platform.

Sono supportate le seguenti piattaforme:
  • macOS
  • Oracle Linux 8.0 o 9.0
  • Microsoft Windows 10 o 11

Prerequisiti

Prima di installare Blockchain App Builder nel sistema locale, è necessario installare i prerequisiti.

Nota

Blockchain App Builder si coordina con Oracle Blockchain Platform e i relativi compilatori. Se si utilizzano versioni dei prerequisiti diverse da quelle menzionate nella sezione seguente, la distribuzione del codice concatenato in una rete remota di Oracle Blockchain Platform potrebbe non riuscire.

Quando si installa Blockchain App Builder, viene eseguito prima un controllo dei prerequisiti. Se il controllo dei prerequisiti non riesce, il processo di installazione si interrompe.

Prerequisiti

  • Rancher Desktop (testato con la versione 1.19.3). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop. Se si prevede di utilizzare Rancher Desktop, disinstallare completamente Docker prima di installare Rancher Desktop. Dopo aver installato Rancher Desktop, assicurarsi che il runtime del contenitore sia impostato su dockerd (moby). Per verificare il runtime del contenitore in Rancher Desktop 1.19.3, fare clic su Impostazioni Kubernetes > Runtime del contenitore.
  • Ultima release di Node.js versione 18 (testata con 18.15.0 e 18.16.0) e npm v8.x o 9.x (testata con 9.5.0 e 9.5.1)

    Controllare la versione Node.js eseguendo il seguente comando: node --version

    Controllare la versione npm eseguendo il seguente comando: npm --version

    Se si utilizza un manager come nvm o nodenv per installare Node.js e npm, impostare la versione predefinita/globale e quindi riavviare Visual Studio Code in modo che la versione venga rilevata dalla pagina Prerequisiti.

    Non utilizzare versioni di Node.js precedenti o successive alla versione 18.

  • Andare alla versione 1.23.2 o successiva, ma non alla versione 1.24 o successiva. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.

    Controllare la versione Go eseguendo il seguente comando: go version

  • Se si prevede di utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e configurare il nome utente e l'e-mail come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo e-mail al posto di <your_name> e <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code versione 1.66.0 o successiva

    Controllare la versione di Visual Studio Code eseguendo il seguente comando: code --version

Installare Node.js e npm utilizzando nvm

L'utilizzo di nvm per installare Node.js e npm consente di eseguire più comandi senza sudo.
  1. Inserire il seguente comando per installare nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Aggiungere il seguente snippet di codice al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.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. Eseguire il logout e quindi nuovamente il login al sistema operativo.
  4. Immettere il comando seguente per verificare l'installazione di nvm:
    nvm version
  5. Inserire il comando seguente per installare Node.js e npm:
    nvm install 18.16.0
  6. Inserire il comando seguente per impostare Node.js 18.16.0 come valore predefinito in nvm:
    nvm alias default 18.16.0
    L'output del comando è il testo seguente:
    default -> 18.16.0 (-> v18.16.0)

Prerequisiti

  • Docker v18.09.0 o versione successiva
  • Docker Compose v1.23.0 o versione successiva
  • Ultima release di Node.js versione 18 (testata con 18.15.0 e 18.16.0) e npm v8.x o v9.x (testata con 9.5.0 e 9.5.1)

    Controllare la versione Node.js eseguendo il seguente comando: node --version

    Controllare la versione npm eseguendo il seguente comando: npm --version

    Se si utilizza un manager come nvm o nodenv per installare Node.js e npm, impostare la versione predefinita/globale e quindi riavviare Visual Studio Code in modo che la versione venga rilevata dalla pagina Prerequisiti.

    Non utilizzare versioni di Node.js precedenti o successive alla versione 18.

  • Andare alla versione 1.23.2 o successiva, ma non alla versione 1.24 o successiva. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.

    Controllare la versione Go eseguendo il seguente comando: go version

  • Se si prevede di utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e configurare il nome utente e l'e-mail come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo e-mail al posto di <your_name> e <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code versione 1.66.0 o successiva

    Controllare la versione di Visual Studio Code eseguendo il seguente comando: code --version

Installare Node.js e npm utilizzando nvm

L'utilizzo di nvm per installare Node.js e npm consente di eseguire più comandi senza sudo.
  1. Inserire il seguente comando per installare nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Aggiungere il seguente snippet di codice al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.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. Eseguire il logout e quindi nuovamente il login al sistema operativo.
  4. Immettere il comando seguente per verificare l'installazione di nvm:
    nvm version
  5. Inserire il comando seguente per installare Node.js e npm:
    nvm install 18.16.0
  6. Inserire il comando seguente per impostare Node.js 18.16.0 come valore predefinito in nvm:
    nvm alias default 18.16.0
    L'output del comando è il testo seguente:
    default -> 18.16.0 (-> v18.16.0)

Prerequisiti

  • Rancher Desktop (testato con la versione 1.19.3). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop.
  • Ultima release di Node.js versione 18 (testato con 18.15.0 e 18.16.0). Non utilizzare versioni di Node.js precedenti o successive alla versione 18.
  • npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
  • Andare alla versione 1.23.2 o successiva, ma non alla versione 1.24 o successiva. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.
  • Se si desidera utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e configurare il nome utente e l'e-mail come mostrato nei comandi seguenti. Specificare il nome utente e l'indirizzo e-mail al posto di <your_name> e <email>. 
    git config --global user.name "<your_name>" 

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

Installa desktop Rancher

Completare i seguenti passaggi per installare Rancher Desktop su Microsoft Windows.
  1. Se Docker è installato sul computer locale, disinstallarlo completamente.
  2. Scaricare e installare Rancher Desktop.
  3. Al termine dell'installazione guidata, prima di aprire Rancher Desktop, eseguire i seguenti comandi:
    wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
  4. Aprire Rancher Desktop per completare il processo di installazione.
  5. Dopo aver installato Rancher Desktop, assicurarsi che il runtime del contenitore sia impostato su dockerd (moby). Per verificare il runtime del contenitore in Rancher Desktop 1.19.3, fare clic su Impostazioni Kubernetes > Runtime del contenitore.

Installare l'estensione Blockchain App Builder

  1. Scaricare l'estensione dalla scheda Strumenti per sviluppatori nel riquadro Blockchain App Builder della console di Oracle Blockchain Platform. Nel riquadro Blockchain App Builder, nella sezione Scarica, selezionare Visual Studio Code Extension.
  2. In Visual Studio Code aprire il pannello Estensioni, quindi selezionare Installa da VSIX dal menu Altre azioni.
  3. Individuare il file oracle-ochain-extension-x.x.x.vsix scaricato, quindi fare clic su Installa. (Adattare il nome del file .vsix per la versione che si sta installando.)
  4. Riavviare Visual Studio Code per completare l'installazione dell'estensione.
  5. Per utilizzare le funzioni di convalida dei file di specifica, che convalidano automaticamente il file di specifica durante la digitazione, installare l'estensione YAML da Red Hat. Aprire il pannello Estensioni, cercare YAML, installare l'estensione YAML Language Support, quindi riavviare Visual Studio Code.

Dopo l'installazione, è possibile utilizzare l'icona Oracle Blockchain App Builder sul lato sinistro di Visual Studio Code per aprire il pannello Blockchain App Builder.

L'interfaccia della riga di comando (CLI) di Blockchain App Builder viene installata automaticamente come parte dell'estensione per Visual Studio Code se non è già stata installata separatamente. I comandi CLI possono essere eseguiti da qualsiasi applicazione terminale, inclusa la finestra della console di Visual Studio Code. Blockchain App Builder è installato a livello globale, quindi puoi eseguire i comandi CLI da qualsiasi posizione nel file system.

Impostazione aggiuntiva per Go Chaincode Projects

Per sviluppare un progetto Go, è necessario impostare la variabile di ambiente GOPATH. Consente di individuare l'area di lavoro ed eseguire il codice.

Prima di impostare la variabile di ambiente GOPATH, assicurarsi che nella directory $HOME esista una cartella go/. In caso contrario, immettere il comando seguente per creare una directory go/ nella directory home:
mkdir $HOME/go
Impostare la variabile di ambiente GOPATH aggiungendo le seguenti variabili al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Dopo aver modificato il file, eseguire il comando seguente per rendere immediatamente effettive le modifiche:
source ~/.bash_profile

In alternativa, è possibile applicare la modifica a livello di sistema aggiungendo le variabili precedenti al file /etc/bashrc.

Prima di impostare la variabile di ambiente GOPATH, assicurarsi che nella directory $HOME esista una cartella go/. In caso contrario, immettere il comando seguente per creare una directory go/ nella directory home:
mkdir $HOME/go
Impostare la variabile di ambiente GOPATH aggiungendo le seguenti variabili al file applicabile: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Dopo aver modificato il file, eseguire il comando seguente per rendere immediatamente effettive le modifiche:
source ~/.bash_profile

In alternativa, è possibile applicare la modifica a livello di sistema aggiungendo le variabili precedenti al file /etc/bashrc.

Creare una directory go/ nella directory home: C:\Users\<username>\go.