@ObjCName & API yang Ramah Swift

API bersama Anda harus terbaca secara alami di Swift. Beberapa anotasi dan kebiasaan dapat membuat penghubung terasa native, bukan tambahan yang dipaksakan.

Anotasi @ObjCName memungkinkan Anda memberikan nama berbeda pada jenis atau fungsi di sisi Swift tanpa mengubah nama Kotlin.

Gunakan @ObjCName pada fungsi juga, sehingga nama Kotlin yang panjang menjadi titik pemanggilan Swift yang singkat, idiomatis, dan mudah dibaca.

Kotlin mengizinkan kelebihan beban yang tidak dapat diekspresikan oleh Obj-C. Mengubah nama dengan @ObjCName mencegah nama yang diubah secara otomatis dan akan terlihat oleh Swift.

Tandai pembantu internal dengan @HiddenFromObjC agar tidak pernah muncul dalam framework, sehingga permukaan Swift tetap kecil dan bersih.

Argumen bawaan Kotlin tidak melewati penghubung, sehingga Swift melihat satu tanda tangan lengkap. Sediakan kelebihan beban jika Swift memerlukan pilihan.

Ekspose class data dan primitif biasa di batas penghubung. Generik yang terlalu dalam dan hierarki sealed dapat menyulitkan pemanggil Swift.

Boolean Kotlin isActive terbaca dengan baik di Swift, tetapi nama pengambil yang aneh dapat terlihat janggal, jadi beri nama properti dengan mempertimbangkan Swift.

Tambahkan KDoc pada anggota yang diekspor. Sebagiannya muncul di Xcode, sehingga membantu pengembang iOS menggunakan API bersama Anda tanpa menebak-nebak.

Buka header yang dibuat atau sebuah file Swift dan benar-benar baca tampilan API Anda. Jika terasa janggal, perbaiki anotasinya.

Penamaan yang cermat dan penyembunyian mengubah Kotlin bersama menjadi API yang disukai pengembang Swift, sehingga pekerjaan lintas tim menjadi lancar dan menyenangkan.

Bentuk ekspor dengan @ObjCName dan @HiddenFromObjC, utamakan jenis sederhana, lalu baca titik pemanggilan Swift yang sebenarnya. Penghubung yang ramah selalu unggul. 🎉