クロスプラットフォームモバイルアプリケーションの作成
コード例: tutorial-client-kmp
Ktor HTTP クライアントは、マルチプラットフォームプロジェクトで使用できます。このチュートリアルでは、リクエストを送信してレスポンスボディをプレーン HTML テキストとして受け取る、シンプルな Kotlin Multiplatform Mobile アプリケーションを作成します。
前提条件
まず、適切なオペレーティングシステムに必要なツールをインストールして、クロスプラットフォームモバイル開発のための環境をセットアップする必要があります。詳細については、環境のセットアップセクションを参照してください。
このチュートリアルの特定のステップ(iOS 固有のコードの記述や iOS アプリケーションの実行など)を完了するには、macOS を搭載した Mac が必要です。
新規プロジェクトの作成
新規プロジェクトを作成するには、IntelliJ IDEA の Kotlin Multiplatform プロジェクトウィザードを使用できます。これにより、クライアントやサービスを追加して拡張できる基本的なマルチプラットフォームプロジェクトが作成されます。
- IntelliJ IDEA を起動します。
- IntelliJ IDEA で、File | New | Project を選択します。
- 左側のパネルで、Kotlin Multiplatform を選択します。
- New Project ウィンドウで以下のフィールドを指定します:
- Name: KmpKtor
- Group: org.example.ktor

- ビルドシステムとして Gradle を選択します。
- ターゲットとして Android と iOS を選択します。
- iOS については、UI をネイティブのまま保持するために Do not share UI オプションを選択します。
- Create ボタンをクリックし、IDE がプロジェクトを生成してインポートするのを待ちます。
ビルドスクリプトの設定
Ktor 依存関係の追加
プロジェクトで Ktor HTTP クライアントを使用するには、少なくとも 2 つの依存関係(クライアントの依存関係とエンジンの依存関係)を追加する必要があります。
settings.gradle.kts ファイルを開き、Ktor バージョンカタログをインポートします:
kotlindependencyResolutionManagement { versionCatalogs { create("ktorLibs").from("io.ktor:ktor-version-catalog:3.6.1") } }sharedLogic/build.gradle.kts ファイルを開き、
commonMainソースセットにデフォルトエンジンの依存関係を追加します:kotlinsourceSets { commonMain.dependencies { api(ktorLibs.client.engineDefaults) } }各ターゲットプラットフォームにおいて、Ktor は
ktor-client-engine-defaultsによって提供されるデフォルトエンジンを使用します。
コルーチンの追加
Android コードでコルーチンを使用するには、プロジェクトに kotlinx.coroutines を追加する必要があります:
gradle/libs.versions.toml ファイルを開き、コルーチンのバージョンとライブラリを指定します:
toml[versions] kotlinx-coroutines = "1.11.0" [libraries] kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "kotlinx-coroutines" } kotlinx-coroutines-android = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-android", version.ref = "kotlinx-coroutines" }sharedLogic/build.gradle.kts ファイルを開き、
commonMainソースセットにkotlinx-coroutines-coreの依存関係を追加します:kotlinsourceSets { commonMain.dependencies { api(ktorLibs.client.engineDefaults) implementation(libs.kotlinx.coroutines.core) } }次に、androidApp/build.gradle.kts ファイルを開き、
androidMainソースセットにkotlinx-coroutines-androidの依存関係を追加します:kotlindependencies { implementation(libs.kotlinx.coroutines.android) }Build | Sync Project with Gradle Files を選択して、追加した依存関係をインストールします。
アプリケーションの更新
共有コード
Android と iOS で共有されるコードを更新するには、sharedLogic/src/commonMain/kotlin/org/example/ktor/Greeting.kt ファイルを開き、Greeting クラスに以下のコードを追加します:
package org.example.ktor
import io.ktor.client.HttpClient
import io.ktor.client.request.get
import io.ktor.client.statement.bodyAsText
class Greeting {
private val client = HttpClient()
suspend fun greet(): String {
val response = client.get("https://ktor.io/docs/")
return response.bodyAsText()
}
}Android コード
sharedUI/src/commonMain/kotlin/org/example/ktor/App.kt ファイルを開き、コードを以下のように更新します:
package org.example.ktor
import androidx.compose.foundation.background
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.safeContentPadding
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.*
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.tooling.preview.Preview
@Composable
@Preview
fun App() {
MaterialTheme {
Column(
modifier = Modifier
.background(MaterialTheme.colorScheme.primaryContainer)
.safeContentPadding()
.fillMaxSize(),
horizontalAlignment = Alignment.CenterHorizontally,
) {
var text by remember { mutableStateOf("Loading") }
LaunchedEffect(true) {
text = try {
Greeting().greet()
} catch (e: Exception) {
e.message ?: "error"
}
}
GreetingView(text)
}
}
}
@Composable
fun GreetingView(text: String) {
Text(text = text)
}
@Preview
@Composable
fun DefaultPreview() {
MaterialTheme {
GreetingView("Hello, Android!")
}
}LaunchedEffect() は、コンポーザブルのライフサイクルに紐づくコルーチンを起動します。このコルーチン内で共有の greet() 関数が呼び出され、その結果が text に代入され、発生した例外がキャッチされて処理されます。
iOS コード
iosApp/iosApp/ContentView.swift ファイルを開き、コードを以下のように更新します:
import SharedLogic
import SwiftUI
struct ContentView: View {
@StateObject private var viewModel = ViewModel()
var body: some View {
Text(viewModel.text)
}
}
extension ContentView {
@MainActor
class ViewModel: ObservableObject {
@Published var text = "Loading..."
init() {
Greeting().greet { greeting, error in
if let greeting = greeting {
self.text = greeting
} else {
self.text = error?.localizedDescription ?? "error"
}
}
}
}
}iOS では、greet() サスペンド関数はコールバックを持つ関数として利用できます。
Android でのインターネットアクセスの有効化
最後のステップは、Android アプリケーションでインターネットアクセスを有効にすることです。 androidApp/src/main/AndroidManifest.xml ファイルを開き、<uses-permission> 要素を使用して必要な権限を有効にします:
<manifest>
<uses-permission android:name="android.permission.INTERNET" />
<application>
...
</application>
</manifest>Android でアプリケーションを実行する
IntelliJ IDEA で、実行構成のリストから androidApp を選択します。
実行構成リストの隣にある Android 仮想デバイスを選択し、Run をクリックします。

リストにデバイスがない場合は、新しい Android 仮想デバイスを作成してください。
読み込みが完了すると、シミュレータに受信した HTML ドキュメントがプレーンテキストとして表示されます。

Android エミュレータがインターネットに接続できない場合は、コールドブート(Cold Boot)を実行してみてください。 Device Manager ツールウィンドウで、停止しているデバイスの横にある ⋮(3つの点)をクリックし、メニューから Cold Boot を選択します。これにより、接続問題の原因となる破損したエミュレータキャッシュをクリアできることがよくあります。
iOS でアプリケーションを実行する
IntelliJ IDEA で、実行構成のリストから iosApp を選択します。
実行構成リストの隣にある iOS シミュレータデバイスを選択し、Run をクリックします。

リストに利用可能な iOS 構成がない場合は、新しい実行構成を追加してください。
読み込みが完了すると、シミュレータに受信した HTML ドキュメントがプレーンテキストとして表示されます。

