Skip to content

Kotlin/JS を始める ​

このチュートリアルでは、Kotlin/JavaScript (Kotlin/JS) を使用してブラウザ向けの Web アプリケーションを作成する方法を説明します。 アプリケーションを作成するには、ご自身のワークフローに最適なツールを選択してください:

  • IntelliJ IDEA: バージョン管理システムからプロジェクトテンプレートをクローンし、IntelliJ IDEA で作業します。
  • Gradle ビルドシステム: プロジェクトのビルドファイルを手動で作成し、内部でセットアップがどのように機能しているかをより深く理解します。

ブラウザをターゲットにするだけでなく、Kotlin/JS を使って他の環境向けにコンパイルすることもできます。 詳細については、実行環境を参照してください。

IntelliJ IDEA でアプリケーションを作成する ​

Kotlin/JS Web アプリケーションを作成するには、IntelliJ IDEA を使用できます。

環境のセットアップ ​

  1. 最新バージョンの IntelliJ IDEA をダウンロードしてインストールします。
  2. Kotlin Multiplatform IDE プラグイン をインストールします(Kotlin Multiplatform Gradle プラグインと混同しないでください)。

プロジェクトの作成 ​

  1. IntelliJ IDEA で、File | New | Project from Version Control を選択します。

  2. Kotlin/JS テンプレートプロジェクト の URL を入力します:

    text
    https://github.com/Kotlin/kmp-js-wizard
  3. Clone をクリックします。

プロジェクトの設定 ​

  1. kmp-js-wizard/gradle/libs.versions.toml ファイルを開きます。これにはプロジェクトの依存関係のバージョンカタログが含まれています。

  2. Kotlin のバージョンが、Kotlin/JS をターゲットとする Web アプリケーションの作成に必要な Kotlin Multiplatform Gradle プラグインのバージョンと一致していることを確認します:

    toml
    [versions]
    kotlin = "2.4.21"
    
    [plugins]
    kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
  3. Gradle ファイルを同期します(libs.versions.toml ファイルを更新した場合)。ビルドファイルに表示される Load Gradle Changes アイコンをクリックします。

    Load the Gradle changes ボタン

    または、Gradle ツールウィンドウの更新ボタンをクリックします。

マルチプラットフォームプロジェクトの Gradle 設定の詳細については、Multiplatform Gradle DSL リファレンス を参照してください。

アプリケーションのビルドと実行 ​

  1. src/jsMain/kotlin/Main.kt ファイルを開きます。

    • src/jsMain/kotlin/ ディレクトリには、プロジェクトの JavaScript ターゲット向けのメインの Kotlin ソースファイルが含まれています。
    • Main.kt ファイルには、kotlinx.browser API を使用してブラウザページ上に「Hello, Kotlin/JS!」を描画するコードが含まれています。
  2. main() 関数にある Run アイコンをクリックして、コードを実行します。

    アプリケーションを実行

ブラウザで Web アプリケーションが自動的に開きます。 あるいは、実行が完了した後にブラウザで次の URL を開くこともできます:

text
   http://localhost:8080/

Web アプリケーションが表示されます:

アプリケーションの出力

アプリケーションを初めて実行すると、IntelliJ IDEA は上部バーに対応する実行構成(jsMain [js])を作成します:

Gradle 実行構成

Ultimate サブスクリプション付きの IntelliJ IDEA では、JS Debugger を使用して IDE から直接コードをデバッグできます。

継続的ビルド(Continuous Build)を有効にする ​

Gradle は、変更を加えるたびにプロジェクトを自動的にリビルドできます:

  1. 実行構成のリストで jsMain [js] を選択し、More Actions | Edit をクリックします。

    Gradle 実行構成の編集

  2. Run/Debug Configurations ダイアログの Run フィールドに、jsBrowserDevelopmentRun --continuous と入力します。

    継続的実行の構成

  3. OK をクリックします。

これで、アプリケーションを実行して何らかの変更を加えると、クラスファイルを保存(Ctrl + S / Cmd + S)または変更するたびに、Gradle がプロジェクトの増分ビルドを自動的に実行し、ブラウザをホットリロードします。

アプリケーションを変更する ​

単語内の文字数をカウントする機能を追加して、アプリケーションを変更してみましょう。

入力要素の追加 ​

  1. src/jsMain/kotlin/Main.kt ファイルで、拡張関数 を使用してユーザー入力を読み取る HTML input 要素 を追加します:

    kotlin
    // Element.appendMessage() 関数を置き換えます
    fun Element.appendInput() {
        val input = document.createElement("input")
        appendChild(input)
    }
  2. main() 内で appendInput() 関数を呼び出します。これによりページに入力要素が表示されます:

    kotlin
    fun main() {
        // document.body!!.appendMessage(message) を置き換えます
        document.body?.appendInput()
    }
  3. アプリケーションを再度実行します。

    アプリケーションは次のようになります:

    入力要素を追加したアプリケーション

入力イベント処理の追加 ​

  1. appendInput() 関数の内部にリスナーを追加して、入力値を読み取り、変更に反応するようにします:

    kotlin
    // 現在の appendInput() 関数を置き換えます
    fun Element.appendInput(onChange: (String) -> Unit = {}) {
        val input = document.createElement("input").apply {
            addEventListener("change") { event ->
                onChange(event.target.unsafeCast<HTMLInputElement>().value)
            }
        }
        appendChild(input)
    }
  2. IDE のサジェストに従って、HTMLInputElement の依存関係をインポートします。

    依存関係のインポート

  3. main() で onChange コールバックを呼び出します。これにより、入力値が読み取られて処理されます:

    kotlin
    fun main() {
        // document.body?.appendInput() を置き換えます
        document.body?.appendInput(onChange = { println(it) })
    }

出力要素の追加 ​

  1. 段落を作成する拡張関数を定義して、出力を表示するためのテキスト要素を追加します:

    kotlin
     fun Element.appendTextContainer(): Element {
         return document.createElement("p").also(::appendChild)
     }
  2. main() で appendTextContainer() 関数を呼び出します。これにより出力要素が作成されます:

    kotlin
     fun main() {
         // 出力用のテキストコンテナを作成します
         // val message = Message(topic = "Kotlin/JS", content = "Hello!") を置き換えます
         val output = document.body?.appendTextContainer()
    
         // 入力値を読み取ります
         document.body?.appendInput(onChange = { println(it) })
     }

入力を処理して文字数をカウントする ​

空白を削除し、文字数をカウントして出力を表示するように入力を処理します。

main() 関数内の appendInput() 関数に次のコードを追加します:

kotlin
fun main() {
    // 出力用のテキストコンテナを作成します
    val output = document.body?.appendTextContainer()

    // 入力値を読み取ります
    // 現在の appendInput() 関数を置き換えます
    document.body?.appendInput(onChange = { name ->
        name.replace(" ", "").let {
            output?.textContent = "Your name contains ${it.length} letters"
        }
    })
}

上記のコードについて:

アプリケーションの実行 ​

  1. アプリケーションを実行します。
  2. ご自身の名前を入力します。
  3. Enter を押します。

結果を確認できます:

アプリケーションの出力

入力を処理して一意な(重複を除いた)文字数をカウントする ​

追加の演習として、入力を処理して単語内の一意な(ユニークな)文字数を計算し、表示してみましょう:

  1. src/jsMain/kotlin/Main.kt ファイルで、String に対する .countDistinctCharacters() 拡張関数 を追加します:

    kotlin
    fun String.countDistinctCharacters() = lowercase().toList().distinct().count()

    上記のコードについて:

  2. main() で .countDistinctCharacters() 関数を呼び出します。これにより、名前の一意な文字数がカウントされます:

    kotlin
     fun main() {
         // 出力用のテキストコンテナを作成します
         val output = document.body?.appendTextContainer()
    
         // 入力値を読み取ります
         document.body?.appendInput(onChange = { name ->
             name.replace(" ", "").let {
                 // 一意な文字数を出力します
                 // output?.textContent = "Your name contains ${it.length} letters" を置き換えます
                 output?.textContent = "Your name contains ${it.countDistinctCharacters()} unique letters"
             }
         })
    }
  3. 手順に従って アプリケーションを実行し、名前を入力 します。

結果を確認できます:

アプリケーションの出力

Gradle を使用してアプリケーションを作成する ​

このセクションでは、Gradle を使用して Kotlin/JS アプリケーションを手動で作成する方法を学びます。

Gradle は、Kotlin/JS および Kotlin Multiplatform プロジェクトのデフォルトのビルドシステムです。 また、Java、Android、およびその他のエコシステムでも広く使用されています。

プロジェクトファイルの作成 ​

  1. Kotlin Gradle プラグイン (KGP) と互換性のある Gradle バージョンを使用していることを確認してください。 詳細については、互換性テーブル を参照してください。

  2. ファイルエクスプローラー、コマンドライン、またはお好みのツールを使用して、プロジェクト用の空のディレクトリを作成します。

  3. プロジェクトディレクトリ内に、次の内容の build.gradle.kts ファイルを作成します:

    kotlin
    // build.gradle.kts
    plugins {
        kotlin("multiplatform") version "2.4.21"
    }
    
    repositories {
        mavenCentral()
    }
    
    kotlin {
        js {
            // ブラウザで実行する場合は browser()、Node.js で実行する場合は nodejs() を使用します
            browser() 
            binaries.executable()
        }
    }
    groovy
    // build.gradle
    plugins {
        id 'org.jetbrains.kotlin.multiplatform' version '2.4.21'
    }
    
    repositories {
        mavenCentral()
    }
    
    kotlin {
        js {
            // ブラウザで実行する場合は browser()、Node.js で実行する場合は nodejs() を使用します
            browser() 
            binaries.executable()
        }
    }

    browser() や nodejs() など、さまざまな 実行環境 を使用できます。 各環境はコードが実行される場所を定義し、Gradle がプロジェクト内でタスク名を生成する方法を決定します。

  4. プロジェクトディレクトリ内に、空の settings.gradle.kts ファイルを作成します。

  5. プロジェクトディレクトリ内に、src/jsMain/kotlin ディレクトリを作成します。

  6. src/jsMain/kotlin ディレクトリ内に、次の内容の hello.kt ファイルを追加します:

    kotlin
    fun main() {
        println("Hello, Kotlin/JS!")
    }

    慣例として、すべてのソースコードは src/<ターゲット名>[Main|Test]/kotlin ディレクトリに配置されます:

    • Main はソースコードの配置場所です。
    • Test はテストの配置場所です。
    • <ターゲット名> はターゲットプラットフォームに対応します(この場合は js)。

browser 環境の場合

browser 環境を使用している場合は、次の手順に従ってください。 nodejs 環境を使用している場合は、プロジェクトのビルドと実行 セクションに進んでください。

  1. プロジェクトディレクトリ内に、src/jsMain/resources ディレクトリを作成します。

  2. src/jsMain/resources ディレクトリ内に、次の内容の index.html ファイルを作成します:

    html
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Application title</title>
    </head>
    <body>
        <script src="$NAME_OF_YOUR_PROJECT_DIRECTORY.js"></script>
    </body>
    </html>
  3. <$NAME_OF_YOUR_PROJECT_DIRECTORY> プレースホルダーを、ご自身のプロジェクトディレクトリの名前に置き換えます。

プロジェクトのビルドと実行 ​

プロジェクトをビルドするには、ルートプロジェクトディレクトリから次のコマンドを実行します:

bash
# ブラウザの場合
gradle jsBrowserDevelopmentRun

# または

# Node.js の場合
gradle jsNodeDevelopmentRun

browser 環境を使用している場合、ブラウザが index.html ファイルを開き、ブラウザコンソールに "Hello, Kotlin/JS!" と出力されるのを確認できます。 コンソールは、Ctrl + Shift + J / Cmd + Option + J コマンドを使用して開くことができます。

アプリケーションの出力

nodejs 環境を使用している場合は、ターミナルに "Hello, Kotlin/JS!" と出力されるのが確認できます。

アプリケーションの出力

IDE でプロジェクトを開く ​

Gradle をサポートする任意の IDE でプロジェクトを開くことができます。

IntelliJ IDEA を使用する場合:

  1. File | Open を選択します。
  2. プロジェクトディレクトリを見つけます。
  3. Open をクリックします。

IntelliJ IDEA は、それが Kotlin/JS プロジェクトであるかどうかを自動的に検出します。 プロジェクトに問題が発生した場合、IntelliJ IDEA は Build ペインにエラーメッセージを表示します。

次のステップ ​