Action Maker 程序与 Divooka 文档
Action Maker 没有自己的文件格式。程序就是一个 Divooka 文档(.dvk),与 Divooka Explore 和 Divooka Compute 打开的是同一种文档,而各行是读写文档中 Routine 的另一种方式。在 Divooka Compute 中打开保存好的程序,你看到的是同一个程序以画布上的节点呈现;在画布上编写一个 Routine,Action Maker 通常也能把它读成各行。
如果你两者都用,这一页就是为你写的。
简而言之
- 一个文档,两种视图。 Action Maker 把文档的 Routine 显示为各行。Divooka Explore 和 Compute 把同样的 Routine 显示为节点和连线。
- 没有自己的运行时。 Action Maker 中的 Run 用 Divooka 自己的解释器运行文档,与编辑器运行 Routine 的方式完全相同,因此程序无论在哪里运行,行为都一样。
- 它的动作就是发行版的动作。 Action Maker 提供的是与它一起安装的 Divooka 的动作:随 Divooka Compute 提供时就是 Compute 的全部动作,随 Explore 提供时就是 Explore 的全部动作,免费的独立版则是一个较小的集合。
程序如何保存
| 在 Action Maker 中 | 在 Divooka 文档中 |
|---|---|
| Main | 文档的入口图:一个名为 Main 的 Routine |
| 另一个例程 | 文档中位于 Main 旁边的一个 Routine;它的输入是其 Begin 节点的输出,它的输出是其 Return 节点的输入 |
| 例程的变量 | 该 Routine 的局部变量 |
| 数据成员 | 文档的数据成员,由其中每个图共享——包括 Action Maker 不显示的图 |
| 一行 | 一个节点,作为语句放置,并按各行的顺序沿执行连线连接 |
| If、循环、Sequence、Try | 它们的流程控制节点;所包含的每个块都挂在它自己的输出上——True 和 False、Next、Sequence 的各部分 |
| 输入的值 | 写在节点输入上的值,或连到该输入上的一个小 Number、Text 或 Truth 节点 |
| 一个 Operation | 一个没有执行引脚的节点(纯节点),连到该输入上 |
| 循环的当前值、前面某行的结果 | 一条来自那个节点输出的连线 |
结果的名称,例如 multiply1 |
节点在 Properties 面板中的 Name,编译后的代码也使用它 |
| 行注释 | 节点的标签 |
| 块注释 | 一个分组,框住流程控制以及它所包含的各行,不多不少 |
| 断点 | 节点的断点 |
在画布上,节点按各行的阅读顺序布局:每一行在其例程中占一个单独的横带,它算出的值位于其左下方,每个块位于包含它的那一行下面。
编辑时会发生什么
在 Action Maker 中。 每次保存和每次运行时,Action Maker 都会根据各行重新写出它所显示的每个 Routine:它清除该 Routine 的节点——保留 Begin、变量以及注释、分组和绘图——为每一行重新放置一个节点,并重新布局。文档中的其他一切都保持原样:Function、Events 图、类型、标题和资源。
在 Divooka Explore 或 Compute 中。 就是普通的编辑。下次 Action Maker 打开该文档时,它会从每个 Routine 的 Begin 开始沿执行连线读取,一个节点一行。
If 之后的行
在 Divooka 中,Branch 的两条路径永远不会再汇合,Sequence 也没有“之后”。所以当你在 Action Maker 中在 If 之后写行时,文档会用 Divooka 的方式表达:一个 Sequence,第一部分是 If,第二部分是它后面的各行。Action Maker 会把这个 Sequence 读回成你写的那些行。
在画布上,你会看到一个你从未添加过的 Sequence 节点。别去动它:如果你给它添加第三部分,或者在第一部分中放入 If 以外的东西,Action Maker 就会把它读成一个 Sequence 行——程序还是同一个,只是写法不同。单步执行这样的程序时,运行也会经过这个 Sequence,而它并不对应任何一行。
需要注意的事项
Action Maker 掌管它所显示的 Routine 的布局。 你在某个 Routine 中手动排列的节点,会在 Action Maker 下次保存或运行程序时被重新布局。你在画布上添加的注释、分组和绘图会被保留,但它们周围的节点会移动,所以你画的分组可能不再框住原来的内容。如果某个 Routine 的排列对你很重要,就只在一个工具中编辑它。
结果的名称是给出的,不会被保留。 你在 Divooka Compute 的 Properties 中为节点输入的 Name,会在 Action Maker 下次写出该 Routine 时,被 Action Maker 为那一行的结果所起的名称(multiply、multiply1……)取代。在更上方插入一行,会让它下面的名称重新编号。
有些东西不能成为行。 Action Maker 会把它无法表达为行的内容显示为黄色标记的行,并且在该行被替换之前拒绝保存或运行程序,因此它不理解的文档永远不会被改写成不同的内容。以下情况会这样:
- Switch;
- 这一份 Action Maker 没有的动作——例如在 Divooka Compute 中编写、使用了免费独立版所不带的包的文档;
- 来自某个行无法指向的位置的连线,例如在另一个块内部算出的值。
Function 永远不会成为行。 Function 是数据流图,没有可读的语句顺序,所以 Action Maker 只显示文档的 Routine。Function 和其他图都保持原样。
被两行共用的计算会变成两份。 在画布上,一个纯节点可以同时供给两条语句。写成各行时,每一行都有自己的 Operation,所以 Action Maker 写出该 Routine 后,那个节点会有两份。对大多数计算来说,这没有区别。对于应当只运行一次的计算——一个随机数、某个耗时的操作——先把它的结果存进一个变量,再在两行中读取这个变量。
注释就是标签,标签就是注释。 如果一个节点的标签与它自己的标题不同,Action Maker 会把这个标签显示为该行的注释。只有当一个分组恰好框住一个流程控制以及它所包含的各行时,它才会成为块注释;其他分组按原样留在画布上。
变量按名称和类型匹配。 在画布上重命名局部变量或修改其类型,在 Action Maker 中会被读成另一个变量。数据成员在两个工具中重命名都是安全的:它们在声明处被修改,读取它们的每个图都会随之更新。
在 Divooka Compute 中对 Routine 的单个节点所做的设置是 Action Maker 不了解的,所以在 Action Maker 写出该 Routine 之后,请检查这些设置。
入口必须是 Routine。 Action Maker 打开入口图是 Routine 的文档。以 Events 图或 Flows 图开始的文档会被拒绝,并显示相应的提示。