Creación de un proyecto de código de cadenas con la extensión de código de Visual Studio de Blockchain App Builder

Para crear un proyecto de código de cadenas con Blockchain App Builder, debe andamiar un proyecto de código de cadenas a partir de un archivo de especificación detallado. Esto genera un proyecto con todos los archivos necesarios.

Antecedentes

Blockchain App Builder inicializa y andamiaja un proyecto de código de cadenas listo para usar. En función de una entrada simple, el comando Crear nuevo código de cadena puede generar proyectos de código de cadena complejos con funciones como:
  • Varios activos (modelos) y sus comportamientos (controladores)
  • Generación automática de métodos CRUD (Crear/Leer/Actualizar/Suprimir) y no CRUD
  • Validación automática de argumentos
  • Distribución/desregulación de argumentos
  • Capacidad de persistencia transparente (ORM)
  • Soporte de consultas enriquecido
  • Soporte de datos transitorios y privados
  • Gestión de identidades

El proyecto generado sigue el patrón de modelo/controlador y decorador, que permite especificar las propiedades de un activo que se mantienen en el libro mayor como campos con tipo y ampliarlas con comportamientos y reglas de validación específicos. Esto reduce el número de líneas de código que pueden ayudar con la legibilidad y la escalabilidad.

Creación de un archivo de especificación

Primero debe crear un archivo de especificación de entrada. No puede modificar los archivos de especificación de ejemplo que se instalaron como parte de Blockchain App Builder, pero puede duplicarlos o utilizarlos como un archivo de referencia para sus propios archivos de especificación.

  1. En el panel Especificaciones, seleccione Crear nuevo archivo de especificación.
  2. En el panel Detalles de especificaciones, realice los siguientes pasos.
    • Introduzca el nombre del archivo de especificación.
    • Seleccione el tipo de archivo. Están soportados los formatos YAML y JSON.
    • Si lo desea, introduzca una descripción para el archivo.
    • La lista desplegable Archivo de Referencia permite generar el archivo de especificación a partir de un archivo del espacio de trabajo, si tiene un archivo que desea utilizar como plantilla. Si no se selecciona nada, el archivo creado estará vacío y podrá introducir la especificación desde cero.
    • Introduzca la ubicación en la que desea que el archivo de especificación se almacene en el sistema.
    Haga clic en Guardar.
El archivo de especificación se crea y se muestra en el panel Specifications (Especificaciones). Haga clic en él para abrirlo en el editor.

Importación de un archivo de especificación

Si tiene un archivo de especificación preexistente, puede importarlo.
  1. En el panel Especificaciones, haga clic en Más acciones y, a continuación, seleccione Especificación de importación.
  2. Busque el archivo y haga clic en Importar especificación.
El archivo de especificación se importa y se muestra en el panel Specifications (Especificaciones). Haga clic en él para abrirlo en el editor.

Duplicar un archivo de especificación

También puede duplicar un archivo de especificación que ya está en el panel Especificaciones haciendo clic con el botón derecho y seleccionando Duplicar. Haga clic con el botón derecho en el archivo y seleccione Cambiar nombre para actualizar el nombre.

Para obtener más información sobre el contenido de los archivos de especificaciones, consulte Archivo de especificación de entrada. Utilice esta información y las plantillas de especificación de ejemplo para crear el contenido de la especificación.

Validación de un archivo de especificación

Si ha instalado la extensión YAML Language Support, el archivo de especificación se valida automáticamente a medida que escribe. Las siguientes funciones de validación se admiten automáticamente:
  • Finalización del comando
  • Finalización de nodos escalares en los valores por defecto del esquema
  • Ayuda contextual al pasar el mouse sobre una propiedad o un método
  • sangrías para elementos de matriz a medida que escribe
  • Detección de errores de sintaxis

Andamios del proyecto Chaincode

Después de crear un archivo de especificación, puede generar un proyecto de código de cadenas.
  1. En el panel Códigos de Cadena, seleccione Crear Nuevo Código de Cadena.
  2. En el panel Detalles de código de cadena, realice los siguientes pasos.
    • Introduzca el nombre del proyecto de código de cadenas.
    • Seleccione el idioma: TypeScript o Go.
    • Seleccione el archivo de especificación que está utilizando para crear el código de cadena.
    • Introduzca la ubicación o el dominio Go en el que desea que se cree el proyecto en el entorno de desarrollo local.
    Haga clic en Create.
Cuando se cree el proyecto, éste se mostrará en el panel Códigos de Cadena. Todos los archivos requeridos por el código de cadena estarán en el proyecto. Para obtener una descripción general detallada de los archivos creados, consulte: Para obtener una visión general detallada de un proyecto basado en token, consulte también:

Note:

  • El panel Códigos de cadena permite abrir y trabajar con contenido en el proyecto de código de cadena, pero no permite agregar, suprimir ni cambiar el nombre de los archivos del proyecto. Para ello, haga clic con el botón derecho en el proyecto y seleccione Abrir en el explorador. Esto abre el proyecto en la vista Visual Studio Code Explorer.
  • La supresión o el cambio de nombre de los archivos en el proyecto de código de cadena pueden romper el vínculo entre los archivos del proyecto y el archivo de especificación utilizado para crearlo. Si tiene previsto sincronizar el código entre los dos, no cambie los nombres de archivo.

Importar un proyecto de código de cadena existente

Si ha creado un proyecto de código de cadenas a través de la CLI o ha limpiado el contenido de blockchain de Visual Studio Code y desea importar un proyecto guardado localmente, en el panel Códigos de cadena, haga clic en el icono Más acciones... y seleccione Importar código de cadena. Vaya al proyecto y haga clic en Importar código de cadena.