1. Usando o Oracle Blockchain Platform
  2. Crie Chaincodes com o Low-Code Blockchain App Builder
  3. Usando a Extensão do Blockchain App Builder para o Visual Studio Code
  4. Instalar e Configurar a Extensão do Blockchain App Builder para o Visual Studio Code

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

A extensão Blockchain App Builder para Visual Studio Code pode ser baixada por meio do 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 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 além das 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.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, verifique se o tempo de execução do contêiner está definido como dockerd (moby). Para verificar o runtime do contêiner no Rancher Desktop 1.4.1, clique em Definições do Kubernetes e, em seguida, em Runtime do Contêiner.
  • A versão mais recente 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 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.

  • Go versão v1.20.10. Após instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos de Chaincode Go.

    Verifique a versão do 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

Instale Node.js e npm usando nvm

O uso do nvm para instalar o Node.js e o npm permite executar mais comandos sem o 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 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 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. Informe 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 (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 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.

  • Go versão v1.20.10. Após instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos de Chaincode Go.

    Verifique a versão do 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

Instale Node.js e npm usando nvm

O uso do nvm para instalar o Node.js e o npm permite executar mais comandos sem o 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 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 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. Informe 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 18 mais recente do Node.js (testada 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 versão 1.20.10. Após instalar o Blockchain App Builder, consulte Configuração Adicional para Projetos de Chaincode Go.
  • 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 Á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. Depois que o assistente de instalação for concluído, 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, verifique se o tempo de execução do contêiner está definido como dockerd (moby). Para verificar o runtime do contêiner no Rancher Desktop 1.4.1, clique em Definições do Kubernetes e, em seguida, em Runtime 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 Fazer Download, selecione Extensão do Visual Studio Code.
  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 de arquivo de especificação, que validam automaticamente o arquivo de especificação à medida que você digita, instale a extensão YAML da Red Hat. Abra o painel Extensões, procure 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 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 está instalado globalmente, para que você possa executar os comandos da CLI de qualquer local no sistema de arquivos.

Configuração Adicional para Projetos de Codificação Ir

Para desenvolver um projeto Go, defina a variável de ambiente GOPATH. Isso permite localizar seu espaço de trabalho e executar 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, informe 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 com que suas 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, verifique se existe uma pasta go/ no diretório $HOME. Caso contrário, informe 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 com que suas 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.