Instalación y configuración de la extensión de Blockchain App Builder para Visual Studio Code

La extensión Blockchain App Builder para Visual Studio Code se puede descargar a través de la consola de Oracle Blockchain Platform.

Se admiten las siguientes plataformas:
  • macOS
  • Oracle Linux 8.0 o 9.0
  • Microsoft Windows 10 o 11

Requisitos

Antes de instalar Blockchain App Builder en el sistema local, debe instalar los requisitos previos.

Note:

Blockchain App Builder se coordina con Oracle Blockchain Platform y sus compiladores. Si utiliza versiones de los requisitos que no sean las mencionadas en la siguiente sección, puede que falle el despliegue del código de cadenas en una red remota de Oracle Blockchain Platform.

Al instalar Blockchain App Builder, se ejecuta primero una comprobación de requisitos. Si la comprobación de requisitos falla, el proceso de instalación se detiene.

Requisitos

  • Rancher Desktop (probado con 1.4.1). Blockchain App Builder también puede funcionar con Docker, pero se ha probado y verificado con Rancher Desktop. Si tiene previsto utilizar Rancher Desktop, desinstale Docker por completo antes de instalar Rancher Desktop. Después de instalar Rancher Desktop, asegúrese de que el tiempo de ejecución del contenedor esté establecido en dockerd (moby). Para verificar el tiempo de ejecución de contenedor en Rancher Desktop 1.4.1, haga clic en Configuración de Kubernetes > Tiempo de ejecución de contenedor.
  • La última versión de Node.js versión 18 (probada con 18.15.0 y 18.16.0) y npm v8.x o 9.x (probada con 9.5.0 y 9.5.1)

    Compruebe la versión Node.js ejecutando el siguiente comando: node --version

    Compruebe la versión de npm ejecutando el siguiente comando: npm --version

    Si utiliza un gestor como nvm o nodenv para instalar Node.js y npm, defina la versión por defecto/global y, a continuación, reinicie Visual Studio Code para que la versión sea detectada por la página Requisitos.

    No utilice versiones de Node.js anteriores o posteriores a la versión 18.

  • Vaya a la versión 1.23.2 o posterior, pero no a la versión 1.24 o posterior. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos Go Chaincode.

    Compruebe la versión Go ejecutando el siguiente comando: go version

  • Si planea usar la función de sincronización de Blockchain App Builder, instale Git y configure su nombre de usuario y correo electrónico como se muestra en los siguientes comandos. Especifique el nombre de usuario y la dirección de correo electrónico en lugar de <your_name> y <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code versión 1.66.0 o posterior

    Compruebe la versión de Visual Studio Code ejecutando el siguiente comando: code --version

Instalación de Node.js y npm mediante nvm

El uso de nvm para instalar Node.js y npm le permite ejecutar más comandos sin sudo.
  1. Introduzca el siguiente comando para instalar nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Agregue el siguiente fragmento de código al archivo aplicable: ~/.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. Cierre sesión y, a continuación, inicie sesión de nuevo en el sistema operativo.
  4. Introduzca el siguiente comando para verificar la instalación de nvm:
    nvm version
  5. Introduzca el siguiente comando para instalar Node.js y npm:
    nvm install 18.16.0
  6. Introduzca el siguiente comando para definir Node.js 18.16.0 como valor predeterminado en nvm:
    nvm alias default 18.16.0
    La salida del comando es el siguiente texto:
    default -> 18.16.0 (-> v18.16.0)

Requisitos

  • Docker v18.09.0 o posterior
  • Docker Compose v1.23.0 o posterior
  • La última versión de Node.js versión 18 (probada con 18.15.0 y 18.16.0) y npm v8.x o v9.x (probada con 9.5.0 y 9.5.1)

    Compruebe la versión Node.js ejecutando el siguiente comando: node --version

    Compruebe la versión de npm ejecutando el siguiente comando: npm --version

    Si utiliza un gestor como nvm o nodenv para instalar Node.js y npm, defina la versión por defecto/global y, a continuación, reinicie Visual Studio Code para que la versión sea detectada por la página Requisitos.

    No utilice versiones de Node.js anteriores o posteriores a la versión 18.

  • Vaya a la versión 1.23.2 o posterior, pero no a la versión 1.24 o posterior. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos Go Chaincode.

    Compruebe la versión Go ejecutando el siguiente comando: go version

  • Si planea usar la función de sincronización de Blockchain App Builder, instale Git y configure su nombre de usuario y correo electrónico como se muestra en los siguientes comandos. Especifique el nombre de usuario y la dirección de correo electrónico en lugar de <your_name> y <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code versión 1.66.0 o posterior

    Compruebe la versión de Visual Studio Code ejecutando el siguiente comando: code --version

Instalación de Node.js y npm mediante nvm

El uso de nvm para instalar Node.js y npm le permite ejecutar más comandos sin sudo.
  1. Introduzca el siguiente comando para instalar nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Agregue el siguiente fragmento de código al archivo aplicable: ~/.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. Cierre sesión y, a continuación, vuelva a iniciar sesión en su sistema operativo.
  4. Introduzca el siguiente comando para verificar la instalación de nvm:
    nvm version
  5. Introduzca el siguiente comando para instalar Node.js y npm:
    nvm install 18.16.0
  6. Introduzca el siguiente comando para definir Node.js 18.16.0 como valor predeterminado en nvm:
    nvm alias default 18.16.0
    La salida del comando es el siguiente texto:
    default -> 18.16.0 (-> v18.16.0)

Requisitos

  • Rancher Desktop (probado con 1.4.1). Blockchain App Builder también puede funcionar con Docker, pero se ha probado y verificado con Rancher Desktop.
  • La última versión de Node.js versión 18 (probada con las versiones 18.15.0 y 18.16.0). No utilice versiones de Node.js anteriores o posteriores a la versión 18.
  • npm v8.x o v9.x (probado con 9.5.0 y 9.5.1)
  • Vaya a la versión 1.23.2 o posterior, pero no a la versión 1.24 o posterior. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos Go Chaincode.
  • Si desea utilizar la función de sincronización de Blockchain App Builder, instale Git y configure su nombre de usuario y correo electrónico como se muestra en los siguientes comandos. Especifique el nombre de usuario y la dirección de correo electrónico en lugar de <your_name> y <email>. 
    git config --global user.name "<your_name>" 

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

Instalación de Rancher Desktop

Complete los siguientes pasos para instalar Rancher Desktop en Microsoft Windows.
  1. Si Docker está instalado en el equipo local, desinstálelo por completo.
  2. Descargue e instale Rancher Desktop.
  3. Una vez finalizado el asistente de instalación, antes de abrir Rancher Desktop, ejecute los siguientes comandos:
    wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
  4. Abra Rancher Desktop para completar el proceso de configuración.
  5. Después de instalar Rancher Desktop, asegúrese de que el tiempo de ejecución del contenedor esté establecido en dockerd (moby). Para verificar el tiempo de ejecución de contenedor en Rancher Desktop 1.4.1, haga clic en Configuración de Kubernetes > Tiempo de ejecución de contenedor.

Instalación de la extensión de Blockchain App Builder

  1. Descargue la extensión del separador Herramientas para desarrolladores del panel Creador de aplicaciones de cadena de bloques de la consola de Oracle Blockchain Platform. En el panel Creador de aplicaciones de blockchain, en la sección Descargar, seleccione Extensión de código de Visual Studio.
  2. En Visual Studio Code, abra el panel Extensiones y, a continuación, en el menú Más acciones, seleccione Instalar desde VSIX.
  3. Busque el archivo oracle-ochain-extension-x.x.x.vsix descargado y, a continuación, haga clic en Instalar. (Ajuste el nombre del archivo .vsix para la versión que está instalando).
  4. Reinicie Visual Studio Code para completar la instalación de la extensión.
  5. Para utilizar las funciones de validación de archivos de especificación, que validan automáticamente el archivo de especificación a medida que escribe, instale la extensión YAML desde Red Hat. Abra el panel Extensiones, busque YAML, instale la extensión de compatibilidad de idioma YAML y, a continuación, reinicie Visual Studio Code.

Después de la instalación, puede utilizar el icono Oracle Blockchain App Builder en la parte izquierda de Visual Studio Code para abrir el panel Creador de aplicaciones de blockchain.

Además, la interfaz de línea de comandos (CLI) de Blockchain App Builder se instala automáticamente como parte de la extensión de Visual Studio Code si aún no la ha instalado por separado. Los comandos de la CLI se pueden ejecutar desde cualquier aplicación de terminal, incluida la ventana de la consola de Visual Studio Code. Blockchain App Builder está instalado globalmente, por lo que puede ejecutar los comandos de la CLI desde cualquier ubicación del sistema de archivos.

Configuración adicional para Go Chaincode Projects

Para desarrollar un proyecto Go, debe definir la variable de entorno GOPATH. Esto permite a Go localizar el espacio de trabajo y ejecutar el código.

Antes de definir la variable de entorno GOPATH, asegúrese de que existe una carpeta go/ en el directorio $HOME. Si no es así, introduzca el siguiente comando para crear un directorio go/ en el directorio raíz:
mkdir $HOME/go
Defina la variable de entorno GOPATH agregando las siguientes variables al archivo aplicable: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Después de editar el archivo, ejecute el siguiente comando para que los cambios se apliquen inmediatamente:
source ~/.bash_profile

Como alternativa, puede aplicar el cambio en todo el sistema agregando las variables anteriores al archivo /etc/bashrc.

Antes de definir la variable de entorno GOPATH, asegúrese de que existe una carpeta go/ en el directorio $HOME. Si no es así, introduzca el siguiente comando para crear un directorio go/ en el directorio raíz:
mkdir $HOME/go
Defina la variable de entorno GOPATH agregando las siguientes variables al archivo aplicable: ~/.bash_profile, ~/.profile, ~/.bashrc o ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Después de editar el archivo, ejecute el siguiente comando para que los cambios se apliquen inmediatamente:
source ~/.bash_profile

Como alternativa, puede aplicar el cambio en todo el sistema agregando las variables anteriores al archivo /etc/bashrc.

Cree un directorio go/ en el directorio raíz: C:\Users\<username>\go.