[基礎知識]Kotlinコマンドラインコンパイラの使い方

Read Time:1 Minute, 20 Second

すべての Kotlin リリースには、スタンドアロンバージョンのコンパイラが付属しています。最新バージョンは、手動またはパッケージマネージャー経由でダウンロードできます。

※コマンドラインコンパイラのインストールは、Kotlin を使用するための必須の手順ではありません。Kotlin アプリケーションを作成する一般的な方法は、IDE ( IntelliJ IDEAまたはAndroid Studio )を使用することです。追加のコンポーネントを必要とせずに、すぐに使用できる完全な Kotlin サポートを提供します。IDE で Kotlin を使い始める方法を学びます。

１．コンパイラをインストールする

手動インストール

（１）GitHub Releaseから最新バージョン (skotlin-compiler-1.8.20.zip) をダウンロードします。

（２）タンドアロンコンパイラをディレクトリに解凍し、必要に応じてそのbinディレクトリをシステムパスに追加します。このbinディレクトリには、Windows、macOS、および Linux で Kotlin をコンパイルして実行するために必要なスクリプトが含まれています。

※DKMAN! 経由で Kotlin コンパイラをインストールするには、ターミナルで次のコマンドを実行します。
> sdk install kotlin

２．アプリケーションを作成して実行する

（１）"Hello, World!"を表示する簡単なアプリケーションを Kotlin で作成します。hello.ktお気に入りのエディターで、次の行を含む新しいファイルを作成します。

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

（２）Kotlin コンパイラを使用してアプリケーションをコンパイルします。

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

※オプション（-include-runtime）は、生成されたクラスファイルの出力パスを示します。これは、ディレクトリまたは.jar-dファイルのいずれかです。このオプションは、Kotlin ランタイムライブラリを含めることで、結果の.jarファイルを自己完結型で実行可能にします。

※使用可能なすべてのオプションを表示するには、以下を実行します。

　　　kotlinc -help

（３）アプリケーションを実行します。

　　　java -jar hello.jar

３．ライブラリをコンパイルする

他の Kotlin アプリケーションで使用するライブラリを開発している場合は、 Kotlin ランタイムを含めずに.jarファイルをビルドできます。

　　　kotlinc hello.kt -d hello.jar

この方法でコンパイルされたバイナリは Kotlin ランタイムに依存するため、コンパイルされたライブラリが使用されるときは常に Kotlin ランタイムがクラスパスに存在することを確認する必要があります。

※以下のスクリプトを使用して、Kotlin コンパイラによって生成されたバイナリを実行することもできます。

　　　kotlin -classpath hello.jar HelloKt

　　　※HelloKtは、Kotlin コンパイラがhello.kt という名前のファイルに対して生成するメインクラス名です。

４．REPL を実行する

パラメーターなしでコンパイラーを実行して、対話型シェルを使用できます。このシェルでは、有効な Kotlin コードを入力して結果を確認できます。

５．スクリプトを実行する

Kotlin はスクリプト言語としても使用できます。スクリプトは、.kts最上位の実行可能コードを含む Kotlin ソースファイル ( ) です。

import java.io.File

// Get the passed in path, i.e. “-d some/path” or use the current 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 は、外部プロパティの追加、静的または動的な依存関係の提供など、スクリプトのカスタマイズの実験的なサポートを提供します。カスタマイズは、いわゆるスクリプト定義(適切なサポートコードを含む注釈付きの kotlin クラス) によって定義されます。スクリプトのファイル名拡張子は、適切な定義を選択するために使用されます。Kotlin カスタムスクリプトの詳細については、こちらをご覧ください。

適切な jar がコンパイルクラスパスに含まれている場合、適切に準備されたスクリプト定義が検出され、自動的に適用されます。-script-templatesまたは、オプションをコンパイラに渡すことで、定義を手動で指定できます。

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

詳細については、KEEP-75を参照してください。