简体中文
English 简体中文 繁體中文
Methodox 首页

你的第一个程序

本页面将制作一个文档,它把 2 和 5 相加并打印结果。整个过程只需五分钟,在此过程中你将从工作负载创建文档,通过键盘和从连线放置节点,连接它们,以 Divooka Compute 的两种模式运行程序,并查看它打印的内容。

创建文档

  1. 在开始屏幕上按 New document,或在任意位置按 Ctrl+N。
  2. 一个保存对话框会询问新文档应存放在哪里。每个文档从创建起就是一个文件——文档通过其他文件相对于自身的位置来引用它们,因此它必须先有一个自己的位置。选择一个文件夹,将其命名为 Hello 并保存。Divooka 文档以 .dvk 结尾。
  3. Choose a workload 卡片会询问文档以什么内容开始。工作负载是一组起始包:文档将引用它们,工具箱托盘会提供它们的节点。Blank(只有基本必需内容)和 General Purpose 排在最前,其余按字母顺序排列,默认高亮 Blank。选择 General Purpose,它会添加平台包:文件、进程以及向控制台打印。单击它,或按 ↓;输入内容会将列表筛选为名称中包含所输入内容的工作负载。
  4. 在 Entry graph(文档运行开始时所用的图的种类)下,保留 Flows,然后按 Create document。

Choose a workload 卡片:选中了 General Purpose 的工作负载列表、选中了 Flows 的 Entry graph 选项,以及 Create document

状态栏显示 Created Hello.dvk from General Purpose - 3 packages referenced。文档在一个单独的标签页中打开,画布为空,文档大纲在 References 下列出这三个包。Flows 图是一个自由形式的画布,值沿着连线传递;图和成员介绍了其他种类的图。

两个数

  1. 将指针指向画布左侧,按 Ctrl+1。指针下方会出现一个 Number 节点。单击其中的输入框,输入 2,然后按 Enter。
  2. 将指针稍微向下移动,再按一次 Ctrl+1;为这个节点输入 5。

节点的输入位于其左侧,输出位于其右侧:每个 Number 都有一个输出,即其右边缘上的圆点。

相加

有好几个节点都叫 Add——除了数字之外,还有用于日期、时间、向量和列表的。在托盘中输入 Add 时,两个数相加的 Add 会排在最前;从 Number 的连线开始操作,还能在放置时就已连好线:

  1. 从第一个 Number 的输出圆点开始拖动,在其右侧的空白处松开。工具箱托盘会打开,并带有一个显示 Filter for Number 的筛选标签:它只提供可以接收数字的节点。
  2. 输入 Add。第一个候选项是 Number Routines 下的 Add,托盘右半部分会说明它的作用:Adds two numbers and returns the sum.
  3. 按 Enter。Add 节点被放置,第一个 Number 已连接到它的第一个输入 Summand1。
  4. 从第二个 Number 的输出圆点拖动到 Add 的第二个输入 Summand2。

从 Number 的连线打开的工具箱托盘,正在搜索 Add:Number Routines 下的 Add 被高亮显示,右侧显示其说明

  1. 将指针指向 Add 的右侧,按 Ctrl+Space,输入 Print Line,然后按 Enter。
  2. 从 Add 的输出圆点拖动到 Print Line 的输入 Message。

将 Add 的连线放到空白处并在那里选择 Print Line,可以一次完成这两步:托盘会从数字的连线提供 Print Line,并将其连好。

连线只能落在其值可以去往的地方。连接到某个输入后,该输入自身的值框会被隐藏:以连线传来的值为准。

运行

Flows 图会运行标记为 Active 的节点,以及它们所需的一切。目前还没有任何节点是 active 的,所以:

  1. 单击 Print Line 将其选中,然后按 Space。它被标记为 active,画布上方的一行显示 4 nodes · 3 wires · 1 active · 4 will run。
  2. 按工具栏上的 Run,或按 F5。

工具栏的 Interpreted / Compiled 开关处于 Interpreted,这是文档打开时的模式:运行会逐个节点进行。状态栏会显示运行了多少个节点以及耗时多久——4 nodes in 几毫秒——并且每个运行过的节点下方都会显示 done。Properties 面板切换到其 Run 视图,显示 Finished。Print Line 打印了一行,因此状态栏的控制台计数显示 1 line,旁边带一个圆点。单击它,或按 Ctrl+`,即可打开控制台:Print Line 的那一行显示 7。

运行后完成的程序:两个 Number 连接到 Add,Add 连接到 Print Line,Run 视图显示 Finished,画布下方打开的控制台中显示 Print Line 打印的那一行:7

将第一个 Number 改为 40,再按一次 F5:控制台显示 45。

以编译方式运行

在工具栏的开关上按 Compiled,然后按 F5。这一次,Divooka Compute 会先将文档构建为程序,然后运行该程序:状态栏显示 Ran compiled in 和耗时,控制台再次显示 7。节点下方不显示任何内容,因为编译后的程序只报告它打印和返回的内容。按 Interpreted 即可切换回去。运行和控制台说明了何时应使用哪种模式。

保存

按 Ctrl+S,或按工具栏上的 Save。状态栏显示 Saved Hello.dvk。下次打开时,该文档会出现在开始屏幕的 Recent 下。

当文档所在的文件夹位于工作区中时,工作区面板会在该文件夹下列出该文档,否则列在 Ungrouped 下。按 Ctrl+Shift+O 并选择该文件夹即可以它为工作目录:之后只需单击一下即可打开其中的文档。

下一步

  • 节点、引脚和连线——选择、删除、复制、添加标签和整理。
  • 图和成员——逐步运行的 Routine,以及其他种类的图。
  • 引用——文档所使用的包,以及在一个文档中使用另一个文档。
  • 示例——可以打开、运行和拆解学习的更大型程序。