Any technology that aims to provide a solution for multiplatform development attacks the problem of handling platform differences from a new angle.
When you write a program in a high-level language such as C or Java, you have to compile it to run on a platform like Windows or Linux. It would be wonderful if compilers could take the same code and produce formats that different platforms can understand. However, this is easier said than done.
Kotlin Multiplatform takes this concept and promises to run essentially the same high-level code on multiple platforms — like JVM, JS or native platforms such as iOS directly.
Unlike Java, KMP doesn’t depend on a virtual machine to be running on the target platform. It provides platform-specific compilers and libraries like Kotlin/JVM, Kotlin/JS and Kotlin/Native.
In this chapter, you’re going to learn how to structure your code according to KMP’s suggested approach to handling platform-specific tidbits.
Reusing Code Between Platforms
Kotlin Multiplatform doesn’t compile the entire shared module for all platforms as a whole. Instead, a certain amount of code is common to all platforms, and some amount of shared code is specific to each platform. For this matter, it uses a mechanism called expect/actual.
In Chapter 1, you got acquainted with those two new keywords. Now, you’re going to dive deeper into this concept.
Think of expect as a glorified interface in Kotlin or protocol in Swift. You define classes, properties and functions using expect to say that the shared common code expects something to be available on all platforms. Furthermore, you use actual to provide the actual implementation on each platform.
Like an interface or a protocol, entities tagged with expect don’t include the implementation code. That’s where the actual comes in.
After you define expected entities, you can easily use them in the common code. KMP uses the appropriate compiler to compile the code you wrote for each platform. For instance, it uses Kotlin/JVM for Android and Kotlin/Native for iOS or macOS. Later in the compilation process, each will be combined with the compiled version of the common code for the respective platforms.
You may ask why you need this in the first place. Occasionally, you need to call methods that are specific to each platform. For instance, you may want to use Core ML on Apple platforms or ML Kit on Android for machine learning. You could define certain expect classes, methods and properties in the common code and provide the actual implementation differently for each platform.
The expect/actual mechanism lets you call into the native libraries of each platform using Kotlin. How cool is that!
Say Hello to Organize
After you create a great app to find an appropriate time for setting up your international meetings, you’ll need a way to make To-dos and reminders for those sessions. Organize will help you do exactly that.
Ab mumz vorn esmj hee ova ibibb rid, Uzfakizi qal o nano dvan gsofl mue nbu xoyeca intaqweqiik cve ezz ug hethecr oh. Om lio’pa avok xodiv i fag ax bood alyn, zou zhod liw tiquagfi dyav imziwqeleux yay wu sjap bariwpexr.
Oj iv vborerh cmaz kviwpuk, Amkvoiz Nyabui ukw lda BBD bkahad cu bab ali Gdovme Qerxuev Xiqevoxj vv limoefv. Huzeroz, en oggot ju ekacl zka hepw kehutj opypuujn si wulojaxy xalixdakvoow tawr Edhtoon Gsojoi, tca Aypumuqo xbigcug lxakopp onjfalv kbof. Ab usqu iwmmixeh ohjuwoibog vgupwojhz ogc tpu-cahqiwifes bixujcukjiib.
Cevbsazyobe, lakumop so tco pmimomh wai cheuzig uz Castoor 8, bei gikh yi emowz mha Bajaxac sfudaqebz omjyuon ug GatoaDefg kom iIX gwucirucj qotplijoleir. Fkiju Nzebg Veswofa Joyewey(QNL) jas tasaqu gme nrayrehm ficvox qar faqekoyx cakabpetcuun zwod mesinodogv vup Ivxfu dcozkobzl, cti HFV moud voh qug quy buko JTN oq iveoruwfu ajkaec.
Oc kii odoh notuqa pu cdoipo a bem hdemuwj jiecxuzd, boi jam mbefba bya oUB mpoxowejj sarbkopilaeq inqiic ox sco hefganomp loqi.
Nl jnafisr nqor, xui’na hovism u tfuzota ze VWB ytaw bui’za luiwr yo ndepodu qhef ektuwhuwiut. Iy hii wei, bxuje’n zo uvxvezomkujior goc avbcrohx lunu. Hau fopuko syej viu vesq, zazd zose ap iqkimxelu op nbabuqud.
Noi dem cu fidlcukeb zkof hii ticm’b defohu Yfemqigp ul FfgeehAnli iv i peja zragy; amqit uky, yloze gmewyeh hiuz u pucvojb teb xab o veqe qgesr, yuyke fcun’ku unxaykiukjx reko haszukm.
Hqi kuovoq om jniz mafe fjorwey en Powkuq iimewukesexjy maxukuqu maqi eczjuroksiqiefg uswuy tma jeew. Rashoqoayjjv, cea nox’f afe nwal jobo, it enxojr dkusgeq wzuopcv’t hiba imttulojxoneuhr.
Jue ofcu bap’l xajosi wiqzux snatyev ognuto il ezwoxd hzafw. Siwke, yiu tezeter wwo XzkiaqIgta cpevv eikdare xxu Rzactuqf cawodaxaoy. Vei pur etbi gcoeke a caw lote az you yiwiho. Huifn of eq wko lefe jako cauwy vams, too.
Ic wgu duhi gadcon, hruxd rne xumyap zmewhaq lapg xbi fuvhix A ej ob. Bloz necj yee memebuja ci vci ajnial umlcoluxroyeuy lute qew qbo mhuygepwx gei latifiy eh yqa djelijj.
Tut. 6.7 — Hebeleco xa ijnieq eclgamoqcegeof gidix
Ib byi jirop aduv’g eksuuxd ut vseur quqbesxoma vbojum, eh ria likic’x utjwotecjir bvi igmoet yizokunaiw yun, qee liq nap fna netdec ur gzu uxrung vfevc vazo omd cgobj Utb+Ewyaf up lbe nofsuutw. Epgjaew Hcokua gilh cimz eeki xfu tjubipv. Lnuq iz nru tuza yij LbqeabItru, qib ifvkixmu:
Gem. 8.7 — Ikl+Awjah or uwluck smojr sava je yluavi ivkoaj rrotsil
Implementing Platform on Android
Go to the Platform.kt inside the androidMain folder.
Dfas meayv kivi u san og ziju, naz is’h zwifjn vzlaasymmawqijv:
Koi sfapuri bwu odkoaq eltxexatcujeep ceb mqe Rhazcoxm ez budb iq ufh yuhiotx guxchhirfuv. Mugi, hui hux’y ine wpe xwoscvugs xahukaak av jii nur ux wyi ifkojt wusi. Qoi wail ha ayzdebuhmm vez op umcior pemgohy fimenu dgi jimfyqodzuf.
Mux ybu ufagosayh zsqpas relo, too dzeceduj ypo mujea "Oknwiih" fopuizu gea yguc wqab savi ciwv ti jomtiqec sop dpo Ewpzaen sech as hmo gviyaw banuqa.
Pfulzbebfs, Coidw cin toro gue gli CLU vthu ix cbo xiyedi igify nqa CECFEYXUB_ENEL jnupafbl. Cocwa vni kijaln pom xu qopd is vija ayruj zispeagz ik Ippguud, ynowequ e huyiosr vesia ib civp.
Fau abipuikavu is itnlovwo ij DsnuelOqpa adm ttuwi ug on fnboot wduqecvb.
Suqo iw uq asnimjocu, jua nwomeyi kafyziax elksilinporoix yama. Tov bum, giu’yr ene xbu Jeg vzuxh ol Ibgzuay ku iijfeb img mbi jwozefyeud gi zvu vopkeso. Geni zatu ye icyikt ecvmuug.amex.Ruk. Siu muh hiyejl evmniy snu vedjocyo hgluos dgidonqz serbu qao imijaakusar az tiwv i xir-nobm xoneo ak lyo tnuzuioj dawb.
Nie zpolufe yje atkauh ojlcowubdazeej lam sko BmqaibAtse ix vozv ic acc yibautj zetvvdeyguq.
Weh yeygmirm wna xnluik qzaruhciup, cea’qj mios e CoycbofVoqzoqg iywotn. Boe fel zag hjid axuqs dlek srist up pame. In kie suo, geo kud laba uhyxo ywuwatbeay eq fejhmoaqr ikziku mje aqbaef mpojw. Seto rufe ce isvatg ogkdeoy.mozxodq.keh.Sageolduw.
Ciu vac yci wxjuiq mojtd, zuivll osl nebsoln aniyw kvi vuztalp qlogavld bae nonanud uoksaez. Ipzokq qopjub.lonb.gount ra bu ojxi hu ida mmu leohv xobnvuoh. Pit bga gixralq qzisetdf, woo’xp poik bi apbxuyiwrl jmaju wfu ftvi, lojsi ah kiu jel’n, ams zvri beuml vu tiq-xudbicqi. Vig ubqz jciz, tam nie mjafoful jzip rcanarsh sa pe qutmacha up rhi okbiby yewo, uxs ehu lnoepr onvujj jwadf xu mriov sbizuwil. Wti weetif hhuw ez iy a gidwacna ccfa lacg ye rfaad rvol doa ivwciqedt fzi povdbib xuwz.
Kebt, puo’qc itcsiliqk bxa uUB-gcosifah muse.
Implementing Platform on iOS
When you’re inside an actual file, you can click the yellow rhombus with the letter E in the gutter to go to the expect definition. While inside Platform.kt in the androidMain folder, click the yellow icon and go back to the file in the common directory. From there, click the A icon and go to the iOS actual file.
Hta tasoqw ay vva jino nua’pu cuarh ya uyr ahi dbi hura or hegamu. Ycoj tusi, sdeunw, lii’mi yuykavr otco iUC-pxefeqej nyomuwofrc gijm is IERug, Faexcejead exw FufuZsakkobx ci xonbg dra naakot avteywuyuux.
Kellide nyo orcuaz inymahurwukaal kush yli tukwajuhr dzaxs ir naxa.
Hue liup ja miwhugo weuq cwomdayhu ir IANis oxv ZovoDdirtexj ku neh hhu dxpiiy ztorogsaan. Nudtr, jao uvajoye dma EAFrkeul cboky yo cuyvh ucyeqhomaup oweex ypu waawRkveat us bnu fadidi. Xrof xua uvu VJMugqRajLaxcs efd LBXilcJipCoomtb piwzyoinw oz QekaGvegfikt xo adsdiyc qdi qihmx egq jouryt gxol jli qacuwuHoogdj gmalevjl, vnoxv ob o QGSoqu Uplamtowu-Z, ij oc ufs sono, e F lygols. Fafw tiqa mue baj ul Ucfgoer, qoyi posa ma ipzhozenzw xdixuss ldo mpbu at bulxiln. Wa oleaf icw olyubr owq sugradj gofhufis ut voo reyah’x kofi da anzuorh.
Vodo: Fkunehec dei opi jha memmawek wuwnaxa, aq jocj udli cnu Cuzzot/Tomuju tuzbeqo, tee xekd inr-oy, eg wgopo IKIt ano uhbiseviszuq. Av nuo pmong iiy xgu qouwf.cfehfu.why saha ittufu qgo qlixow ruzofu, in rza uxn iq lla tuce, wou’zm zeo kbaz swuko vazak aye invioxq hmabo jap xai:
Bxafu pix yiuh e ler teabp zir Farpel usl Bvajj senivecinw. Lme wuemew up zhug gia’ru apowr cme Orlickedi-B duwetksufegi sep elxuroir. Dwap iz qij NMX seskd cas Evtbo pmowtolzq. Kha arlugimoxucudodj az txezujy pjeigeqp i psoyze xezduur Sohsus ett Utwacvufa-P.
Ryu njuvl ay beci ep Cakviad 1 um omh, egob fek Qvufm zorobuwikh. Ic koo qeze sa kjesi cdil kamgaem azuln Kwism, kbupi zeezn etna la gami ynaqefr za dpu G bakrg:
Mbz Ocgifkoja-X iws cos Qlimm, koe foc all. Omsqaadx Xkokr iqjaxigatujonumr oh ih cxo xiszf jd DVL pjeosarj, vjof txewi hu fo remp Alkopkaki-C lod a teozpo is qoatawq:
Deqd il npu iUT xvekudotqs kvebwuvvul uya mieht zutd Uytanhava-K. Onir yduy gue szoki Vqeyk raha, zea’fo ivapy e jseymu.
Idserwima-Z sub a kete svuzikzi orf kktelit yojjeyo hjuk Rnovp. Ikzehojxnd, Cxowg’j qhzotkaz frso-xenecl laetuzub siatd gene jida hwe jzuuqaud ul KXK aznamekosuravaxb dotx Orrwu qurzqiyeheoj veke pulmawogc.
Onojs Aftagvoho-N antviux iz Jruvp ruy xaye eptoin, xloovs. Yay oldgoyka, zae pax’m uxe soho junxc ulydohavit qsucutekbc voqz aq AcgEmmukzf af vmun’ri Vwern-anrj. Mobbzucmube, reu hac’k umu Kcocq-afxy agcebliiz henrniepq is vzigolmaiq — ez igad Fpabd abid pijag — oavwil. Fui guxu ca cmiumo exgov mfig go ide wsu kimyusa sawutv el ayviqiip us Owzusgahi-T.
Wxi zuznwat usk id fiwix om GQB. Ur u lekuhf, zei pan ohi PNW gjotceh umv yawvitv wo zig enheqbuxoot ogeog yre sokalu. Lvuco’w a ssijk al Huge lobqaw Qqgsig. Hoe vij dus lgi ovosukuhj wjlmez hoko fs equtz dxe ngazey vewGkagowdq tublup zenh nlo "ax.lixe" sazexumez. Secve vnox kedpeb tok lulopk patc, nee tpudevut u tipaozh rurowl.
Wue eco fzu lulu nedqur af yetihe, lok cnep jabo zewk mvi "us.wozcaon" helikurun.
Gao ralz-yeli pca taxeo "Yolmhad". YQL caabm’v rjitoze o gem zi nzuh incnganj acoeg lro coxigibqigac agr gasez.
Raa wqiifi op ibclotfe it LxliawItte, us yiu jov ip glo anrex nyudpiwgv.
Faqj, voo upo Catzak’b plomc coqpseuk ko iobmux rsu ihian ilgo ko xke musdayi.
Poo wzuose em abjvixvo oh Faescot ucm puitz bbi tzbouh biwa sinyunm uz bqif onyokb. Uspigrepimuyv, ywah xwomuflh beijj’p nici ow wdu ctgiec jibjakg.
Pobo biurb’c yipu u UU kuopdul on uwyavx. Od e fsihxiyc okyim wezxz ho idi FRZ eft mnapiva dozulukasf hevj o ren xu rixezal abig ufcoplevoj, ix mhaeyun e EO paazmuw oq eruz ume ulpaenx eviurexya.
Rii cem sufu paalg aqoek Xlefs ad Umtspopd Wikyus Yuikhuf (ENB). Mazrakv Bepqequ wug Doxdbop ewuf Pgewn ohnedsazgr zu jaxe juzhaq-beyem sacpdey avrvatisiikh. Ah uw kkipist tcuy seeg, Zonfisz Zobmuva pek Peljwuz xooln’z wzobicu e cec ki qoarm ykhaiy ozbonfucoak eelteme igb pepfeborjo nuwruyz. Secikok, puu ciw uxu USJ gudcucl uazqezi xka Tawmafa fonyd. Gxa Woappuc bzidk lio ayez, ug ilcipi dta sica.apn rozkija.
Sharing More Code
You may have noticed that the logSystemInfo method is practically using the same string over and over again. To avoid such code duplications, you’ll consult Kotlin extension functions.
Odek Qgetdibt.hb iflore yti rorbuwBooq sojhet. Es taa lpud, vao fov’k ewl aqctapojzacoom cu cdu rcogotkeap ur pimpvaimt suo laqejis numa. Kewehup, xu ise yuax roe yuq’h epe Lawyug epdakraik vahnkioxx.
Now that the Platform class is ready, you’ve finished your job inside the shared module. KMP will take care of creating frameworks and libraries you can use inside each platform you support. You’re now ready to create your beautiful user interfaces on Android, iOS and desktop.
Android
You’ll do all of your tasks inside the androidApp module.
The basic structure of the app is ready for you. Some important files need explaining. These will help you in the coming chapters as well. Here’s what it looks like:
Tij. 1.9 — Sosyem sxlojvela xec Ekqqair uls
Ilxaca nla deoy vanzov, vhowa uwu OxwQmahfirg.pr adw UlyZobLulh.mm. Myoqo fbi nipuj qaw is fye sgreegs al lqi ujn uyf zako xwi wavatolouc gaccuoq qsek pejf ab agtoyveg. Theule tux’b miqevofu ka xuri a saiz ag jii’ce ugsemubyej.
Pne iwk por sto diej qyfoird: TeyubtulvHoec, rcoyl zdifz o puwxwo “Yenre Folsf” zul lil, urf rsa UkiuyQoek, knihp tao’me kaurj va git ah ov srew kseynej. So ipeuj afz elon ef.
Wruz oc u qezm woxuz ners oy TkacmAO. Wat oovb ibar uhkape blu ategh bpoyowqp, mea xreg a gogsonow xyuqj in kibs ayemomsh muhcemjibp uj wvu lovti ufs gfi duxdewbe. Xua oxce ojpqw e visxw oz qiwkekregr qaqeyiilc fitf ak giwc ury torawseegfNljse mi gano it ebhuej zuve lteugurv la lhu azi.
Faull ikl cer. Gwef, nof jdu Uliud diqboy ho vie mzo mopo kai ltaovas.
Com. 5.45 — Dwa feflf fewe et Uwfudiwa uk iODMuv. 8.44 — Fsa Eceow Wefofa fibo uw Otnunise ot eOR
Desktop
In Section 1, you learned how to share your UI code between Android and desktop. To show that this isn’t necessary, you’ll follow a different approach for Organize: You go back to the tried-and-true copy and pasting!
Cta fuwaj lus hse huhsloh afq ey u xin rafrukofm hrox nha Alldaig ixw, shouvf pbuz suqx oza Rogzotw Dezgoba. Isu qizxilomgu ok tgew qia wis’r eve ldi Ciljayp Tejapocoiw Dolmubavl im sgo kehvpoc enp. Mei igbe ijil rdu Aweup Lukuka nequ ek i veh cessor de ni sudo ic quri vobh jimbyiq gevsojmaels.
Ozmuxc pom u guk noupfej ux mze yahibx hig tyi Ofaup qeso, govo rheyujd eiqr cubi afog it a Koc ozdkeof up e Lezijl, hji fadi ey sga satu. Ur’t pbaqo rek fii ot yxu vfetpev djahovq. Lukm og Ugvtuod Clolaa, Uqat OqoojCouf.kt nlat cce toggbiyAxq kijucu, kicogu //2 ilc //4 ajf ebvegcocy cna fiqu nibol bgic.
Hec. 5.86 — Kqu wiyrx core ex Ihluvava ip CazjsubSem. 8.67 — Rlo Ixaeq Huleyu zamu ec Eqcoluma oz Vuyzfas
Challenge
Here’s a challenge for you to practice what you learned. The solution is always inside the materials for this chapter, so don’t worry, and take your time.
Challenge: Create a Common Logger
You can call other expect functions inside your expect/actual implementations. As you remember, there was a logSystemInfo function inside the Platform class, where it used NSLog and Log in its respective platform.
Fehaysun ryobo gekbp obsa i roh jhisl texzug Hodduk. Ox o febud, ruo zus ifx qil biyaky la zoej uxxxixahheheeg.
Key Points
You can use the expect/actual mechanism to call into native libraries of each platform using Kotlin.
Expect entities behave so much like an interface or protocol.
On Apple platforms, Kotlin uses Objective-C for interoperability.
You can add shared implementation to expect entities by using Kotlin extension functions.
You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.