使用區塊鏈 App 產生器 CLI 建立鏈碼專案

若要在使用 Blockchain App Builder CLI 時建立鏈碼專案,請從詳細的規格檔案建立鏈碼專案。產生的專案接著會包含所有檔案,而不是您需要的檔案。

背景

Blockchain App Builder 的 init 命令會初始化並鷹架現成的鏈碼專案。根據簡單輸入,init 指令可產生包含下列功能的複雜鏈碼專案:
  • 多重資產 (模型) 及其行為 (控制器)
  • 自動產生 CRUD (建立 / 讀取 / 更新 / 刪除) 和非 CRUD 方法
  • 自動驗證引數
  • 引數的封送處理 / 解除封送處理
  • 透明保存能力 (ORM)
  • 呼叫 Rich Query 的能力

產生的專案會遵循模型 / 控制器與裝飾樣式,允許將分類帳上維護的資產屬性指定為輸入欄位,並以特定行為與驗證規則進行延伸。此模式會減少程式碼行的數目,進而協助實現可讀性與擴展性。

先決條件

鷹架專案之前,您必須先建立輸入規格檔案。如需詳細資訊,請參閱輸入規格檔案

使用 init 命令建立鏈碼專案結構

輸入 ochain init -h 將會列出命令用法及其所有選項。init 指令具有下列選項:
  • --cc/-c:

    鏈碼專案的名稱。預設值是 MyChaincode

  • -- 語言 /-l

    結構化鏈碼的語言。Blockchain App Builder 支援 Typescript (ts) 和 Go (go)。如果未指定任何選項,語言會預設為 ts

  • --conf/-f--spec

    輸入規格檔案的路徑。Blockchain App Builder 會讀取輸入規格檔案,並使用許多協助程式工具產生鷹架式專案,以協助減少整體開發工作。充分利用輸入規格檔案,可大幅縮短開發時間。

    規格檔案的格式可以是 yamljson。如果未指定此路徑,則預設為目前的目錄。請參閱輸入規格檔案

  • -- 輸出 /- 輸出

    鷹架鏈碼專案的輸出目錄。如果未指定,便會在目前的目錄中產生鷹架式專案。

    輸出是完全包含、輕量且可擴展的 Typescript 或 Go 鏈碼專案。

  • -- 根 /-r

    只有執行才有效且必要。您 Go 鏈碼之 GOHOME 變數中的根目錄。預設值是 example.com

範例
my-mac:~ name$ ochain init --cc MyNewTsProject --lang ts --conf spec.yml

預設值

如果 ochain init 指令中未指定任何選項,則鷹架專案的名稱為 MyChaincode,語言為 TypeScript。

MyChaincode.model.ts 檔案只包含一個名為 MyAsset 的資產,一個特性名為 valueMyChaincode.controller.ts 檔案包含一個具有 MyAsset 模型之對應 CRUD 方法的控制器。

輸出

流程完成後,您將擁有功能完整的鏈碼專案,您可以在本機或遠端 Oracle Blockchain Platform 執行處理上進行部署。如需建立之檔案的詳細總覽,請參閱: 如需權杖型專案的詳細總覽,另請參閱: