本文档为您介绍 桌面版开发工具 的使用方法,包括下载和安装、登录、工作区管理和组件管理,帮助您快速使用 桌面版开发工具 开发组件,并进行发布。

下载并安装桌面版开发工具

  1. 登录 DataV 控制台
  2. 单击我的组件 > 我的组件包 > 下载开发者工具

  3. 选择您需要下载的版本对话框中,选择一个版本,单击下载
    系统提供 MACWINTerminal三种版本的工具供您选择:

    • MAC:适用于macOS操作系统。
    • WIN:适用于Windows操作系统。
    • Terminal:适用于Linux操作系统,单击下载后会跳转至开发指南的快速开始文档,请参考文档安装开发工具套件。
  4. (MAC和WIN版本)下载完成后,双击应用进行安装。

登录桌面版开发工具

  1. 安装完成后,双击打开工具,填写登录信息进行登录,也可以选择不登录离线开发。

    注意 离线开发将无法使用发布功能,请谨慎使用。
    • 用户名:DataV 控制台右上角显示的用户名。
    • 令牌:开发者识别码。在DataV控制台首页,选择我的组件我的组件包,单击开发者识别码进行复制,然后粘贴到输入框中。

  2. 登录成功后,可单击切换用户回到登录页面。

工作区管理

  1. 新建工作区。
    1. 在开发者工具首页,单击右下侧的+新建工作区
    2. 选择一个本地文件夹作为组件包管理文件夹,单击选择文件夹即可新建一个工作区。

      说明
      • 工作区只是一个包含许多组件的文件夹,可以跟线上的组件包同名,也可以不同名。
      • 如果已存在包含组件的文件夹,可以选择打开该文件夹,工具会自动识别该文件夹中的 DataV 组件。
  2. 进入工作区页面。
    创建成功的工作区会显示在页面右侧,单击工作区名称即可进入工作区页面。工作区页面包含以下四部分:

    • 侧边栏:包含了隐藏组件栏、查看帮助文档、退出登录等功能。
    • 组件栏:显示组件列表、管理组件。
      • 显示组件列表。
      • 包含了复制组件、重命名组件、删除组件、查看组件详细信息、刷新工作区等功能。
    • 中心画布区:
      • 中心画布区是用来展现组件,实时观测组件变化的区域。
      • 所有右侧工具栏的配置、数据修改都会实时展示在中心画布的组件上。
      • 组件的白框代表了组件的容器范围大小,每个方向上的白框都可以缩放来测试组件在任意方向缩放的表现。
    • 组件配置栏:分为配置数据交互发布4个面板。
      • 配置:配置页面包含了组件可变动的一些配置项,进行配置操作时,改动会立即生效。比如在此页面拖拽字号滑动条,组件中的文字字号立即随之变化。单击右上的保存,可以保存当前修改的配置,并将当前配置作为此组件的默认配置。

      • 数据:数据页面包含了组件的数据接口配置,数据页的数据一旦进行改动,组件都会进行相应的改动。单击右上的保存,可以保存当前修改的数据,并将当前数据作为此组件的默认数据。

      • 交互:交互页面包含了组件的交互说明。

      • 发布:发布页面包含了组件的基础属性、类型、图标和发布版本等配置,单击右上角的发布,即可发布组件。

  3. 删除工作区。
    在工作区列表中,鼠标移至某个工作区上,单击右上角的 X号,即可删除该工作区。

组件管理

  1. 新建组件。
    1. 单击工作区页面右侧的+新建组件,或者使用 Ctrl + N 快捷键,新建一个组件。

      组件创建成功后,在新建组件页面出现系统默认的基本文字组件。

    2. 单击基本文字组件,按照以下说明配置组件相关信息。

      • 组件名称:输入组件名称。
      • 组件类型:单击下拉框选择组件类型。
      • 发布ID:单击下拉框选择可用的组件包,如果没有可用的组件包,可单击+ 自定义,跳转到DataV控制台上创建组件包,具体方法请参见管理组件包

      • 组件ID:输入组件ID,例如basic-text
    3. 信息填写完成后,单击创建即可完成组件的创建。
      组件创建成功后即可在中心画布区中查看组件,并在右侧的配置栏对组件进行配置。

      组件创建成功后,在本地的组件包文件夹下会生成 index.jspackage.json文件,参考文档结构编辑这两个文件,可自定义组件的配置项。

  2. 预览组件。

    单击页面左侧组件列表中的某个组件,可在中心画布区查看该组件的样式。

  3. 复制/删除/重命名/查看组件详情。

    右键单击组件,选择制作副本/删除/重命名组件/显示属性,即可复制/删除/重命名/查看组件详情。

    您也可以选择某个组件,单击组件栏底部的 复制组件/ 删除组件图标,完成组件的复制/删除。

  4. 刷新工作区。

    单击组件栏底部的刷新工作区图标,即可完成工作区的刷新。当您修改了组件的配置项后,可通过此功能显示最新的组件配置项。