Bẫy trùng lặp công việc trong kỹ thuật phần mềm di động
Hai nền tảng, hai codebase, nhưng chỉ có một bộ tính năng giống hệt nhau. Đội ngũ Android viết một tầng repository bằng Retrofit và Moshi. Chỉ cách đó hai dãy bàn, đội ngũ iOS lại viết chính xác logic đó với URLSession và Swift Decodable. Khi phía sản phẩm thay đổi dù chỉ một quy tắc kiểm tra tính hợp lệ lúc thanh toán (checkout validation), cả hai nhóm đều phải vội vã cập nhật code. Khi các lỗi parsing ở biên (edge-case) phát sinh trên môi trường production, bạn phải kiểm tra và sửa lỗi đến hai lần.
Trong một dự án fintech trước đây với tám kỹ sư mobile, việc đồng bộ giữa hai nền tảng đã ngốn tới 35% thời lượng của mỗi sprint hai tuần. Chúng tôi mất hàng chục giờ mỗi tuần chỉ để so sánh pull request và căn chỉnh data model giữa các nền tảng. Việc áp dụng Kotlin Multiplatform (KMP) đã xóa bỏ hoàn toàn gánh nặng đó. Chỉ trong vòng hai quý, chúng tôi đã cắt giảm khoảng 8.000 dòng code networking bị trùng lặp và giảm một nửa số lượng lỗi hồi quy (regression bugs) giữa hai nền tảng.
KMP không bắt bạn phải viết lại mọi thứ từ đầu. Bạn vẫn giữ nguyên vẹn code UI native—SwiftUI trên iOS và Jetpack Compose trên Android. Trong khi đó, module dùng chung (shared module) âm thầm vận hành phòng máy phía sau: các cuộc gọi mạng, business logic, lưu trữ dữ liệu và kiểm tra trạng thái.
Bản chất thực sự của Kotlin Multiplatform (và những gì không phải KMP)
KMP không giống như Flutter hay React Native. Nó không thay thế pipeline render của bạn, không bọc các control native, cũng không áp đặt một hệ thống thiết kế chung chung. Thay vào đó, Kotlin biên dịch trực tiếp thành JVM bytecode cho Android và thành các Apple framework native thông qua Kotlin/Native (tương thích Objective-C/Swift) cho iOS.
Bạn chỉ nên tập trung phần code dùng chung vào những nơi mang lại hiệu quả cao nhất:
- HTTP request, interceptor và tuần tự hóa JSON (serialization)
- Các quy tắc domain, kiểm tra dữ liệu đầu vào và định dạng dữ liệu
- Shared data model và DTO
- Bộ nhớ cache cơ sở dữ liệu cục bộ và migration
Hãy phân định ranh giới rõ ràng tại tầng view. Những đội ngũ mobile cố gắng chia sẻ cả tầng trừu tượng trạng thái view (view state) thường lập tức gặp phải những cơn đau đầu về vòng đời (lifecycle) của từng nền tảng. Hãy bắt đầu tinh gọn với networking và model trước. Bạn luôn có thể mở rộng phạm vi sau này.
Kiến trúc Shared Module
Một repository KMP trong môi trường production thường được chia thành ba thư mục riêng biệt:
shared/— module Gradle multiplatform chứa logic chung và các liên kết nền tảngandroidApp/— module ứng dụng Android tiêu chuẩn, sử dụng code dùng chung trực tiếp như một dependency của GradleiosApp/— dự án Xcode native liên kết với.xcframeworkđã biên dịch hoặc artifact qua CocoaPods/SPM
Bên trong shared/, Kotlin tổ chức các mục tiêu biên dịch thông qua các source set:
commonMain— code multiplatform được chia sẻ trên tất cả các mục tiêu biên dịchandroidMain— các triển khai đặc thù của nền tảng được biên dịch với Android SDKiosMain— các triển khai iOS được biên dịch với Apple platform API thông qua Kotlin/Native
Khi code cần đến các API riêng của nền tảng như keychain hay logging, hãy khai báo một chữ ký expect trong commonMain. Sau đó, viết các triển khai actual tương ứng trong androidMain và iosMain. Hãy hình dung nó như một hợp đồng interface tại thời điểm biên dịch (compile-time) được thực thi nghiêm ngặt trên mọi nền tảng đích.
Thiết lập Shared Module
Mặc dù công cụ trực tuyến của JetBrains (kmp.jetbrains.com) mang lại điểm khởi đầu nhanh chóng, việc tự tay cấu hình các file Gradle sẽ giúp bạn hiểu rõ cách các target multiplatform và gói XCFramework thực sự liên kết với nhau như thế nào.
build.gradle.kts ở cấp dự án
plugins {
kotlin("multiplatform") version "2.0.0" apply false
kotlin("plugin.serialization") version "2.0.0" apply false
id("com.android.library") version "8.4.0" apply false
}
build.gradle.kts của Shared Module
Để tạo ra một iOS framework mà Xcode có thể tích hợp trực tiếp mà không cần thêm công cụ ngoài, hãy cấu hình tác vụ đóng gói XCFramework một cách rõ ràng:
import org.jetbrains.kotlin.gradle.plugin.mpp.apple.XCFrameworkConfig
plugins {
kotlin("multiplatform")
kotlin("plugin.serialization")
id("com.android.library")
}
kotlin {
androidTarget()
// Đóng gói các kiến trúc iOS vào một XCFramework duy nhất
val xcf = XCFramework("SharedKit")
listOf(
iosX64(),
iosArm64(),
iosSimulatorArm64()
).forEach { target ->
target.binaries.framework {
baseName = "SharedKit"
xcf.add(this)
}
}
sourceSets {
commonMain.dependencies {
implementation("io.ktor:ktor-client-core:2.3.12")
implementation("io.ktor:ktor-client-content-negotiation:2.3.12")
implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.12")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.9.0")
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}
androidMain.dependencies {
implementation("io.ktor:ktor-client-okhttp:2.3.12")
}
iosMain.dependencies {
implementation("io.ktor:ktor-client-darwin:2.3.12")
}
}
}
android {
namespace = "com.example.shared"
compileSdk = 34
defaultConfig {
minSdk = 24
}
}
Hãy chú ý đến thiết kế tách biệt engine. Code chung hướng tới ktor-client-core. Trong khi đó, các source set của từng nền tảng sẽ inject các engine chuyên biệt: OkHttp cho connection pooling trên Android và engine Darwin chạy trên nền tảng NSURLSession native của Apple cho iOS.
Viết Networking Service dùng chung
Dưới đây là một triển khai gọn gàng của client dùng chung để xử lý HTTP request và giải tuần tự hóa JSON:
// shared/src/commonMain/kotlin/com/example/shared/api/PostsApi.kt
package com.example.shared.api
import io.ktor.client.HttpClient
import io.ktor.client.call.body
import io.ktor.client.plugins.contentnegotiation.ContentNegotiation
import io.ktor.client.request.get
import io.ktor.serialization.kotlinx.json.json
import kotlinx.serialization.Serializable
import kotlinx.serialization.json.Json
@Serializable
data class Post(
val id: Int,
val title: String,
val body: String
)
class PostsApi {
private val client = HttpClient {
install(ContentNegotiation) {
json(Json {
ignoreUnknownKeys = true
isLenient = true
})
}
}
@Throws(Exception::class)
suspend fun getPosts(): List<Post> {
return client.get("https://jsonplaceholder.typicode.com/posts").body()
}
@Throws(Exception::class)
suspend fun getPost(id: Int): Post {
return client.get("https://jsonplaceholder.typicode.com/posts/$id").body()
}
}
Annotation @Throws(Exception::class) có ý nghĩa đặc biệt quan trọng đối với các nền tảng Apple. Nếu không có nó, các exception chưa bắt được bên trong các suspend function của Kotlin sẽ âm thầm thất bại hoặc làm crash Objective-C runtime thay vì truyền tải giá trị NSError chuẩn xác sang các khối try/catch của Swift.
Xử lý khác biệt nền tảng với expect/actual
Khi cần logging native hoặc lưu trữ dữ liệu thiết bị, hãy định nghĩa hợp đồng nền tảng của bạn trong commonMain:
// shared/src/commonMain/kotlin/com/example/shared/platform/Logger.kt
package com.example.shared.platform
expect class Logger() {
fun log(tag: String, message: String)
}
// shared/src/androidMain/kotlin/com/example/shared/platform/Logger.kt
package com.example.shared.platform
actual class Logger actual constructor() {
actual fun log(tag: String, message: String) {
android.util.Log.d(tag, message)
}
}
// shared/src/iosMain/kotlin/com/example/shared/platform/Logger.kt
package com.example.shared.platform
import platform.Foundation.NSLog
actual class Logger actual constructor() {
actual fun log(tag: String, message: String) {
NSLog("[%@] %@", tag, message)
}
}
Tích hợp code dùng chung vào Android
Việc sử dụng bên Android rất đơn giản. Chỉ cần thêm tham chiếu đến shared project bên trong androidApp/build.gradle.kts:
dependencies {
implementation(project(":shared"))
}
Gọi API trực tiếp từ ViewModel hoặc Activity trên Android:
// androidApp/src/main/kotlin/com/example/app/MainActivity.kt
class MainActivity : AppCompatActivity() {
private val api = PostsApi()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
lifecycleScope.launch {
try {
val posts = api.getPosts()
// Đưa dữ liệu posts vào Jetpack Compose hoặc XML layout
} catch (e: Exception) {
Log.e("MainActivity", "Lỗi mạng", e)
}
}
}
}
Tích hợp code dùng chung vào iOS
Biên dịch debug XCFramework bằng cách chạy tác vụ Gradle này từ thư mục gốc của dự án:
./gradlew :shared:assembleSharedKitDebugXCFramework
Gradle sẽ xuất framework ra đường dẫn shared/build/XCFrameworks/debug/SharedKit.xcframework. Kéo thư mục này vào mục Frameworks, Libraries, and Embedded Content trong dự án Xcode của bạn. Sau đó import trực tiếp vào SwiftUI view:
// iosApp/ContentView.swift
import SwiftUI
import SharedKit
struct ContentView: View {
@State private var posts: [Post] = []
@State private var errorMessage: String? = nil
private let api = PostsApi()
var body: some View {
NavigationStack {
List(posts, id: \.id) { post in
VStack(alignment: .leading) {
Text(post.title).font(.headline)
Text(post.body).font(.subheadline).foregroundColor(.secondary)
}
}
.navigationTitle("Bảng tin chung")
.overlay {
if let error = errorMessage {
Text(error).foregroundColor(.red)
}
}
.task {
do {
posts = try await api.getPosts()
} catch {
errorMessage = "Không thể tải bài viết: \(error.localizedDescription)"
}
}
}
}
}
Các suspend function trong Kotlin biên dịch rất mượt mà thành cú pháp async/await của Swift. Bạn có được code Swift chuẩn mực ở tầng UI, trong khi logic networking dùng chung vẫn chạy mượt mà bên dưới.
Ba cạm bẫy trong môi trường production cần phòng tránh sớm
1. Quy tắc quản lý bộ nhớ và đa luồng của Kotlin/Native
Các phiên bản Kotlin/Native ban đầu áp dụng quy tắc đóng băng (freezing) rất khắt khe: bất kỳ đối tượng nào được chuyển qua các background thread đều trở thành bất biến vĩnh viễn. Mô hình bộ nhớ cũ kỹ đó đã được thay thế hoàn toàn trong Kotlin 1.7.20 và trở thành mặc định từ bản 1.9.0 trở đi. Hãy đảm bảo build của bạn sử dụng coroutine hiện đại (kotlinx-coroutines-core:1.8.0+). Nếu bạn bắt gặp các bài viết cũ khuyên dùng @ThreadLocal hoặc gọi freeze(), hãy bỏ qua chúng. Trình dọn rác (garbage collector) hiện đại hoạt động tương tự như bộ nhớ JVM tiêu chuẩn.
2. Chênh lệch chi phí CI Runner
Biên dịch một XCFramework trên CI bắt buộc phải sử dụng phần cứng macOS. Trong khi Linux runner trên GitHub Actions chỉ tốn khoảng 0,008 USD mỗi phút, thì macOS runner lại tốn từ 0,08 đến 0,12 USD mỗi phút—đắt gấp khoảng mười lần. Đừng chạy toàn bộ quá trình build iOS framework trên mọi pull request tính năng. Hãy cấu hình pipeline để chạy unit test của Android và commonTest trên các instance Linux giá rẻ. Chỉ kích hoạt build macOS XCFramework cho những pull request có chỉnh sửa trong thư mục shared/ hoặc khi merge vào branch tích hợp chính.
3. Kích thước file nhị phân (Binary Size)
Việc đính kèm runtime và thư viện chuẩn của Kotlin/Native sẽ làm tăng một phần dung lượng cố định ban đầu cho ứng dụng iOS của bạn. Đối với một module networking KMP cơ bản, kích thước file binary release chưa nén sẽ tăng thêm khoảng 1,5 MB đến 2,5 MB. Tuy nhiên trong thực tế, chi phí dung lượng này sẽ sớm đi vào trạng thái bão hòa. Khi business logic dùng chung của bạn mở rộng từ 1.000 lên 20.000 dòng code, kích thước binary hầu như không tăng thêm đáng kể vì chi phí runtime ban đầu đã được chi trả từ trước.
Các bước tiếp theo cần triển khai
Sau khi đã kiểm thử xong tầng networking, cột mốc kiến trúc tiếp theo của bạn là thống nhất tầng lưu trữ dữ liệu cục bộ (local persistence). SQLDelight hoặc Room for KMP (được giới thiệu trong Android Jetpack) cho phép bạn viết schema SQL một lần duy nhất và tự động sinh ra các câu truy vấn type-safe cho cả SQLite trên Android lẫn SQLite không phụ thuộc CoreData trên iOS.
Đối với kiến trúc quản lý trạng thái đa nền tảng, hãy cân nhắc Decompose hoặc Koin. Chúng cho phép bạn chia sẻ các máy trạng thái (state machine) và đồ thị dependency injection trong khi vẫn giữ lại 100% giao diện native.
Việc áp dụng KMP ở quy mô lớn trong môi trường production không còn là thử nghiệm nữa. Các tên tuổi lớn như Cash App, 9GAG, McDonald’s và Netflix đều đang vận hành KMP trong các ứng dụng phục vụ hàng trăm triệu người dùng mỗi ngày. Hãy chọn một tính năng ít rủi ro—chẳng hạn như endpoint cấu hình hoặc API điều khoản dịch vụ—và chuyển đổi nó sang shared module. Một khi đội ngũ của bạn trải nghiệm cảm giác chỉ cần sửa lỗi API một lần duy nhất thay vì hai lần, sẽ không còn ai muốn quay lại cách làm cũ nữa.
