How to run a Kotlin script on GitHub Actions?

在GitHub Actions上运行Kotlin脚本是一个非常实用的技术，特别是当需要在自动化构建和测试流程中集成Kotlin代码时。下面，我将详细介绍如何在GitHub Actions中设置和运行Kotlin脚本的步骤。

步骤1: 准备Kotlin脚本

首先，确保你的项目中已经包含了一个或多个Kotlin脚本。例如，假设有一个简单的Kotlin脚本位于scripts目录下，文件名为hello.kts，内容如下：

kotlin
println("Hello from Kotlin script!")

步骤2: 设置GitHub仓库

确保你的Kotlin脚本已经被推送到GitHub仓库中。如果还没有仓库，可以在GitHub上创建一个新仓库，并将项目代码推送到这个仓库。

步骤3: 创建GitHub Actions工作流文件

在你的GitHub仓库中，创建一个.github/workflows目录（如果不存在的话），并在该目录下创建一个新的YAML文件，例如run-kotlin.yml。这个文件将定义GitHub Actions的工作流。

步骤4: 配置工作流

在run-kotlin.yml文件中，你需要定义一个工作流来安装Kotlin环境并运行Kotlin脚本。以下是一个基本的配置示例：

yaml
name: Run Kotlin Script

on: [push]

jobs:
  run-script:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
      name: Check out repository

    - name: Set up JDK 11
      uses: actions/setup-java@v1
      with:
        java-version: '11'  # 设置JDK版本

    - name: Run Kotlin script
      run: |
        curl -s https://get.sdkman.io | bash
        source "$HOME/.sdkman/bin/sdkman-init.sh"
        sdk install kotlin
        kotlinc -script scripts/hello.kts  # 运行Kotlin脚本

解释

1. 触发条件：这个工作流将在代码被推送到仓库时触发。
2. 工作流作业：定义了一个作业run-script，它在GitHub提供的最新Ubuntu虚拟环境中运行。
3. 步骤：
   • 检出代码：actions/checkout@v2用于将GitHub仓库的代码检出到运行工作流的虚拟环境中。
   • 设置JDK：由于Kotlin是基于Java的，因此需要Java环境。这里使用actions/setup-java@v1来安装JDK 11。
   • 运行Kotlin脚本：首先使用curl下载并安装SDKMAN，然后通过SDKMAN安装Kotlin编译器和运行环境。最后，使用kotlinc -script命令执行Kotlin脚本。

步骤5: 提交并推送更改

将run-kotlin.yml文件提交并推送到你的GitHub仓库。GitHub将自动识别.github/workflows目录中的YAML文件，并在满足触发条件时执行定义的工作流。

通过以上步骤，你就可以在GitHub Actions上成功运行Kotlin脚本了。这种自动化方式非常适合进行持续集成和持续部署的场景。