크로스 플랫폼 모바일 애플리케이션 만들기
Code example: 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 클라이언트를 사용하려면 클라이언트 종속성과 엔진 종속성이라는 최소 두 개의 종속성을 추가해야 합니다.
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()
}
}HttpClient()생성자는 HTTP 클라이언트를 생성합니다.- 일시 중단 함수(suspending function)인
greet()는 요청을 보내고 응답 본문을 문자열 값으로 수신합니다.
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()는 컴포저블(composable)의 수명 주기에 바인딩된 코루틴을 시작합니다. 이 코루틴 내에서 공유 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의 실행 구성(run configuration) 목록에서 androidApp을 선택합니다.
구성 목록 옆에서 Android 가상 기기를 선택하고 Run을 클릭합니다.

목록에 기기가 없다면 새 Android 가상 기기를 만듭니다.
로드가 완료되면 시뮬레이터에 수신된 HTML 문서가 일반 텍스트로 표시됩니다.

Android 에뮬레이터가 인터넷에 연결되지 않는 경우 콜드 부팅(Cold Boot)을 시도해 보세요. Device Manager 도구 창에서 중지된 기기 옆의 ⋮ (점 세 개)를 클릭하고 메뉴에서 Cold Boot를 선택합니다. 이는 연결 문제를 일으킬 수 있는 손상된 에뮬레이터 캐시를 정리하는 데 종종 도움이 됩니다.
iOS에서 애플리케이션 실행
IntelliJ IDEA의 실행 구성 목록에서 iosApp을 선택합니다.
구성 목록 옆에서 iOS 시뮬레이터 기기를 선택하고 Run을 클릭합니다.

목록에 사용 가능한 iOS 구성이 없다면 새 실행 구성을 추가합니다.
로드가 완료되면 시뮬레이터에 수신된 HTML 문서가 일반 텍스트로 표시됩니다.

