使用区块链应用程序构建器 VS 代码扩展创建链代码项目

要在使用区块链应用程序构建器时创建链代码项目,您需要从详细规范文件构建链代码项目。这将生成包含您需要的所有文件的项目。

背景信息

区块链应用构建器可为您初始化和支架一个现成的链代码项目。根据简单输入,创建新链代码可以使用以下功能生成复杂的链代码项目:
  • 多个资产(模型)及其行为(控制器)
  • 自动生成 CRUD(创建/读取/更新/删除)和非 CRUD 方法
  • 自动验证参数
  • 编组/取消编组论点
  • 透明持久性 (ORM) 能力
  • 调用富查询
  • 临时和专用数据支持
  • 身份管理

生成的项目遵循模型/控制器和修饰器模式,该模式允许在分类账上维护的资产属性指定为类型字段,并通过特定的行为和验证规则进行扩展。这样可以减少有助于提高可读性和可扩展性的代码行数。

创建规格文件

在开始之前,需要创建输入规范文件。请注意,您无法更改作为区块链应用程序构建器的一部分安装的示例规范文件,但您可以复制它们或使用它们作为您自己的规范文件的参考文件。

  1. 规格窗格中,选择创建新规格文件
  2. 此时将打开规格详细信息窗格:
    • 输入说明文件的名称。
    • 选择文件类型 - 支持 YAML 和 JSON。
    • 可以选择性地输入文件的说明。
    • 引用文件下拉列表允许您从工作区中预先存在的文件生成规范文件(如果您要用作模板的文件)。如果未选择任何内容,则创建的文件将为空,您可以从头开始输入规范。
    • 输入要在系统中存储规范文件的位置。
    单击保存
新规范文件将创建并显示在规范窗格中。单击它以在编辑器中打开它。

导入规范文件

如果您有一个预先存在的规范文件,则可以导入该文件:
  1. 规范窗格中,单击更多操作并选择导入规范
  2. 浏览到您的文件,然后单击导入规范
规范文件将导入并显示在规范窗格中。单击它以在编辑器中打开它。

复制规范文件

您还可以通过右键单击已位于规范窗格中的规范文件并选择复制来复制该规范文件。右键单击该文件,然后选择重命名以更新名称。

有关规范文件内容的详细信息,请参见: Input Specification File 。使用此信息和示例规范模板创建规范内容。

验证规范文件

如果安装了 YAML 语言支持扩展名,则在键入时会自动验证规范文件。自动支持以下验证功能:
  • 命令完成
  • 标量节点到方案默认值的完成
  • 将鼠标悬停在属性或方法上时提供上下文相关帮助
  • 键入时数组项的缩进
  • 语法错误检测

支架链码项目

如果您的规范文件符合您的需求,请生成链代码项目。
  1. Chaincodes 窗格中,选择 Create New Chaincode
  2. 此时将打开 Chaincode Details 窗格:
    • 输入链代码项目的名称。
    • 选择语言:TypeScript 或 Go。
    • 选择用于创建链代码的规范文件。
    • 输入要在本地开发环境中创建项目的位置或 Go 域。
    单击创建
创建项目时,项目将显示在类别码窗格中。链代码所需的所有文件都将在项目中。有关所创建文件的详细概述,请参见: 有关基于令牌的项目详细概述,另请参见:

注意:

  • Chaincodes 窗格允许您打开和处理链代码项目中的内容,但不允许您添加、删除或重命名项目中的文件。为此,请右键单击项目,然后选择在资源管理器中打开。这将打开“VS 代码浏览器”视图中的项目。
  • 删除或重命名链代码项目中的文件可能会破坏项目文件与用于创建它的规范文件之间的链接。如果计划在两者之间同步代码,请不要更改文件名。

导入现有的 Chaincode 项目

如果您通过 CLI 创建了链代码项目,或者您清理了 VS Code 区块链内容并希望导入本地保存的项目,请在链代码窗格中单击更多操作 ... 图标并选择导入链代码。浏览到项目并单击导入链代码