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

Você pode fazer download da extensão Blockchain App Builder para Visual Studio Code na 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 no sistema local, instale 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 as mencionadas 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.19.3). O Blockchain App Builder também pode funcionar 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.19.3, clique em Definições do Kubernetes > Tempo de Execução do Contêiner.
  • A última versão do Node.js versão 18 (testada com 18.15.0 e 18.16.0), e npm v8.x ou 9.x (testada com 9.5.0 e 9.5.1)

    Verifique a versão 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 o Node.js e o 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 do Node.js anteriores ou posteriores à versão 18.

  • Go v1.23.2 ou posterior, mas não Go v1.24 ou posterior. Após 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 e-mail 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 de nvm para instalar Node.js e npm permite executar mais comandos sem sudo.
  1. Informe o seguinte comando para instalar o nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Adicione o seguinte trecho de código 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 log-out e, em seguida, efetue log-in novamente no sistema operacional.
  4. Insira o seguinte comando para verificar a instalação do nvm:
    nvm version
  5. Insira o seguinte comando para instalar Node.js e npm:
    nvm install 18.16.0
  6. Insira 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 última versão do Node.js versão 18 (testada com 18.15.0 e 18.16.0), e npm v8.x ou v9.x (testada com 9.5.0 e 9.5.1)

    Verifique a versão 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 o Node.js e o 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 do Node.js anteriores ou posteriores à versão 18.

  • Go v1.23.2 ou posterior, mas não Go v1.24 ou posterior. Após 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 e-mail 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 de nvm para instalar Node.js e npm permite executar mais comandos sem sudo.
  1. Informe o seguinte comando para instalar o nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Adicione o seguinte trecho de código 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 log-out e, em seguida, efetue log-in novamente no sistema operacional.
  4. Insira o seguinte comando para verificar a instalação do nvm:
    nvm version
  5. Insira o seguinte comando para instalar Node.js e npm:
    nvm install 18.16.0
  6. Insira 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.19.3). O Blockchain App Builder também pode funcionar com o Docker, mas foi testado e verificado com o Rancher Desktop.
  • A versão 18 mais recente do Node.js (testada com 18.15.0 e 18.16.0). Não use versões do Node.js anteriores ou posteriores à versão 18.
  • npm v8.x ou v9.x (testado com 9.5.0 e 9.5.1)
  • Go v1.23.2 ou posterior, mas não Go v1.24 ou posterior. Após 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 e-mail 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 Área de Trabalho do Rancher

Siga as etapas abaixo para instalar o Rancher Desktop no Microsoft Windows.
  1. Se o Docker estiver instalado no 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.19.3, clique em Definições do Kubernetes > Tempo de Execução do Contêiner.

Instalar a Extensão do 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 de Código do Visual Studio.
  2. No Visual Studio Code, abra o painel Extensões e, no menu Mais Ações, selecione Instalar no 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 Visual Studio Code 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 YAML, instale a extensão Suporte ao Idioma YAML 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.

A CLI (interface de linha de comando) do Blockchain App Builder será instalada automaticamente como parte da extensão do Visual Studio Code se você ainda não a 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, você deve definir a variável de ambiente GOPATH. Isso permite que Go localize seu espaço de trabalho e execute seu código.

Antes de definir a variável de ambiente GOPATH, verifique se existe 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
Depois de editar o arquivo, execute o seguinte comando para fazer suas alterações entrarem em vigor imediatamente:
source ~/.bash_profile

Como alternativa, você pode aplicar a alteração no nível do sistema adicionando as variáveis anteriores ao arquivo /etc/bashrc.

Antes de definir a variável de ambiente GOPATH, verifique se existe 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
Depois de editar o arquivo, execute o seguinte comando para fazer suas alterações entrarem em vigor imediatamente:
source ~/.bash_profile

Como alternativa, você pode aplicar a alteração no nível do sistema adicionando as variáveis anteriores ao arquivo /etc/bashrc.

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