Crea un progetto Chaincode con l'estensione Visual Studio Code di Blockchain App Builder

Per creare un progetto di codice concatenato con Blockchain App Builder, è necessario eseguire lo scaffold di un progetto di codice concatenato da un file di specifica dettagliato. Questo genera un progetto con tutti i file necessari.

Presupposto

Blockchain App Builder inizializza e imprime un progetto di codice concatenato pronto all'uso. In base a un input semplice, il comando Crea nuovo codice concatenato può generare progetti di codice concatenato complessi con funzioni quali:
  • Attività multiple (modelli) e loro comportamenti (controllori)
  • Genera automaticamente CRUD (Crea/Leggi/Aggiorna/Elimina) e metodi non CRUD
  • Convalida automatica degli argomenti
  • Maresciallo/smontaggio delle argomentazioni
  • Capacità di persistenza trasparente (ORM)
  • Supporto rich query
  • Supporto dati transitori e privati
  • Gestione delle identità

Il progetto generato segue il modello/controller e il pattern decorator, che consente di specificare le proprietà di un asset gestite nel libro contabile come campi digitati ed estese con comportamenti e regole di convalida specifici. Ciò riduce il numero di righe di codice che possono aiutare con la leggibilità e la scalabilità.

Creare un file di specifica

È innanzitutto necessario creare un file di specifica di input. Non è possibile modificare i file di specifica di esempio installati come parte di Blockchain App Builder, ma è possibile duplicarli o utilizzarli come file di riferimento per i propri file di specifica.

  1. Nel riquadro Specifiche selezionare Crea nuovo file di specifica.
  2. Nel riquadro Dettagli specifiche, effettuare le operazioni riportate di seguito.
    • Immettere il nome del file di specifica.
    • Selezionare il tipo di file. Sono supportati i formati YAML e JSON.
    • Se si desidera, immettere una descrizione per il file.
    • L'elenco a discesa File di riferimento consente di generare il file di specifica da un file nell'area di lavoro, se si dispone di un file che si desidera utilizzare come modello. Se non viene selezionato nulla, il file creato sarà vuoto ed è possibile inserire la specifica da zero.
    • Inserire la posizione in cui si desidera memorizzare il file di specifica nel sistema.
    Fare clic su Salva.
Il file di specifica viene creato e visualizzato nel riquadro Specifiche. Fare clic su di esso per aprirlo nell'editor.

Importa un file di specifica

Se si dispone di un file di specifica preesistente, è possibile importarlo.
  1. Nel riquadro Specifiche fare clic su Altre azioni, quindi selezionare Specifica di importazione.
  2. Cercare il file e fare clic su Importa specifica.
Il file delle specifiche viene importato e visualizzato nel riquadro Specifiche. Fare clic su di esso per aprirlo nell'editor.

Duplica file di specifica

È inoltre possibile duplicare un file di specifica già presente nel riquadro Specifiche facendo clic con il pulsante destro del mouse su di esso e selezionando Duplica. Fare clic con il pulsante destro del mouse sul file e selezionare Rinomina per aggiornare il nome.

Per ulteriori informazioni sul contenuto dei file delle specifiche, vedere File di specifica di input. Utilizzare queste informazioni e i modelli di specifica di esempio per creare il contenuto della specifica.

Convalida file specifica

Se è stata installata l'estensione YAML Language Support, il file delle specifiche viene convalidato automaticamente durante la digitazione. Le seguenti funzioni di convalida sono supportate automaticamente:
  • Completamento comando
  • Completamento dei nodi scalari ai valori predefiniti dello schema
  • Guida contestuale quando si passa il mouse su una proprietà o un metodo
  • Indentazioni per gli elementi di array durante la digitazione
  • Rilevamento degli errori di sintassi

Impalcatura del progetto Chaincode

Dopo aver creato un file di specifica, è possibile generare un progetto con codice concatenato.
  1. Nel riquadro Codici catena, selezionare Crea nuovo codice catena.
  2. Nel riquadro Dettagli codice canale, effettuare le operazioni riportate di seguito.
    • Inserire il nome del progetto con codice concatenato.
    • Selezionare la lingua: TypeScript o Vai.
    • Selezionare il file di specifica che si sta utilizzando per creare il codice concatenato.
    • Immettere la posizione o il dominio Vai in cui si desidera che il progetto venga creato nell'ambiente di sviluppo locale.
    Fare clic su Crea.
Quando il progetto viene creato, verrà visualizzato nel riquadro Codici di catena. Tutti i file richiesti dal codice concatenato saranno nel progetto. Per una panoramica dettagliata dei file creati, vedere: Per una panoramica dettagliata di un progetto basato su token, vedere anche:

Nota

  • Il riquadro Codici di catena consente di aprire e utilizzare il contenuto nel progetto con codice di catena, ma non consente di aggiungere, eliminare o rinominare i file nel progetto. A tale scopo, fare clic con il pulsante destro del mouse sul progetto e selezionare Apri in Explorer. Viene visualizzato il progetto nella vista Explorer codice di Visual Studio.
  • L'eliminazione o la ridenominazione di file nel progetto codice concatenato può potenzialmente interrompere il collegamento tra i file del progetto e il file di specifica utilizzato per crearlo. Se si prevede di sincronizzare il codice tra i due, non modificare i nomi dei file.

Importa un progetto Chaincode esistente

Se è stato creato un progetto con codice concatenato tramite l'interfaccia CLI o è stato eseguito il cleanup del contenuto della blockchain di Visual Studio Code e si desidera importare un progetto salvato localmente, nel riquadro Codici concatenati fare clic sull'icona Altre azioni... e selezionare Importa codice concatenato. Passare al progetto e fare clic su Importa codice concatenato.