使用区块链应用程序构建器 VS 代码扩展创建链代码项目
要在使用区块链应用程序构建器时创建链代码项目,您需要从详细的规范文件中支架链代码项目。这将生成包含所需所有文件的项目。
背景信息
Blockchain App Builder 为您初始化和支架链代码项目。根据简单输入,创建新链代码可以使用以下功能生成复杂的链代码项目:
- 多个资产(模型)及其行为(控制器)
- 自动生成 CRUD (Create/Read/Update/Delete) 和非 CRUD 方法
- 自动验证参数
- 编组/编组参数
- 透明持久性功能 (Transparent Persistence Capacity,ORM)
- 调用富查询
- 临时和专用数据支持
- 标识管理
生成的项目遵循模型/控制器和修饰符模式,该模式允许将分类账上维护的资产属性指定为类型字段,并使用特定行为和验证规则进行扩展。这样可以减少有助于提高可读性和可扩展性的代码行数。
创建规范文件
在开始之前,需要创建输入规范文件。请注意,您无法更改作为区块链应用程序构建器的一部分安装的示例规范文件,但您可以复制它们或使用它们作为您自己的规范文件的引用文件。
- 在规格窗格中,选择创建新规格文件。
- 此时将打开规格详细信息窗格:
- 输入规范文件的名称。
- 选择文件类型 - 支持 YAML 和 JSON。
- 输入文件的描述(可选)。
- 使用引用文件下拉列表,您可以从工作区中预先存在的文件生成规范文件(如果您有要用作模板的文件)。如果未选择任何内容,则创建的文件将为空,您可以从头开始输入规范。
- 输入希望将规范文件存储在系统中的位置。
导入规范文件
如果您具有预先存在的规范文件,则可以导入该文件:
- 在规范窗格中,单击更多操作,然后选择导入规范。
- 浏览到您的文件,然后单击导入规范。
复制规范文件
您也可以通过右键单击规格窗格中的规格文件并选择复制来复制该规格文件。右键单击该文件,然后选择重命名以更新名称。
有关规范文件内容的详细信息如下: Input Specification File 。使用此信息和示例规范模板来创建规范内容。
验证规范文件
如果您安装了 YAML 语言支持扩展,则在您键入时会自动验证规范文件。自动支持以下验证功能:
- 命令完成
- 完成标量节点到方案默认值
- 将鼠标悬停在属性或方法上时上下文相关帮助
- 键入时数组项的缩进
- 语法错误检测
链码项目的基架
如果您的规范文件满足您的需求,请生成链代码项目。
- 在 Chaincodes 窗格中,选择 Create New Chaincode(创建新链代码)。
- 此时将打开 Chaincode Details 窗格:
- 输入链代码项目的名称。
- 选择语言:TypeScript 或 Go。
- 选择用于创建链代码的规范文件。
- 输入要在本地开发环境中创建项目的位置或执行域。
创建项目时,它将显示在“分类码”窗格中。链代码所需的所有文件都将在项目中。有关创建的文件的详细概述,请参见:
有关基于令牌的项目详细概述,另请参见:
注意:
- 链代码窗格允许您打开和处理链代码项目中的内容,但不会允许您添加、删除或重命名项目中的文件。为此,请右键单击项目并选择在资源管理器中打开。这将在 VS Code Explorer 视图中打开项目。
- 删除或重命名链代码项目中的文件可能会破坏项目文件与用于创建它的规范文件之间的链接。如果您计划在两者之间同步代码,请勿更改文件名。
导入现有的链代码项目
如果您已通过 CLI 创建链代码项目,或者您已清除 VS Code 区块链内容并希望导入本地保存的项目,请在链代码窗格中单击更多操作 ... 图标并选择导入链代码。浏览到项目并单击导入链代码。