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()が書かれているかチェックしましょう。

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

8. なぜ依存関係を追加するのか？

最初は少し面倒に思えるかもしれませんが、依存関係を追加することは、他人が作った高性能な部品を無料で使えるということです。

コルーチン以外にも、Kotlinには便利なツールがたくさんあり、それらを必要に応じて「呼び込む」ことができるようになるのです。

これは、車の部品を取り寄せて組み立てるようなイメージです。必要な部品だけを使うことで、アプリ全体を軽く、安全に保つことができます。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。