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

若要在使用 Blockchain App 產生器時建立 Chaincode 專案，您必須從詳細的規格檔案鷹架鏈碼專案。這會產生內含您所需之所有檔案的專案。

背景

Blockchain App Builder 會立即為您初始化和鷹架鏈碼專案。根據簡單輸入，建立新的鏈碼可以產生具有下列功能的複雜鏈碼專案：
  • 多個資產 (模型) 及其行為 (控制器)
  • 自動產生 CRUD (建立 / 讀取 / 更新 / 刪除) 和非 CRUD 方法
  • 自動驗證引數
  • 封送處理 (Marshal) / 解除封送處理 (unmarshal) 引數
  • 透明持續性功能 (ORM)
  • 呼叫 Rich Query
  • 暫時和專用資料支援
  • 識別管理

產生的專案會遵循模型 / 控制器與修飾器模式，允許將分類帳上維護的資產特性指定為類型欄位，並以特定行為與驗證規則延伸。這可減少程式碼行數，協助提高可讀性和可擴展性。

建立規格檔案

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

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

匯入規格檔案

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

複製規格檔案

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

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

驗證規格檔案

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

鷹架鏈碼工程

當您有符合您需求的規格檔案時，請產生鏈碼專案。
  1. 在鏈碼窗格中，選取建立新鏈碼。
  2. 鏈碼詳細資訊窗格便會開啟：
    • 輸入鏈碼專案的名稱。
    • 選取語言：TypeScript 或 Go。
    • 選取您用來建立鏈碼的規格檔案。
    • 輸入您要在本機開發環境中建立專案的位置或 Go 網域。
    按一下建立。
建立專案後，該專案會顯示在鏈碼窗格中。專案中將會包含鏈碼所需的所有檔案。如需所建立檔案的詳細總覽，請參閱： 如需權杖型專案的詳細總覽，另請參閱：

附註：

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

匯入現有 Chaincode 專案

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