使用 Blockchain App Builder Visual Studio Code 扩展创建 Chaincode 项目

要使用区块链应用程序构建器创建链代码项目，请从详细的规范文件中支架链代码项目。这将生成包含所有必需文件的项目。

背景信息

Blockchain App Builder 初始化并支架一个现成的链代码项目。根据简单输入， Create New Chaincode 命令可以生成包含以下功能的复杂链代码项目：
  • 多个资产（模型）及其行为（控制器）
  • 自动生成 CRUD（创建/读取/更新/删除）和非 CRUD 方法
  • 自动验证参数
  • 编集/解编集论据
  • 透明持久性能力 (ORM)
  • 丰富的查询支持
  • 临时和专用数据支持
  • 身份管理系统

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

创建规范文件

必须先创建输入规范文件。您无法更改作为区块链应用程序构建器的一部分安装的示例规范文件，但您可以复制它们或将其用作您自己的规范文件的参考文件。

  1. 在规格窗格中，选择创建新规格文件。
  2. 在规格详细信息窗格中，完成以下步骤。
    • 输入规范文件的名称。
    • 选择文件类型。支持 YAML 和 JSON 格式。
    • （可选）输入文件的说明。
    • 使用引用文件下拉列表，您可以从工作区中的文件生成规范文件（如果有要用作模板的文件）。如果未选择任何内容，则创建的文件将为空，您可以从头开始输入规范。
    • 输入要将规范文件存储在系统中的位置。
    单击保存。
将创建规范文件并将其显示在规范窗格中。单击此按钮可在编辑器中将其打开。

导入规范文件

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

复制规范文件

You can also duplicate a specification file that's already in your Specifications pane by right-clicking it and selecting Duplicate.右键单击该文件，然后选择重命名以更新名称。

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

验证规范文件

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

脚手架 Chaincode 项目

创建规范文件后，可以生成链代码项目。
  1. 在 Chaincodes 窗格中，选择 Create New Chaincode 。
  2. 在 Chaincode Details 窗格中，完成以下步骤。
    • 输入链代码项目的名称。
    • 选择语言：TypeScript 或 Go。
    • 选择要用于创建链代码的规范文件。
    • 输入要在本地开发环境中创建项目的地点或 Go 域。
    单击创建。
创建项目后，它将显示在链代码窗格中。链代码所需的所有文件都将在项目中。有关所创建文件的详细概述，请参见： 有关基于令牌的项目详细概述，另请参见：

注意：

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

导入现有 Chaincode 项目

如果您通过 CLI 创建了链代码项目，或者您已清理了 Visual Studio Code 区块链内容并希望导入本地保存的项目，请在 Chaincodes 窗格中单击 More Actions... 图标并选择 Import Chaincode 。浏览到项目并单击导入链代码。