使用區塊鏈 App 產生器 Visual Studio 程式碼擴充建立鏈碼專案

若要使用 Blockchain App Builder 建立鏈碼專案，您必須從詳細的規格檔案編制鏈碼專案。這會產生包含所有必要檔案的專案。

背景

Blockchain App Builder 初始化和編程現成的鏈碼專案。根據簡單輸入，建立新鏈碼命令可產生具有下列功能的複雜鏈碼專案：
  • 多個資產 (模型) 及其行為 (控制器)
  • 自動產生 CRUD (建立 / 讀取 / 更新 / 刪除) 和非 CRUD 方法
  • 自動驗證引數
  • 引數的封送處理 (Marshal) / 解除封送處理 (unmarshal)
  • 透明持續性功能 (ORM)
  • 豐富的查詢支援
  • 臨時和私人資料支援
  • 身分管理

產生的專案會依照模型 / 控制器和裝飾器樣式進行，讓在分類帳上維護的資產特性可指定為類型欄位，並以特定行為和驗證規則進行擴充。這樣可以減少程式碼行的數目，以協助讀取和擴展。

建立規格檔案

您必須先建立輸入規格檔案。您無法更改安裝為 Blockchain App Builder 一部分的範例規格檔案，但您可以複製這些檔案，或將其用作您自己的規格檔案的參考檔案。

  1. 在規格窗格中，選取建立新規格檔案。
  2. 在規格詳細資料窗格中，完成下列步驟。
    • 輸入規格檔案的名稱。
    • 選取檔案類型。支援 YAML 和 JSON 格式。
    • (選擇性) 輸入檔案的描述。
    • 如果您有要作為樣板的檔案，參照檔案下拉式清單可讓您從工作區中的檔案產生規格檔案。如果未選取任何項目，建立的檔案將會是空的，您可以從頭開始輸入您的規格。
    • 輸入您要在系統上儲存規格檔案的位置。
    按一下儲存。
規格檔案隨即建立並顯示在規格窗格中。按一下該按鈕可在編輯器開啟該視窗。

匯入規格檔案

如果您有預先存在的規格檔案，則可以匯入該檔案。
  1. 在規格窗格中，按一下其他動作，然後選取匯入規格。
  2. 瀏覽至您的檔案，然後按一下匯入規格。
規格檔案會匯入並顯示在規格窗格中。按一下該按鈕可在編輯器開啟該視窗。

複製規格檔案

您也可以複製已經在規格窗格中的規格檔案，方法是用滑鼠右鍵按一下該規格檔案並選取複製。在檔案上按一下滑鼠右鍵，然後選取重新命名來更新名稱。

如需有關規格檔案內容的詳細資訊，請參閱輸入規格檔案。使用此資訊與範例規格範本來建立規格內容。

驗證規格檔案

如果您已安裝「YAML 語言支援」擴充功能，系統會在您輸入時自動驗證規格檔案。下列為自動支援的驗證功能：
  • 指令完成
  • 完成純量節點至綱要預設值
  • 當您將游標暫留在屬性或方法上時，相關內容說明
  • 輸入陣列項目時縮排
  • 語法錯誤偵測

編織鏈碼專案

建立規格檔案後，您可以產生鏈碼專案。
  1. 在鏈碼窗格中，選取建立新鏈碼。
  2. 在鏈碼詳細資訊窗格中，完成下列步驟。
    • 輸入您的鏈碼專案名稱。
    • 選取語言：TypeScript 或 Go。
    • 選取您用來建立鏈碼的規格檔案。
    • 輸入您要在本機開發環境中建立專案的位置或執行網域。
    按一下建立。
建立專案時，專案會顯示在鏈碼窗格中。鏈碼所需的所有檔案都將包含在專案中。如需所建立檔案的詳細簡介，請參閱： 如需權杖型專案的詳細總覽，請參閱：

附註：

  • 鏈碼窗格可讓您開啟與使用鏈碼專案中的內容，但不會讓您在專案中新增、刪除或重新命名檔案。若要這麼做，請在您的專案上按一下滑鼠右鍵，然後選取在檔案總管中開啟。這會在 Visual Studio Code 檔案總管檢視中開啟專案。
  • 刪除或重新命名鏈碼專案中的檔案可能會中斷專案檔案與用來建立該檔案之規格檔案之間的連結。如果您計畫在兩者之間同步程式碼，請勿變更檔案名稱。

匯入現有的鏈碼專案

如果您已透過 CLI 建立鏈碼專案，或已清除 Visual Studio Code 區塊鏈內容並想要匯入本機儲存的專案，請在鏈碼窗格中按一下其他動作 ... 圖示，然後選取匯入鏈碼。瀏覽至專案，然後按一下匯入鏈碼。