Thêm Kotlin Multiplatform vào một dự án hiện có

Để tạo mô-đun Kotlin Multiplatform (KMP) trong dự án Android, hãy sử dụng mẫu Kotlin Multiplatform Shared Module (Mô-đun dùng chung Kotlin Multiplatform) có trong Android Studio Meerkat và Trình bổ trợ Android cho Gradle 8.8.0 trở lên.

Mẫu mô-đun tự động tạo một mô-đun mới với cấu hình tối thiểu nhắm đến nền tảng Android và iOS. KMP cũng hỗ trợ các mục tiêu khác, chẳng hạn như máy tính và web, mà bạn có thể thêm vào mô-đun sau này. Để xem danh sách đầy đủ, hãy xem phần Tính ổn định của các nền tảng được hỗ trợ. Để khai báo một mục tiêu, hãy xem phần Mục tiêu trong tài liệu tham khảo về DSL của Gradle đa nền tảng.

Thiết lập mô-đun KMP dùng chung

Để tạo một mô-đun KMP dùng chung, hãy làm theo các bước sau:

  1. Chọn File > New > New Module (Tệp > Mới > Mô-đun mới)
  2. Chọn mẫu Kotlin Multiplatform Shared Module (Mô-đun dùng chung Kotlin Multiplatform) trong bảng điều khiển Templates (Mẫu):
Tạo mô-đun KMP mới
Hình 1. Tạo mô-đun KMP mới

Trong mẫu có các trường như sau:

  • Tên mô-đun – xác định tên mô-đun Gradle, cũng như tên khung iOS (có thể thay đổi sau)
  • Package name (Tên gói) – xác định tên gói cho các tệp trong mô-đun này
    1. Nhấp vào Finish (Hoàn tất) và cho phép Gradle đồng bộ hoá với dự án. Bạn cũng có thể được nhắc thêm các tệp mô-đun mới tạo vào chế độ kiểm soát nguồn.

Sau khi hoàn tất, Chế độ xem dự án của Android Studio sẽ hiển thị mô-đun dùng chung mới cùng với một nhóm tài nguyên cho từng nền tảng.

Chế độ xem dự án cho thấy các mô-đun dùng chung mới
Hình 2. Chế độ xem dự án cho thấy các mô-đun dùng chung mới

Trình hướng dẫn mô-đun không thêm mô-đun mới tạo làm phần phụ thuộc vào bất kỳ mô-đun hiện có nào. Bước tiếp theo, bạn cần liên kết mô-đun dùng chung với một trong các mô-đun Gradle hiện có, tương tự như các phần phụ thuộc Android khác:

dependencies {
    ...
    implementation(project(":shared"))
}

Sau khi bật, bạn có thể truy cập vào mã truy cập như bình thường. Trong ứng dụng Android, bạn có thể truy cập vào mã có trong androidMain hoặc commonMain.

Để biết thêm thông tin về cấu trúc dự án Kotlin Multiplatform, hãy xem kiến thức cơ bản về cấu trúc dự án Kotlin Multiplatform

Thiết lập mô-đun dùng chung cho ứng dụng iOS

Swift không thể sử dụng trực tiếp mô-đun Kotlin và yêu cầu tạo một khung nhị phân đã biên dịch.

Mẫu mô-đun mới trong Android Studio định cấu hình mô-đun dùng chung để tạo khung cho từng cấu trúc iOS. Bạn có thể tìm thấy mã sau đây trong tệp build.gradle.kts của mô-đun dùng chung:

val xcfName = "sharedKit"

iosX64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosSimulatorArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

Xem phần Cấu trúc dự án phân cấp để biết thông tin về cách xác định các loại cấu trúc khác.

Để cho phép truy cập vào mã dùng chung từ dự án iOS, hãy thêm một giai đoạn tập lệnh để tạo khung Kotlin trước khi biên dịch các nguồn Swift:

  1. Nhấp chuột phải vào tệp đó trong Android Studio rồi chọn Open In (Mở trong) và Open in Associated Application (Mở trong ứng dụng liên kết). Thao tác này sẽ mở ứng dụng iOS trong Xcode.
Mở trong ứng dụng liên kết
Hình 3. Mở trong ứng dụng liên kết
  1. Mở phần cài đặt dự án bằng cách nhấp đúp vào tên dự án trong trình điều hướng dự án
Hộp thoại cài đặt dự án Xcode
Hình 4. Hộp thoại cài đặt dự án Xcode
  1. Thay đổi tên Run Script (Chạy tập lệnh) mặc định thành Compile Kotlin Framework (Biên dịch khung Kotlin) để dễ xác định chức năng của giai đoạn này. Nhấp đúp vào tiêu đề Run Script (Chạy tập lệnh) để chỉnh sửa.
  2. Mở rộng giai đoạn tạo và trong trường văn bản Shell (Màn hình shell), hãy nhập mã tập lệnh sau:
Thêm giai đoạn tạo tập lệnh chạy mới
Hình 5. Chạy giai đoạn tạo tập lệnh

  1. Kéo giai đoạn Run Script (Chạy tập lệnh) trước giai đoạn Compile Sources (Biên dịch nguồn).

    Chạy giai đoạn tạo tập lệnh trước khi biên dịch nguồn
    Hình 6. Chạy giai đoạn tạo tập lệnh trước khi biên dịch nguồn

  2. Tạo dự án trong Xcode bằng cách nhấp vào tổ hợp phím ⌘B hoặc chuyển đến trình đơn Product (Sản phẩm) rồi chọn Build (Tạo).

Khi tạo bản dựng thành công, bạn sẽ thấy biểu tượng sau.

Thông báo tạo thành công trong Xcode
Hình 7. Tạo thành công

Truy cập vào mã dùng chung trong ứng dụng iOS

Để xác minh rằng ứng dụng iOS có thể truy cập thành công vào mã từ mô-đun dùng chung, hãy làm như sau:

  1. Trong dự án iOS, hãy mở tệp ContentView.swift tại: Sources/View/ContentView.swift
  2. Thêm lệnh nhập sharedKit ở đầu tệp.
  3. Sửa đổi khung hiển thị Text (Văn bản) để đưa thông tin Platform_iosKt.platform() vào chuỗi được hiển thị như sau:

Quá trình cập nhật này kiểm tra xem ứng dụng có thể gọi hàm platform() từ mô-đun dùng chung hay không. Hàm này sẽ trả về "iOS" khi chạy trên nền tảng iOS.

Trình mô phỏng Xcode đang chạy ứng dụng iOS
Hình 8. Trình mô phỏng Xcode đang chạy ứng dụng iOS

Tài nguyên khác