VS扩展

搬运工的VS扩展包括项目模板、常用代码模板、中文代码简拼助手、sql格式化、xaml格式化等功能。

项目模板

创建新项目或添加空项目时,选择搬运工项目模板,点击创建,显示项目模板的选项。

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/1.png
创建新项目

一般默认选项即可,在选择新项目支持的平台时,默认未选择Web(WebAssembly),一方面支持的平台已涵盖常用,不再需要Web,再者wasm版目前编译慢、启动下载慢、交互响应慢、调试费劲,用户体验差,所以不推荐使用,当然运行是没问题的。

支持三种框架结构:

  • 使用搬运工标准服务,包括通用后台管理、文件服务、消息服务等
  • 直连数据库,两层架构
  • 单机版应用,无服务,使用客户端Sqlite库存储

每种结构都有自己的使用场景,绝大部分场景使用第一种结构,它采用多层微服务,使用自定义服务和搬运工标准服务(内核服务、消息服务、文件服务)。

两层架构适用于客户端少的小型项目,比如十多个客户端、服务器性能差甚至没有专用服务器。

单机版适用于工具类的项目,没有互联需求,只存储简单数据。

点击创建生成新项目,详细过程参见创建新项目,通常创建后先关闭解决方案,再次打开解决方案目录下的XXXX-win.sln,该解决方案只运行WinUI,加载生成运行都要快很多。

在当前解决方案中添加空项目时,选择搬运工客户端项目模板,点击创建。

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/2.png
搬运工客户端项目

代码模板

搬运工的VS扩展提供了大量的代码模板,有三种位置可以使用代码模板:

项目内的文件夹

在项目内的文件夹上右键,选择搬运工

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/3.png
右键菜单

单实体框架、一对多框架、多对多框架参见视图框架

添加模块Tab

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/4.png
Tab

添加对话框Dlg

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/5.png
Dlg

添加窗口Win

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/6.png
Win

添加类,左侧是类的种类,右侧是类的参数,输入参数后,点击添加按钮,自动生成代码。

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/7.png

c#代码编辑器

在代码编辑器中右键选择搬运工,或按下快捷键alt + 1

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/8.png
代码

若代码编辑器中已选择sql语句,按下alt + 1会自动格式化。

xaml代码编辑器

在xaml代码编辑器中右键选择搬运工,或按下快捷键alt + 1

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/9.png
xaml

中文代码简拼助手

安装搬运工扩展后,VS代码智能提示自动支持中文简拼。

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/10.png
支持中文简拼

xaml格式化

安装搬运工扩展后,默认会在保存xaml时自动格式化xaml代码,也可通过菜单 工具 -> 选项 -> 搬运工 -> xaml格式化,设置是否启用自动格式化以及格式化设置。

/dt-docs/1%E5%BC%80%E5%A7%8B/5vs%E6%89%A9%E5%B1%95/11.png
xaml格式化

推荐保留默认设置,多人协作时能保持代码整洁。默认设置:

  • 单行允许的最大属性数4,单行允许的最大字符数60,超过任何一个值时自动换行;
  • 换行时,每行1个属性,对齐;
  • 属性按照字母重新排序,但x:Name ID Title Icon Text Content SrcID TgtID排在前面;
  • 结束括号不放在新行
  • 自动删除空元素的结束标记
  • 自闭合元素结束斜杠前有空格
  • 文档根元素的属性分成多行

sql格式化

和工具软件中的sql美化相同,便于阅读和调试。

使用方法: 在 c#代码编辑器 或 xaml代码编辑器 中选择sql语句,按下alt + 1会自动格式化。