Crie um Projeto Chaincode com a Extensão Blockchain App Builder Visual Studio Code

Para criar um projeto chaincode com o Blockchain App Builder, você desenvolve um projeto chaincode a partir de um arquivo de especificação detalhado. Isso gera um projeto com todos os arquivos necessários.

Segundo plano

O Blockchain App Builder inicializa e realiza um projeto de chaincode pronto para uso. Com base em uma entrada simples, o comando Criar Novo Chaincode pode gerar projetos de chaincode complexos com recursos como:
  • Vários ativos (modelos) e seus comportamentos (controladores)
  • Gerar automaticamente métodos CRUD (Criar/Ler/Atualizar/Excluir) e não CRUD
  • Validação automática de argumentos
  • Desestruturação/desestruturação de argumentos
  • Capacidade de persistência transparente (ORM)
  • Suporte a consultas avançadas
  • Suporte a dados transitórios e privados
  • Gerenciamento de identidades

O projeto gerado segue o padrão de modelo/controlador e decorador, que permite que as propriedades de um ativo mantidas no razão sejam especificadas como campos digitados e estendidas com comportamentos e regras de validação específicos. Isso reduz o número de linhas de código que podem ajudar na legibilidade e na escalabilidade.

Criar um Arquivo de Especificação

Primeiro você deve criar um arquivo de especificação de entrada. Você não pode alterar os arquivos de especificação de amostra que foram instalados como parte do Blockchain App Builder, mas pode duplicá-los ou usá-los como um arquivo de referência para seus próprios arquivos de especificação.

  1. No painel Especificações, selecione Criar Novo Arquivo de Especificação.
  2. No painel Detalhes das Especificações, conclua as etapas a seguir.
    • Informe o nome do arquivo de especificação.
    • Selecione o tipo de arquivos. Os formatos YAML e JSON são suportados.
    • Opcionalmente, informe uma descrição para o arquivo.
    • A lista drop-down Arquivo de Referência permite gerar seu arquivo de especificação com base em um arquivo em seu espaço de trabalho, se você tiver um arquivo que deseja usar como modelo. Se nada for selecionado, o arquivo criado ficará vazio e você poderá inserir sua especificação do zero.
    • Insira o local onde deseja que o arquivo de especificação seja armazenado no sistema.
    Clique em Salvar.
O arquivo de especificação é criado e mostrado no painel Especificações. Clique nela para abri-la no editor.

Importar um Arquivo de Especificação

Se você tiver um arquivo de especificação preexistente, poderá importá-lo.
  1. No painel Especificações, clique em Mais Ações e selecione Importar Especificação.
  2. Navegue até o arquivo e clique em Importar Especificação.
O arquivo de especificação é importado e mostrado no painel Especificações. Clique nela para abri-la no editor.

Duplicar um Arquivo de Especificação

Você também pode duplicar um arquivo de especificação que já esteja no painel Especificações clicando nele com o botão direito do mouse e selecionando Duplicar. Clique com o botão direito do mouse no arquivo e selecione Renomear para atualizar o nome.

Para obter mais detalhes sobre o conteúdo dos arquivos de especificações, consulte Arquivo de Especificação de Entrada. Use essas informações e os modelos de especificação de amostra para criar seu conteúdo de especificação.

Validar um Arquivo de Especificação

Se você instalou a extensão YAML Language Support, o arquivo de especificação é automaticamente validado à medida que você digita. Os seguintes recursos de validação são suportados automaticamente:
  • Conclusão do comando
  • Conclusão de nós escalares para padrões de esquema
  • Ajuda contextual quando você passa o mouse sobre uma propriedade ou um método
  • Recuos para itens de matriz conforme você digita
  • Detecção de erros de sintaxe

Andaime do Projeto Chaincode

Depois de criar um arquivo de especificação, você pode gerar um projeto chaincode.
  1. No painel Códigos de Cadeia, selecione Criar Novo Código de Cadeia.
  2. No painel Detalhes do Código de Cadeia, execute as etapas a seguir.
    • Informe o nome do seu projeto chaincode.
    • Selecione o idioma: TypeScript ou Ir.
    • Selecione o arquivo de especificação que você está usando para criar o chaincode.
    • Informe o local ou o domínio Go no qual você deseja que o projeto seja criado no seu ambiente de desenvolvimento local.
    Clique em Criar.
Quando seu projeto for criado, ele será mostrado no painel Códigos de Cadeia. Todos os arquivos exigidos pelo chaincode estarão no projeto. Para obter uma visão geral detalhada dos arquivos criados, consulte: Para obter uma visão geral detalhada de um projeto baseado em token, consulte também:

Observação:

  • O painel Códigos de Cadeia permite abrir e trabalhar com conteúdo no projeto chaincode, mas não permite que você adicione, exclua ou renomeie arquivos no projeto. Para fazer isso, clique com o botão direito do mouse em seu projeto e selecione Abrir no Explorer. Isso abre o projeto na exibição Visual Studio Code Explorer.
  • Excluir ou renomear arquivos no projeto chaincode pode potencialmente quebrar o link entre os arquivos do projeto e o arquivo de especificação usado para criá-lo. Se você planeja sincronizar seu código entre os dois, não altere os nomes dos arquivos.

Importar um Projeto Chaincode Existente

Se você tiver criado um projeto de chaincode por meio da CLI ou tiver limpo seu conteúdo de blockchain do Visual Studio Code e quiser importar um projeto salvo localmente, no painel Códigos de Cadeia, clique no ícone Mais Ações... e selecione Importar Chaincode. Navegue até o projeto e clique em Importar Código da Cadeia.