1. Utilizzo di Oracle Blockchain Platform
  2. Crea codici concatenati con App Builder di blockchain con uso ridotto di codice
  3. Utilizzo dell'estensione Blockchain App Builder per Visual Studio Code
  4. Installare e configurare l'estensione Blockchain App Builder per Visual Studio Code

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

L'estensione Blockchain App Builder per Visual Studio Code può essere scaricata tramite la console di Oracle Blockchain Platform.

Sono supportate le piattaforme seguenti:
  • 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 suoi compilatori. Se si utilizzano versioni dei prerequisiti diverse da quelle indicate nella sezione seguente, la distribuzione del codice concatenato in una rete Oracle Blockchain Platform remota 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 viene interrotto.

Prerequisiti

  • Rancher Desktop (testato con 1.4.1). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop. Se si prevede di utilizzare Rancher Desktop, disinstallare Docker completamente 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 dei container in Rancher Desktop 1.4.1, fare clic su Impostazioni Kubernetes, quindi su Runtime container.
  • L'ultima versione 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 comando seguente: 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, quindi riavviare Visual Studio Code in modo che la versione venga rilevata dalla pagina Prerequisiti.

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

  • Vai alla versione v1.20.10. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.

    Controllare la versione Go eseguendo il comando seguente: go version

  • Se si prevede di utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e configurare il nome utente e l'indirizzo di posta elettronica come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo di posta elettronica 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 comando seguente: code --version

Installazione di Node.js e npm mediante nvm

L'utilizzo di nvm per installare Node.js e npm consente di eseguire più comandi senza sudo.
  1. Immettere 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. Disconnettersi, quindi accedere nuovamente al sistema operativo.
  4. Immettere il comando seguente per verificare l'installazione di nvm:
    nvm version
  5. Immettere il comando seguente per installare Node.js e npm:
    nvm install 18.16.0
  6. Immettere il comando seguente per impostare Node.js 18.16.0 come 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
  • Composizione Docker versione 1.23.0 o successiva
  • L'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 comando seguente: 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, quindi riavviare Visual Studio Code in modo che la versione venga rilevata dalla pagina Prerequisiti.

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

  • Vai alla versione v1.20.10. Dopo aver installato Blockchain App Builder, vedere Impostazione aggiuntiva per i progetti Go Chaincode.

    Controllare la versione Go eseguendo il comando seguente: go version

  • Se si prevede di utilizzare la funzione di sincronizzazione di Blockchain App Builder, installare Git e configurare il nome utente e l'indirizzo di posta elettronica come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo di posta elettronica 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 comando seguente: code --version

Installazione di Node.js e npm mediante nvm

L'utilizzo di nvm per installare Node.js e npm consente di eseguire più comandi senza sudo.
  1. Immettere 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. Disconnettersi, quindi accedere nuovamente al sistema operativo.
  4. Immettere il comando seguente per verificare l'installazione di nvm:
    nvm version
  5. Immettere il comando seguente per installare Node.js e npm:
    nvm install 18.16.0
  6. Immettere il comando seguente per impostare Node.js 18.16.0 come 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 1.4.1). Blockchain App Builder può anche funzionare con Docker, ma è stato testato e verificato con Rancher Desktop.
  • L'ultima release di Node.js versione 18 (testata con le versioni 18.15.0 e 18.16.0). Non utilizzare versioni precedenti o successive alla versione 18 di Node.js.
  • npm v8.x o v9.x (testato con 9.5.0 e 9.5.1)
  • Vai alla versione 1.20.10. 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'indirizzo di posta elettronica come mostrato nei comandi riportati di seguito. Specificare il nome utente e l'indirizzo di posta elettronica al posto di <your_name> e <email>. 
    git config --global user.name "<your_name>" 

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

Installa Rancher Desktop

Per installare Rancher Desktop in Microsoft Windows, procedere come segue.
  1. Se Docker è installato sul computer locale, disinstallarlo completamente.
  2. Scarica e installa 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 dei container in Rancher Desktop 1.4.1, fare clic su Impostazioni Kubernetes, quindi su Runtime container.

Installare l'estensione Blockchain App Builder

  1. Scaricare l'estensione dalla scheda Strumenti di sviluppo 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 dal menu Altre azioni selezionare Installa da VSIX.
  3. Individuare il file oracle-ochain-extension-x.x.x.vsix scaricato, quindi fare clic su Installa. Regolare 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 del 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 Supporto lingua YAML, 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.

Inoltre, 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, in modo da poter eseguire i comandi CLI da qualsiasi posizione nel file system.

Impostazione aggiuntiva per progetti codice concatenato Go

Per sviluppare un progetto Go, è necessario impostare la variabile di ambiente GOPATH. Ciò 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 effettive immediatamente 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 effettive immediatamente 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.