Menambahkan Multiplatform Kotlin ke project yang ada

Untuk membuat modul Kotlin Multiplatform (KMP) dalam project Android, gunakan template Kotlin Multiplatform Shared Module, yang tersedia di Android Studio Meerkat dan Plugin Android Gradle 8.8.0 dan yang lebih tinggi.

Template modul mengotomatiskan pembuatan modul baru dengan konfigurasi minimum yang menargetkan platform Android dan iOS. KMP juga mendukung target lain, seperti desktop dan web, yang dapat Anda tambahkan ke modul nanti. Untuk daftar lengkapnya, lihat Stabilitas platform yang didukung. Untuk mendeklarasikan target, lihat Target dalam referensi DSL Gradle Multiplatform.

Menyiapkan modul KMP bersama

Untuk membuat modul KMP bersama, ikuti langkah-langkah berikut:

  1. Pilih File > New > New Module
  2. Pilih template Kotlin Multiplatform Shared Module di panel Templates:
Membuat Modul KMP baru
Gambar 1. Membuat Modul KMP baru

Kolom dalam template adalah sebagai berikut:

  • Module name – menentukan nama modul Gradle, serta nama framework iOS (dapat diubah nanti)
  • Package name – menentukan nama paket untuk file dalam modul ini
    1. Klik Finish dan izinkan Gradle menyinkronkan dengan project. Anda mungkin juga diminta untuk menambahkan file modul yang baru dibuat ke kontrol sumber.

Setelah selesai, Project View Android Studio akan menampilkan modul bersama yang baru bersama dengan set sumber untuk setiap platform.

Tampilan project yang menampilkan modul bersama baru
Gambar 2. Tampilan project yang menampilkan modul bersama baru

Wizard modul tidak menambahkan modul yang baru dibuat sebagai dependensi ke modul yang ada. Sebagai langkah berikutnya, Anda harus menautkan modul bersama ke salah satu modul Gradle yang ada, mirip dengan dependensi Android lainnya:

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

Setelah diaktifkan, Anda dapat mengakses kode seperti biasa. Dari aplikasi Android, Anda dapat mengakses kode yang tersedia di androidMain atau di commonMain.

Untuk informasi selengkapnya tentang struktur project Multiplatform Kotlin, lihat dasar-dasar struktur project Multiplatform Kotlin

Menyiapkan modul bersama ke aplikasi iOS

Swift tidak dapat menggunakan modul Kotlin secara langsung dan memerlukan framework biner yang dikompilasi untuk dihasilkan.

Template modul baru di Android Studio mengonfigurasi modul bersama untuk menghasilkan framework untuk setiap arsitektur iOS. Anda dapat menemukan kode berikut di file build.gradle.kts modul bersama:

val xcfName = "sharedKit"

iosX64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosSimulatorArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

Lihat Struktur project hierarkis untuk mengetahui informasi tentang cara menentukan jenis arsitektur lainnya.

Untuk mengaktifkan akses ke kode bersama dari project iOS, tambahkan fase skrip untuk membuat framework Kotlin sebelum mengompilasi sumber Swift:

  1. Klik kanan file di Android Studio, lalu pilih Open In dan Open in Associated Application. Tindakan ini akan membuka aplikasi iOS di Xcode.
Buka di Aplikasi Terkait
Gambar 3. Buka di Aplikasi Terkait
  1. Buka setelan project dengan mengklik dua kali nama project di navigator project
Dialog setelan project Xcode
Gambar 4. Dialog setelan project Xcode
  1. Ubah nama Run Script default menjadi Compile Kotlin Framework untuk mengidentifikasi fungsi fase ini dengan lebih baik. Klik dua kali judul Run Script untuk mengeditnya.
  2. Luaskan fase build, dan di kolom teks Shell, masukkan kode skrip berikut:
Menambahkan fase build run script baru
Gambar 5. Jalankan fase build skrip

  1. Tarik fase Run Script sebelum fase Compile Sources.

    Menjalankan fase build skrip sebelum mengompilasi sumber
    Gambar 6. Menjalankan fase build skrip sebelum mengompilasi sumber

  2. Bangun project di Xcode dengan mengklik ⌘B atau membuka menu Product, lalu pilih Build.

Jika build berhasil, Anda akan melihat ikon berikut.

Build berhasil ditampilkan di Xcode
Gambar 7. Build berhasil

Mengakses kode bersama di aplikasi iOS

Untuk memverifikasi bahwa aplikasi iOS berhasil mengakses kode dari modul bersama, lakukan hal berikut:

  1. Di project iOS, buka file ContentView.swift di: Sources/View/ContentView.swift
  2. Tambahkan impor sharedKit di bagian atas file.
  3. Ubah tampilan Teks untuk menyertakan informasi Platform_iosKt.platform() dalam string yang ditampilkan sebagai berikut:

Update ini memeriksa apakah aplikasi dapat memanggil fungsi platform() dari modul bersama, yang akan menampilkan "iOS" saat berjalan di platform iOS.

Simulator Xcode yang menjalankan aplikasi iOS
Gambar 8. Simulator Xcode yang menjalankan aplikasi iOS

Referensi Tambahan