Thiết lập môi trường (Kotlin Multiplatform)

Kotlin Multiplatform (KMP) cho phép chia sẻ đoạn mã Kotlin trên nhiều nền tảng. Trước khi bắt đầu tạo ứng dụng bằng KMP, bạn cần thiết lập môi trường như mô tả trong tài liệu này. Bạn cũng có thể tham khảo tài liệu chính thức của JetBrain.

Cài đặt hoặc cập nhật các công cụ bắt buộc

  • Cài đặt hoặc cập nhật lên phiên bản ổn định mới nhất của Android Studio.
  • Cập nhật trình bổ trợ Kotlin đi kèm với Android Studio lên phiên bản mới nhất để tránh các vấn đề về khả năng tương thích.
  • (Không bắt buộc) Để phát triển iOS, hãy cài đặt Xcode để tạo giao diện người dùng và thêm mã Swift hoặc Objective-C nếu cần.

Tạo dự án Kotlin Multiplatform

Bạn có thể sử dụng trình hướng dẫn Kotlin Multiplatform của JetBrains để tạo một dự án KMP mới. Hãy nhớ chọn tuỳ chọn Do not share UI (Không chia sẻ giao diện người dùng) để giữ giao diện người dùng gốc.

Cấu trúc dự án

Các dự án KMP tuân theo cấu trúc dự án tương tự như các dự án Android.

Dự án KMP chứa các mô-đun dành riêng cho nền tảng cùng với một mô-đun dùng chung. Thêm mã dành riêng cho nền tảng vào mô-đun có liên quan. Ví dụ: thêm giao diện người dùng ứng dụng Android trong mô-đun androidApp và giao diện người dùng ứng dụng iOS trong iosApp. Mọi mã bạn muốn chia sẻ giữa các nền tảng đều nằm trong mô-đun shared (chia sẻ).

Mô-đun dùng chung sử dụng Gradle làm hệ thống xây dựng giống như phần còn lại của dự án. Bạn có thể khai báo các phần phụ thuộc chung và dành riêng cho nền tảng bằng cách sử dụng nhóm tài nguyên. Ví dụ: nếu ứng dụng của bạn sử dụng Ktor để kết nối mạng, bạn cần thêm phần phụ thuộc OkHttp cho Android và phần phụ thuộc darwin cho iOS. Xin lưu ý rằng một số thư viện chỉ yêu cầu các phần phụ thuộc phổ biến và không cần các phần phụ thuộc dành riêng cho nền tảng.

sourceSets {
   commonMain.dependencies {
       //put your multiplatform dependencies here
       //...
       implementation(libs.ktor.client.core)
       implementation(libs.ktor.client.content.negotiation)
       implementation(libs.ktor.serialization.kotlinx.json)
       //...
   }
   androidMain.dependencies {
       implementation(libs.ktor.client.okhttp)
   }
   iosMain.dependencies {
       implementation(libs.ktor.client.darwin)
   }
}

Khi thêm một thư viện mới vào mô-đun dùng chung của ứng dụng, hãy nhớ kiểm tra các phần phụ thuộc bắt buộc cho từng nền tảng.