Instalar e Configurar a Extensão do Blockchain App Builder para o Visual Studio Code

A extensão Blockchain App Builder para o Visual Studio Code pode ser baixada por meio da console do Oracle Blockchain Platform.

As seguintes plataformas são suportadas:
  • macOS
  • Oracle Linux 8.0 ou 9.0
  • Microsoft Windows 10 ou 11

Pré-requisitos

Antes de instalar o Blockchain App Builder em seu sistema local, você deve instalar os pré-requisitos.

Observação:

O Blockchain App Builder coordena com o Oracle Blockchain Platform e seus compiladores. Se você usar qualquer versão dos pré-requisitos que não sejam os mencionados na seção a seguir, a implantação do seu chaincode em uma rede remota do Oracle Blockchain Platform poderá falhar.

Quando você instala o Blockchain App Builder, uma verificação de pré-requisitos é executada primeiro. Se a verificação de pré-requisitos falhar, o processo de instalação será interrompido.

Pré-requisitos

  • Rancher Desktop (testado com 1.4.1). O Blockchain App Builder também pode trabalhar com o Docker, mas foi testado e verificado com o Rancher Desktop. Se você planeja usar o Rancher Desktop, desinstale o Docker completamente antes de instalar o Rancher Desktop. Depois de instalar o Rancher Desktop, certifique-se de que o runtime do contêiner esteja definido como dockerd (moby). Para verificar o runtime do contêiner no Rancher Desktop 1.4.1, clique em Definições do Kubernetes > Runtime do Contêiner.
  • A versão mais recente do Node.js versão 18 (testado com 18.15.0 e 18.16.0) e npm v8.x ou 9.x (testado com 9.5.0 e 9.5.1)

    Verifique a versão do Node.js executando o seguinte comando: node --version

    Verifique a versão do npm executando o seguinte comando: npm --version

    Se você usar um gerenciador, como nvm ou nodenv, para instalar Node.js e npm, defina a versão padrão/global e reinicie o Visual Studio Code para que a versão seja detectada pela página Pré-requisitos.

    Não use versões de Node.js anteriores ou posteriores à versão 18.

  • Vá para a v1.23.2 ou posterior, mas não para a v1.24 ou posterior. Depois de instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos Go Chaincode.

    Verifique a versão Go executando o seguinte comando: go version

  • Se você planeja usar o recurso de sincronização do Blockchain App Builder, instale o Git e configure seu nome de usuário e email, conforme mostrado nos comandos a seguir. Especifique seu nome de usuário e endereço de e-mail no lugar de <your_name> e <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code versão 1.66.0 ou posterior

    Verifique a versão do Visual Studio Code executando o seguinte comando: code --version

Instalar Node.js e npm Usando nvm

O uso do nvm para instalar Node.js e npm permite executar mais comandos sem sudo.
  1. Informe o comando a seguir para instalar o nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Adicione o trecho de código a seguir ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.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. Efetue logout e login novamente no sistema operacional.
  4. Digite o seguinte comando para verificar a instalação do nvm:
    nvm version
  5. Digite o seguinte comando para instalar Node.js e npm:
    nvm install 18.16.0
  6. Digite o seguinte comando para definir Node.js 18.16.0 como o padrão no nvm:
    nvm alias default 18.16.0
    A saída do comando é o seguinte texto:
    default -> 18.16.0 (-> v18.16.0)

Pré-requisitos

  • Docker v18.09.0 ou posterior
  • Docker Compose v1.23.0 ou posterior
  • A versão mais recente do Node.js versão 18 (testado com 18.15.0 e 18.16.0) e npm v8.x ou v9.x (testado com 9.5.0 e 9.5.1)

    Verifique a versão do Node.js executando o seguinte comando: node --version

    Verifique a versão do npm executando o seguinte comando: npm --version

    Se você usar um gerenciador, como nvm ou nodenv, para instalar Node.js e npm, defina a versão padrão/global e reinicie o Visual Studio Code para que a versão seja detectada pela página Pré-requisitos.

    Não use versões de Node.js anteriores ou posteriores à versão 18.

  • Vá para a v1.23.2 ou posterior, mas não para a v1.24 ou posterior. Depois de instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos Go Chaincode.

    Verifique a versão Go executando o seguinte comando: go version

  • Se você planeja usar o recurso de sincronização do Blockchain App Builder, instale o Git e configure seu nome de usuário e email, conforme mostrado nos comandos a seguir. Especifique seu nome de usuário e endereço de e-mail no lugar de <your_name> e <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code versão 1.66.0 ou posterior

    Verifique a versão do Visual Studio Code executando o seguinte comando: code --version

Instalar Node.js e npm Usando nvm

O uso do nvm para instalar Node.js e npm permite executar mais comandos sem sudo.
  1. Informe o comando a seguir para instalar o nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Adicione o trecho de código a seguir ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.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. Efetue logout e login novamente no sistema operacional.
  4. Digite o seguinte comando para verificar a instalação do nvm:
    nvm version
  5. Digite o seguinte comando para instalar Node.js e npm:
    nvm install 18.16.0
  6. Digite o seguinte comando para definir Node.js 18.16.0 como o padrão no nvm:
    nvm alias default 18.16.0
    A saída do comando é o seguinte texto:
    default -> 18.16.0 (-> v18.16.0)

Pré-requisitos

  • Rancher Desktop (testado com 1.4.1). O Blockchain App Builder também pode trabalhar com o Docker, mas foi testado e verificado com o Rancher Desktop.
  • A versão mais recente do Node.js versão 18 (testado com 18.15.0 e 18.16.0). Não use versões de Node.js anteriores ou posteriores à versão 18.
  • npm v8.x ou v9.x (testado com 9.5.0 e 9.5.1)
  • Vá para a v1.23.2 ou posterior, mas não para a v1.24 ou posterior. Depois de instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos Go Chaincode.
  • Se você quiser usar o recurso de sincronização do Blockchain App Builder, instale o Git e configure seu nome de usuário e email, conforme mostrado nos comandos a seguir. Especifique seu nome de usuário e endereço de e-mail no lugar de <your_name> e <email>. 
    git config --global user.name "<your_name>" 

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

Instalar o Rancher Desktop

Siga as etapas abaixo para instalar o Rancher Desktop no Microsoft Windows.
  1. Se o Docker estiver instalado em seu computador local, desinstale-o completamente.
  2. Baixe e instale o Rancher Desktop.
  3. Após a conclusão do assistente de instalação, antes de abrir o Rancher Desktop, execute os seguintes comandos:
    wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
  4. Abra o Rancher Desktop para concluir o processo de configuração.
  5. Depois de instalar o Rancher Desktop, certifique-se de que o runtime do contêiner esteja definido como dockerd (moby). Para verificar o runtime do contêiner no Rancher Desktop 1.4.1, clique em Definições do Kubernetes > Runtime do Contêiner.

Instalar a Extensão Blockchain App Builder

  1. Faça download da extensão na guia Ferramentas do Desenvolvedor no painel Blockchain App Builder da console do Oracle Blockchain Platform. No painel Blockchain App Builder, na seção Download, selecione Extensão do Código Visual Studio.
  2. No Visual Studio Code, abra o painel Extensões e, no menu Mais Ações, selecione Instalar em VSIX.
  3. Localize o arquivo oracle-ochain-extension-x.x.x.vsix submetido a download e clique em Instalar. (Ajuste o nome do arquivo .vsix para a versão que você está instalando.)
  4. Reinicie o Código do Visual Studio para concluir a instalação da extensão.
  5. Para usar as funções de validação do arquivo de especificação, que validam automaticamente o arquivo de especificação conforme você digita, instale a extensão YAML da Red Hat. Abra o painel Extensões, procure o YAML, instale a extensão YAML Language Support e reinicie o Visual Studio Code.

Após a instalação, você pode usar o ícone do Oracle Blockchain App Builder no lado esquerdo do Visual Studio Code para abrir o painel Blockchain App Builder.

Além disso, a interface de linha de comando (CLI) do Blockchain App Builder é instalada automaticamente como parte da extensão do Visual Studio Code se você ainda não tiver instalado separadamente. Os comandos da CLI podem ser executados em qualquer aplicativo de terminal, incluindo a janela da console do Visual Studio Code. O Blockchain App Builder é instalado globalmente, para que você possa executar os comandos da CLI de qualquer local no sistema de arquivos.

Configuração Adicional para Projetos Go Chaincode

Para desenvolver um projeto Go, defina a variável de ambiente GOPATH. Isso permite que você localize seu espaço de trabalho e execute seu código.

Antes de definir a variável de ambiente GOPATH, certifique-se de que exista uma pasta go/ no diretório $HOME. Caso contrário, digite o seguinte comando para criar um diretório go/ no diretório home:
mkdir $HOME/go
Defina sua variável de ambiente GOPATH adicionando as seguintes variáveis ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Após editar o arquivo, execute o seguinte comando para fazer com que as alterações entrem em vigor imediatamente:
source ~/.bash_profile

Como alternativa, você pode aplicar a alteração em todo o sistema adicionando as variáveis anteriores ao arquivo /etc/bashrc.

Antes de definir a variável de ambiente GOPATH, certifique-se de que exista uma pasta go/ no diretório $HOME. Caso contrário, digite o seguinte comando para criar um diretório go/ no diretório home:
mkdir $HOME/go
Defina sua variável de ambiente GOPATH adicionando as seguintes variáveis ao arquivo aplicável: ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Após editar o arquivo, execute o seguinte comando para fazer com que as alterações entrem em vigor imediatamente:
source ~/.bash_profile

Como alternativa, você pode aplicar a alteração em todo o sistema adicionando as variáveis anteriores ao arquivo /etc/bashrc.

Crie um diretório go/ em seu diretório home: C:\Users\<username>\go.