Creación de un proyecto de código de cadena con la extensión Blockchain App Builder VS Code

Para crear un proyecto de código de cadena al utilizar el creador de aplicaciones de blockchain, debe andamiar un proyecto de código de cadena desde un archivo de especificación detallado. Esto genera un proyecto con todos los archivos que necesita.

Antecedentes

Blockchain App Builder inicializa y andamiaje un proyecto de código de cadenas listo para usar. En función de una entrada simple, Crear nuevo código de cadena puede generar proyectos complejos de código de cadena con funciones como:

Varios activos (modelos) y sus comportamientos (controladores)
Generación automática de métodos CRUD (creación/lectura/actualización/supresión) y no CRUD
Validación automática de argumentos
Determinación/anulación de argumentos
Capacidad de persistencia transparente (ORM)
Llamada a consultas enriquecidas
Soporte de datos temporal y privado
Gestión de identidad

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

Creación de un archivo de especificación

Antes de empezar, debe crear un archivo de especificación de entrada. Tenga en cuenta que no puede modificar los archivos de especificación de ejemplo que se han instalado como parte de Blockchain App Builder, pero puede duplicarlos o utilizarlos como archivo de referencia para sus propios archivos de especificación.

En el panel Especificaciones, seleccione Crear nuevo archivo de especificaciones.
Se abre el panel Detalles de especificaciones:
- Introduzca el nombre del archivo de especificación.
- Seleccione el tipo de archivo: YAML y JSON están soportados.
- También puede introducir una descripción para el archivo.
- La lista desplegable Archivo de referencia permite generar el archivo de especificación a partir de un archivo existente en el 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 almacenar el archivo de especificación en el sistema.
Haga clic en Guardar.

El nuevo archivo de especificación se crea y aparece en el panel 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:

En el panel Especificaciones, haga clic en Más acciones y seleccione Importar especificación.
Busque el archivo y haga clic en Importar especificación.

El archivo de especificación se importa y aparece en el panel Especificaciones. Haga clic en él para abrirlo en el editor.

Duplicación de 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 en él y seleccionando Duplicar. Haga clic con el botón derecho en el archivo y seleccione Cambiar nombre para actualizar el nombre.

Los detalles sobre el contenido de los archivos de especificaciones se describen aquí: Archivo de especificación de entrada. Utilice esta información y las plantillas de especificación de ejemplo para crear el contenido de especificación.

Validación de un archivo de especificación

Si instaló 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 a valores por defecto de esquema
Ayuda sensible al contexto al pasar el mouse sobre una propiedad o un método
Sangría para elementos de matriz a medida que escribe
Detección de errores de sintaxis

Andamio del Proyecto Chaincode

Cuando tenga un archivo de especificación que satisfaga sus necesidades, genere su proyecto de código de cadenas.

En el panel Códigos de cadena, seleccione Crear nuevo código de cadena.
Se abre el panel Detalles de código de cadena:
- 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 cadenas.
- Introduzca la ubicación o el dominio Go donde desea que se cree el proyecto en el entorno de desarrollo local.
Haga clic en Create.

Cuando se cree el proyecto, se mostrará en el panel Códigos de cadenas. Todos los archivos requeridos por el código de cadenas estarán en el proyecto. Para obtener una descripción 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 cadenas permite abrir y trabajar con contenido del proyecto de código de cadenas, 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 explorador. Esto abre el proyecto en la vista Explorador de código VS.
Eliminar o cambiar el nombre de los archivos en el proyecto de código de cadenas puede romper el enlace 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.

Importación de un proyecto de código de cadenas existente

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