脚本文件的准备

首先，准备用于编写处理的脚本文件(Python文件) 。
起动CRI Atom Craft，从“脚本”菜单选择“脚本列表...”，显示脚本列表窗口。
从脚本列表选择“tutorials [CRI]”，单击脚本文件的“新建”按钮。

单击“新建”按钮后，将显示创建文件对话框。
在文件名输入“tutorial01-1_helloworld.py”，单击保存按钮以保存文件。
已保存的脚本文件“tutorial01-1_helloworld”将显示在脚本列表上。

脚本说明

以上步骤显示了如何创建脚本文件。
可以在脚本列表的“samples [CRI]”中找到多个示例脚本。
也可以看到除了已创建的“tutorial01-1_helloworld”，其他的脚本文件会在脚本列表上显示说明。

在脚本列表中具有使用脚本中的下述格式编写的注释读取，并显示于脚本列表的“说明”栏的功能。

# --Description: 说明文

双击脚本列表的“tutorial01-1_helloworld”，使用从脚本编辑器运行脚本打开脚本文件，请如下所示输入说明用的注释。

# --Description:[教程] 在脚本日志上显示Hello World

输入注释后，单击脚本编辑器的工具栏的[保存]按钮以保存脚本。
可以返回脚本列表确认“tutorial01-1_helloworld”脚本的说明显示。

关于脚本的说明格式的详细信息，请参照脚本编辑器的扩展格式的“脚本的说明格式”。

编写脚本说明后，可以使用属于Python 标准的字符串输出函数的 print 函数，在脚本日志上显示出“Hello, World”。

返回从脚本编辑器运行脚本，如下所示进行输入。

print("Hello, World")

从脚本编辑器的工具栏，单击[保存]按钮保存脚本。

运行已创建的脚本，请尝试在脚本日志窗口上显示“Hello, World”。
返回脚本列表的窗口，按下[显示日志]按钮以显示脚本日志窗口。

按下工具栏中的[执行]按钮运行脚本，可以确认在脚本日志窗口中显示的“Hello, World”字符串。

以上步骤显示了如何使用Python的 print 函数，在脚本日志显示“Hello, World”的字符。
下一步，让我们使用CRI Atom Craft API 的 debug模块在脚本日志上显示“Hello, World”。

CRI Atom Craft包含了用于操作CRI Atom Craft的Python模块。
要在Python使用外部的Python模块时，请在脚本中使用import来声明模块的使用。

使用CRI Atom Craft API 的 debug模块时，请如下编写脚本。

import cri.atomcraft.debug

关于Debug模块和CRI Atom Craft API的其他模块，请参照“ 模块参照 ”。

注解: 编写import 模块名”后，将可以在脚本内使用该模块。
如果像“import 模块名 as 置换的名称”这样编写，可将导入的模块置换为指定的名称，以较短的代码访问模块。
import cri.atomcraft.debug as acdebug

声明 import 后，将可以使用CRI Atom Craft API 的 debug模块。

现在请尝试使用 Debug 模块显示“Hello, World”。
Debug模块中准备了多个字符串输出函数，但这里我们使用 log 函数显示“Hello, World”。

在 import cri.atomcraft.debug 声明后，请按照如下编写脚本。

cri.atomcraft.debug.log("Hello, World")

保存脚本后，请在运行脚本前按脚本日志窗口的“清除”按钮，清除日志显示。
运行脚本时，可与 print 函数的输出对照，确认“Hello, World”的字符已显示为两行。

注解: Python标准输出 print 函数和Debug模块 log 函数的差异
在从从脚本编辑器运行脚本进行脚本的本地运行中使用print 函数或者 log 函数时，两者都会输出日志到脚本日志，没有实质性的差异。
但是，在 Python脚本的远程运行使用print函数时，在CRI Atom Craft 的脚本日志上则不会输出消息，消息的输出将于执行应用程序侧进行。
这种差异的起因是 print 函数的处理会在脚本执行程序中进行。相反， log 函数即使在远程运行时也仅输出到脚本日志。

从外部应用程序通过远程运行脚本操作CRI Atom Craft时，有时也需要在外部应用程序侧进行日志输出的情况。
可以通过区分使用 print 函数或 log 函数分开输出目标。

[远程运行例：从终端通过远程运行连接CRI Atom Craft后执行 print 函数]

注解

此教程中使用了log函数的日志输出以达到显示“Hello, World”字符的目的。实际编写操作 CRI Atom Craft 的脚本处理时，日志的输出主要还是用于确认执行中的处理，以调试为目的居多。
在 debug模块中，除 log 函数外，还配置了警告输出用的 warning 函数。

函数名	说明
log	输出标准的日志
warning	输出警告的日志输出高亮显示的日志

通过 warning 函数输出的字符串，在CRI Atom Craft的日志视图上用彩色字符显示。（不支持脚本日志的彩色输出）
可以通过区分使用合适的函数实现高效的脚本执行的确认。