使用區塊鏈 App 產生器 VS 程式碼擴充建立鏈碼專案
若要在使用區塊鏈 App 產生器時建立鏈碼專案，您必須從詳細的規格檔案建立鏈碼專案。這會產生包含您需要之所有檔案的專案。
背景
Blockchain App Builder 會立即為您初始化和鷹架鏈碼專案。根據簡單輸入，建立新的鏈碼可以使用下列功能產生複雜的鏈碼專案：
- 多重資產 (模型) 及其行為 (控制器)
- 自動產生 CRUD (建立 / 讀取 / 更新 / 刪除) 和非 CRUD 方法
- 自動驗證引數
- 引數的封送處理 / 解除封送處理
- 透明保存能力 (ORM)
- 呼叫 Rich 查詢
- 暫時和專用資料支援
- 識別管理
產生的專案會遵循模型 / 控制器與裝飾樣式，允許將分類帳上維護的資產屬性指定為輸入欄位，並以特定行為與驗證規則擴充。這樣可以減少有助於可讀性與擴展性的程式碼行數。
建立規格檔案
在開始之前，您需要建立一個輸入規格檔案。請注意，您無法更改已安裝為 Blockchain App Builder 的範例規格檔案，但您可以複製這些檔案，或是將它們當作您自己的規格檔案的參考檔案使用。
- 在規格窗格中，選取建立新規格檔案。
- 規格詳細資訊窗格隨即開啟：
- 輸入規格檔案的名稱。
- 選取支援的檔案類型 - YAML 和 JSON。
- 或者輸入檔案的說明。
- 參照檔案下拉式清單可讓您從工作區中已存在的檔案產生您的規格檔案 (如果您有要當作樣板使用的檔案)。如果未選取任何項目，建立的檔案將會是空的，您可以從頭輸入您的規格。
- 輸入您要將規格檔案儲存在系統上的位置。
匯入規格檔案
如果您有預先存在的規格檔案，您可以匯入：
- 在規格窗格中，按一下更多動作，然後選取匯入規格。
- 瀏覽至您的檔案，然後按一下匯入規格。
複製規格檔案
您也可以複製已在規格窗格中的規格檔案，方法是按一下滑鼠右鍵並選取複製。用滑鼠右鍵按一下檔案，然後選取重新命名以更新名稱。
有關規格檔案內容的詳細資訊，請參閱輸入規格檔案。使用此資訊與範例規格範本來建立您的規格內容。
驗證規格檔案
如果您已安裝「YAML 語言支援」副檔名，系統會在您輸入時自動驗證規格檔案。以下是自動支援的驗證功能：
- 命令完成
- 完成純量節點至綱要預設值
- 當您將游標停留在特性或方法上時，相關內容說明
- 輸入時陣列項目的縮排
- 語法錯誤偵測
鷹架鏈碼專案
當您有符合需求的規格檔案時，請產生您的鏈碼專案。
- 在鏈碼窗格中，選取建立新鏈碼。
- 鏈碼詳細資訊窗格隨即開啟：
- 輸入您的鏈碼專案名稱。
- 選取語言：TypeScript 或 Go。
- 選取您用來建立鏈碼的規格檔案。
- 輸入您要在本機開發環境中建立專案的位置或「執行」網域。
專案建立後，會顯示在鏈碼窗格中。鏈碼所需的所有檔案都將包含在專案中。如需建立之檔案的詳細總覽，請參閱：
如需權杖型專案的詳細總覽，另請參閱：
附註：
- 鏈碼窗格可讓您開啟與使用鏈碼專案中的內容，但不會讓您新增、刪除或重新命名專案中的檔案。若要這麼做，請在專案上按一下滑鼠右鍵，然後選取在瀏覽器中開啟。這會在「VS 代碼總管」檢視中開啟專案。
- 刪除或重新命名鏈碼專案中的檔案可能會中斷專案檔案與用來建立檔案之規格檔案之間的連結。如果您打算在兩個程式碼之間同步程式碼，請不要變更檔案名稱。
匯入現有鏈碼專案
如果您已透過 CLI 建立鏈碼專案，或已清除 VS Code 區塊鏈內容並想要匯入本機儲存的專案，請在鏈碼窗格中按一下其他動作 ... 圖示，然後選取匯入鏈碼。瀏覽至專案，然後按一下匯入鏈碼。