Kotlin 命令行编译器

1. 使用 Kotlin 创建一个简单的控制台 JVM 应用程序, 它输出 "Hello, World!". 在代码编辑器中, 创建一个名为 hello.kt 的新文件, 包含以下代码:

   fun main() {
       println("Hello, World!")
   }

2. 使用 Kotlin 编译器编译应用程序:

   kotlinc hello.kt -include-runtime -d hello.jar

   • -d 选项指定生成的类文件的输出路径, 可以是一个目录或一个 .jar 文件.

   • -include-runtime 选项让生成的 .jar 文件成为自包含文件, 其中包含了 Kotlin 运行期库, 因此可以独立运行.

   要查看所有可用的选项, 请运行:

   kotlinc -help

3. 运行应用程序:

   java -jar hello.jar

如果你在开发库, 供其他 Kotlin 应用程序使用, 那么构建 .jar 文件时可以不包含 Kotlin 运行库:

kotlinc hello.kt -d hello.jar

由于这种方式编译的二进制文件依赖于 Kotlin 运行库, 当你编译的库被使用时, 你需要确保 Kotlin 运行库存在于类路径中.

你也可以使用 kotlin 脚本来运行 Kotlin 编译器生成的二进制文件:

kotlin -classpath hello.jar HelloKt

HelloKt 是 Kotlin 编译器为 hello.kt 文件生成的 main 类名.

你可以不带任何参数来运行编译器, 启动一个交互环境. 在这个环境中, 你可以输入任何有效的 Kotlin 代码, 并看到结果.

你也可以将 Kotlin 用作脚本语言. 一个 Kotlin 脚本就是一个 Kotlin 源代码文件 (.kts), 其中包含顶级(Top-Level)可执行代码.

import java.io.File

// 得到参数传入的路径, 也就是 "-d some/path", 或使用当前路径.
val path = if (args.contains("-d")) args[1 + args.indexOf("-d")]
           else "."

val folders = File(path).listFiles { file -> file.isDirectory() }
folders?.forEach { folder -> println(folder) }

要运行一个脚本, 请向编译器传递 -script 选项, 加上对应的脚本文件:

kotlinc -script list_folders.kts -- -d <path_to_folder_to_inspect>

Kotlin 支持脚本的自定义功能(实验性功能), 例如添加外部属性, 提供静态或动态依赖项, 等等. 自定义通过所谓的 脚本定义(Script Definition) 来定义 - 它是带注解的 Kotlin 类, 带有适当的支持代码. 通过脚本文件名称扩展来选择适当的定义. 详情请参见 Kotlin 自定义脚本.

在编译类路径中包含了正确的 jar 文件时, 会自动检测并使用适当准备的脚本定义. 或者, 你也可以向编译器传递 -script-templates 选项, 手动指定脚本定义:

kotlinc -script-templates org.example.CustomScriptDefinition -script custom.script1.kts

更多详情请参见 KEEP-75.