Kotlinでコルーチンを使う準備！依存関係と基本セットアップ

先生と生徒の会話形式で理解しよう

生徒

「Kotlinのコルーチンを使ってみたいんですが、どうやって始めればいいんですか？」

先生

「コルーチンを使うには、まず依存関係をプロジェクトに追加する必要がありますよ。セットアップの準備が大切です。」

生徒

「依存関係ってなんですか？聞いたことないです…」

先生

「簡単にいうと、他の人が作った便利な道具を使うための申込みのようなものです。順番に説明していきますね。」

1. Kotlinでコルーチンを使うには？

Kotlinでコルーチン（coroutine）を使うためには、まず準備が必要です。この準備を「セットアップ」や「依存関係の追加」と呼びます。

依存関係（いぞんかんけい）とは、他のプログラムやライブラリに頼ることを意味します。たとえば、自分で時計を作るのは大変なので、市販の時計を買って使うようなイメージです。

コルーチンは、JetBrains（ジェットブレインズ）社が提供する特別なツールキットで、標準では含まれていません。そのため、自分のKotlinプロジェクトに追加する必要があります。

2. Gradleとは？Kotlinプロジェクトの道具箱

Kotlinのプロジェクトでは、「Gradle（グレードル）」というツールを使って、必要なライブラリ（便利な道具）を追加します。

Gradleは、プログラムのビルド（組み立て）や依存関係の管理をしてくれるお手伝いロボットのようなものです。

このGradleのファイルに「コルーチンを使いたいです」と書いておくと、自動でダウンロードして準備してくれる仕組みになっています。

3. コルーチンの依存関係を追加してみよう

ここでは、Kotlinでよく使われるbuild.gradle.ktsというファイルを使ってコルーチンを追加する方法を紹介します。


// build.gradle.kts（Kotlin DSLの場合）
dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
}

このコードを追加することで、コルーチンに必要な道具が自動で使えるようになります。

バージョン番号（例：1.7.3）は時々変わるので、公式サイトで最新バージョンをチェックするのがおすすめです。

4. Kotlinプロジェクトでの全体的なセットアップ例

最初からKotlinのプロジェクトを作るときの全体的な設定例も見てみましょう。


// build.gradle.kts の一例（Kotlin JVMプロジェクト）
plugins {
    kotlin("jvm") version "1.9.10"
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
}

このように書いておくことで、Kotlinの基本とコルーチンの両方が使えるようになります。

5. IntelliJ IDEAでのライブラリ追加方法

IntelliJ IDEA（インテリジェイ・アイディア）は、Kotlinの開発でよく使われるソフトです。

もし「build.gradle.kts」を直接編集するのが不安なときは、IntelliJのプロジェクト構造からライブラリを追加することもできます。

手動でGradleを再読み込みすることで、設定が反映され、コルーチンが使えるようになります。

6. コルーチンの基本セットアップができているか確認する方法

コルーチンが正しく設定できているかどうかは、簡単なサンプルコードを実行してみることで確認できます。


import kotlinx.coroutines.*

fun main() = runBlocking {
    println("開始")
    delay(1000)
    println("1秒後に表示されました")
}

このコードがエラーなく動けば、コルーチンの準備は完了です。

7. コルーチンセットアップ時のよくあるエラーと対処法

「Unresolved reference: kotlinx」
→ コルーチンのライブラリが追加されていない、またはGradleが同期されていない可能性があります。
「Unresolved reference: runBlocking」
→ コルーチンのバージョンが古い、または依存関係が間違っている可能性があります。
「Could not resolve...」
→ ネット接続が切れている、またはリポジトリの指定が漏れているかもしれません。

こうした場合は、もう一度Gradleファイルを確認し、mavenCentral()が書かれているかチェックしましょう。