编写脚本

编写脚本

在 scripts 目录中创建任意 .kts 后缀的文件即视为 Artifex 脚本，可以使用目录分类。

基本规范

文件名仅允许使用 字母、数字、下划线 且不允许数字开头，与类名命名规范大致相同。

正确的：

• Test.kts
• TestScript.kts
• my_script.kts
• my_script_1.kts

错误的：

• 1. test.kts
• test-script.kts
• 【测试】test.kts

代码始终遵循 Kotlin Coding Conventions 约定。

创建演示脚本

请跟随本篇内容，向您演示如何快速使用 Artifex 编写脚本：

第一步：

在 scripts 目录中创建名为 test.kts 文件，文件编码为 UTF-8 格式；

第二步：

在 test.kts 文件中写入 Kotlin 代码，无需 main 函数；

info("你好，世界")

第三步：

在控制台中输入 /artifex run test 命令；

> art run test
[00:00:00 INFO]: [Artifex] 正在编译...
[00:00:00 INFO]: [Artifex] > 编译参数: {}
[00:00:00 INFO]: [Artifex] 编译成功 (0s)
[00:00:00 INFO]: [Artifex] 正在运行...
[00:00:00 INFO]: [Artifex] > 运行参数: {}
[00:00:00 INFO]: [Artifex] > 编译参数: {}
[00:00:00 INFO]: [Artifex] 你好，世界
[00:00:00 INFO]: [Artifex] 脚本 Test 已释放.
[00:00:00 INFO]: [Artifex] 运行成功 (0s)

第四步：

尝试向脚本传递参数，修改 test.kts 中的内容：

info("你好，${runArgs["hello"]}")

在控制台中输入 /artifex run test -Ahello 坏黑 命令；

> art run test
[00:00:00 INFO]: [Artifex] 脚本内容变动, 将重新编译...
[00:00:00 INFO]: [Artifex] 原版本: 829c347e78f001f602977bd28aa2142f9d554253
[00:00:00 INFO]: [Artifex] 新版本: a8c79ce2f1668bc4f8247ccc86004c2263b7d6f1
[00:00:00 INFO]: [Artifex] 正在编译...
[00:00:00 INFO]: [Artifex] > 编译参数: {}
[00:00:00 INFO]: [Artifex] 编译成功 (0s)
[00:00:00 INFO]: [Artifex] 正在运行...
[00:00:00 INFO]: [Artifex] > 运行参数: {hello=坏黑}
[00:00:00 INFO]: [Artifex] > 编译参数: {}
[00:00:00 INFO]: [Artifex] 你好，坏黑
[00:00:00 INFO]: [Artifex] 脚本 Test 已释放.
[00:00:00 INFO]: [Artifex] 运行成功 (0s)

至此，您已理解 Artifex 最基本的使用方式。