1. Uso de Oracle Blockchain Platform
  2. Creación de códigos de cadenas con el creador de aplicaciones de blockchain de poco código
  3. Uso de la extensión de Blockchain App Builder para Visual Studio Code
  4. Instalación y configuración de la extensión de Blockchain App Builder para Visual Studio Code

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
  • 10 o 11 de Microsoft Windows

Requisitos

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

Note:

Blockchain App Builder se coordina con Oracle Blockchain Platform y sus compiladores. Si utiliza cualquier versión de los requisitos que no sean los mencionados 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 completamente 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 del contenedor en Rancher Desktop 1.4.1, haga clic en Configuración de Kubernetes y, a continuación, en Tiempo de ejecución del contenedor.
  • La última versión de Node.js versión 18 (probada con las versiones 18.15.0 y 18.16.0) y npm v8.x o 9.x (probada con las versiones 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 se detecte en la página Requisitos.

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

  • Versión de Go v1.20.10. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos de Go Chaincode.

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

  • Si planea 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>"
  • Visual Studio Code versión 1.66.0 o posterior

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

Instale 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 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 el valor por defecto 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 las versiones 18.15.0 y 18.16.0) y npm v8.x o v9.x (probada con las versiones 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 se detecte en la página Requisitos.

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

  • Versión de Go v1.20.10. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos de Go Chaincode.

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

  • Si planea 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>"
  • Visual Studio Code versión 1.66.0 o posterior

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

Instale 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 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 el valor por defecto 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 v1.20.10. Después de instalar Blockchain App Builder, consulte Configuración adicional para proyectos de 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 del contenedor en Rancher Desktop 1.4.1, haga clic en Configuración de Kubernetes y, a continuación, en Tiempo de ejecución del contenedor.

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

  1. Descargue la extensión en el separador Herramientas de desarrollador del panel Creador de aplicaciones de blockchain de la consola de Oracle Blockchain Platform. En el panel Creador de aplicaciones de blockchain, en la sección Descargar, seleccione Extensión de Visual Studio Code.
  2. En Visual Studio Code, abra el panel Extensiones y, a continuación, en el menú Más acciones, seleccione Instalar desde VSIX.
  3. Localice 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 del archivo de especificación, que validan automáticamente el archivo de especificación a medida que escribe, instale la extensión YAML de Red Hat. Abra el panel Extensiones, busque YAML, instale la extensión de soporte de idioma YAML y, a continuación, reinicie Visual Studio Code.

Después de la instalación, puede utilizar el icono Creador de aplicaciones de Oracle Blockchain en el lado izquierdo 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 proyectos de código de cadenas de Go

Para desarrollar un proyecto Go, debe definir la variable de entorno GOPATH. Esto permite a Go localizar su espacio de trabajo y ejecutar su 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 surtan efecto 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 surtan efecto 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.