Mengapa expect/actual Ada

Sebagian besar Kotlin Anda berjalan di mana saja, tetapi beberapa tugas memerlukan alat khusus dari setiap platform. Kesenjangan inilah yang dirancang untuk diatasi oleh expect/actual.

Mendapatkan versi OS, jalur file, atau waktu saat ini bergantung pada API Android atau iOS yang memang tidak tersedia dalam kode bersama. Namun, Anda tetap ingin memanggilnya dari commonMain. 🤔

Anggap expect sebagai sebuah janji: kode umum menyatakan bahwa suatu API tersedia. Kemudian setiap platform memenuhi janji tersebut dengan implementasi nyata.

Di commonMain, Anda menulis deklarasi tanpa isi. Kata kunci expect berarti implementasinya berada di tempat lain, sesuai platform.

Setiap target menyediakan isi dengan actual. Android mengembalikan satu nilai, iOS mengembalikan nilai lain, tetapi tanda tangannya harus sama persis.

Logika bersama Anda cukup memanggil fungsi tersebut dan tidak pernah melihat perbedaannya. Compiler memilih actual yang tepat untuk setiap build.

Interface memerlukan objek untuk mengimplementasikannya saat runtime. expect/actual diselesaikan saat kompilasi, sehingga tidak ada biaya runtime.

expect ditempatkan di commonMain. Setiap actual berada di set sumber yang sesuai, seperti androidMain atau iosMain, berdampingan.

Jika Anda menargetkan Android dan iOS, keduanya memerlukan actual. Actual yang hilang akan menjadi compile error, bukan kerusakan tak terduga di kemudian hari.

Gunakan expect/actual hanya untuk lapisan tipis yang benar-benar berbeda. Semakin banyak kode yang tetap berada di common, semakin banyak pula kode yang dapat Anda bagikan. ✨

expect/actual adalah jembatan yang rapi menuju kemampuan native tanpa memecah proyek Anda. Anda mempertahankan satu API, sementara setiap platform menggunakan bahasanya sendiri.

Anda telah mempelajari alasan expect/actual dibuat: fitur ini memungkinkan kode umum memanggil perilaku khusus platform melalui satu API, yang diselesaikan saat kompilasi tanpa biaya runtime. 🎉