Kotlin Academy · Pelajaran

expect dan actual

Implementasi khusus platform

expect dan actual adalah pelajaran Kotlin Academy gratis di CoddyKit. Ini adalah pelajaran 2 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Kotlin Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Kotlin Academy mencakup 4 pelajaran total.

Kebutuhan akan Kode Platform

Beberapa fungsi tidak memiliki implementasi umum—misalnya mendapatkan nama OS, UUID, atau platform saat ini. KMM mengatasi hal ini dengan mekanisme expect/actual.

Deklarasi expect

Di commonMain, Anda mendeklarasikan fungsi atau kelas expect—sebuah kontrak tanpa isi. Kode umum dapat memanggilnya.

// commonMain
expect fun platformName(): String

actual di Android

Setiap platform menyediakan implementasi actual yang sesuai dengan tanda tangannya.

// androidMain
actual fun platformName(): String = "Android " + android.os.Build.VERSION.SDK_INT

actual di iOS

Kumpulan sumber iOS menyediakan versinya sendiri dengan menggunakan API native.

// iosMain
import platform.UIKit.UIDevice

actual fun platformName(): String =
    UIDevice.currentDevice.systemName + " " + UIDevice.currentDevice.systemVersion

Menggunakannya dalam Kode Umum

Kode umum memanggil fungsi yang diharapkan seolah-olah fungsi tersebut ada; kompiler menautkan actual yang tepat untuk setiap target.

// commonMain
class Platform {
    val name: String get() = platformName()
}

Kelas expect

Anda dapat mengharapkan seluruh kelas. Setiap platform menyediakan kelas actual dengan anggota yang sesuai.

// commonMain
expect class FileReader(path: String) {
    fun read(): String
}

Implementasi Kelas actual

Platform mengimplementasikan kelas yang diharapkan menggunakan API berkas native (misalnya Java IO di Android dan Foundation di iOS).

// androidMain
actual class FileReader actual constructor(private val path: String) {
    actual fun read(): String = java.io.File(path).readText()
}

expect dengan typealias

Actual dapat berupa typealias ke tipe platform yang sudah ada sehingga tidak memerlukan pembungkus.

// commonMain
expect class Uuid

// jvm/androidMain
actual typealias Uuid = java.util.UUID

Aturan Pencocokan Deklarasi

Actual harus sama persis dengan expect: nama, parameter, dan tipe kembalian harus sama. Ketidaksesuaian menjadi galat kompilasi sehingga konsistensi antarplatform terjamin.

Kapan Tidak Menggunakan expect/actual

Lebih baik gunakan antarmuka dengan implementasi platform yang disuntikkan saat waktu proses jika abstraksinya lebih fleksibel. Gunakan expect/actual hanya untuk primitif platform yang kecil dan tetap.

Ilustrasi Kode Umum

Di luar KMM, gagasan yang sama hanyalah memanggil sebuah abstraksi. Di sini, fungsi biasa berperan sebagai pengganti pemanggilan platform.

fun platformName(): String = "Demo Platform"

fun main() {
    println("Running on " + platformName())
}

Pemeriksaan Singkat

Di mana deklarasi expect ditulis, dan di mana implementasi actual-nya berada?

Ringkasan

expect/actual menjembatani perbedaan antarplatform:

expect mendeklarasikan kontrak di commonMain
actual mengimplementasikannya untuk setiap platform (atau melalui typealias)
Deklarasi harus sama persis
Lebih baik gunakan antarmuka untuk abstraksi yang fleksibel

Berikutnya: berbagi logika bisnis.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “expect dan actual” gratis?

Ya — teks lengkap “expect dan actual” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Kotlin Academy, upgrade ke CoddyKit PRO. Kursus Kotlin Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “expect dan actual”?

Implementasi khusus platform Kamu berlatih Kotlin Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Kotlin Academy?

Tidak diperlukan pengalaman sebelumnya. Kotlin Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 4.

Berapa lama pelajaran “expect dan actual” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Kotlin Academy ini?

Ya. Setiap pelajaran Kotlin Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Kotlin Academy