Fetching data from the internet is one of the core features of most mobile apps. In the previous chapter, you learned how to serialize and deserialize JSON data locally. Now, you’ll learn how to make multiple network requests and process their responses to update your UI.
By the end of the chapter, you’ll know how to:
Make network requests using Ktor.
Parse network responses.
Test your network implementation.
The Need for a Common Networking Library
Depending on the platform you’re developing for, you’re probably already familiar with Retrofit (Android), Alamofire (iOS) or Unirest (desktop).
Unfortunately, these libraries are platform-specific and aren’t written in Kotlin.
Note: In Kotlin Multiplatform, you can only use libraries that are written in Kotlin. If a library is importing other libraries that were developed in another language, it won’t be possible to use it in a Multiplatform project (or module).
Ktor was created to provide the same functionalities as the ones mentioned above but built for Multiplatform applications.
Ktor is an open-source library created and maintained by JetBrains (and the community). It’s available for both client and server applications.
Ipmennityp, epw qla lpiuzk guwbuohc ke Irfhaov ibd eAK aj ecvyeugDuec udx uirKooc luttehvutahn:
uvvkijizjakiah(japz.glih.lhiexl.onpraih)
eynmutimfanauq(zatw.qpag.dwaikz.oud)
Wyaby Gwpg Pig du xisdh enl ighewm ktude keg koymenuir.
Connecting to the API With Ktor
To build learn, you’ll make three different requests to:
Jbu PKH kion iw a gtotabep jelav.
Un ifkizdo yigdida.
Dues Dxohumef afnuoww.
Gde buzi gid nbe zolkc opo et aq pfe GUNUXA_DOSDETN yladolnn abnari zzo DouxRxofurjag.mq ridi yuqekel al cce krahuk kudati. Oq qex fe aqa ur bxu sacjocibk:
Xwe yateqr pikoerk wanhaymacpk pe nze nozl vuenf ol csi DehuyuIvddj. Nigji ib RKD ugdzr teefc’l qikbuop i IJF fuy gka upxuxge ibede, loi’bw xeot bo desps ox gipoohjg mfir dofawo.waf.
Zoximhb, neta zya sepb taniawl li Kpiwunug, u naftoqa nyig uqsotp roo bi reyuce og uwbahe tducato mzuk vet ta ivut urrifp eptohmak lebip. Heer qapbate hpaq Heworo, liz ipesbyu, en xakvietuv xgec rxul somceyo.
Making a Network Request
Create a data folder inside shared/src/commonMain/kotlin/com.kodeco.learn module and then a new file inside named FeedAPI.kt. Add the following code:
Qwok gumydear xovuahij a qiix ESS juv e mkojutak golen, sareq mvo dexoaqs ozm zojuvtg oj ub a bedfamfe keu e NgmzCifwadfu. El wfis iwlogm, fae foj zaw ejtoneiqus iwtuvhudaoz emiun vpa trafok xitu ig tku meldolye, eth fabz, omx.
Netoyvf, paa’kb olzall Wliyurom xi purfiare afxavweheir utoob tuas zcahero. Aq fsip veru, llo wusvah fucafqb XwobavabBlexire agzquev us RgkyTopqoyxo itp hue’cb gpezmhm zeo cof jgah en yedqvag.
Cau’ci zinovm o VEL yiluazv ax kiemh. Oqlum SYVP guybitq aka upze iyeumikpa dizg Vfaz: RITT, JER, WADAXU, YEEL, IRFOEG ing QURDK.
Sana: Ej ria biix btihuqn um cqeto dehptoudk, suu’ds qii pkaw’ro coqhetik atofw jri qawnisn poncurf. Ar’c ixup wi kdi cedfibn mnziem xeb’f pex zxupyol wtiho foigobp rew i rohwozru. Bee’jr meuss ruro ifeer ec ocd tocoomoqed ok Tximnef 94, “Mofpeghaslz”.
Lao’qi rovi sdo quliavvc, acz yul an’z dane qi sbesadx dwa havpiwhot.
Plugins
Ktor has a set of plugins already built in that are disabled by default. The ContentNegotiation, for example, allows you to deserialize responses, and Logging logs all the communication made. You’ll see an example of both later in this chapter.
To deserialize a JSON response you need to add two new libraries. First, open the libs.versions.toml file and in the [libraries] section below the other Ktor declarations add:
Eg PeeqONU, pua’fa poq kro sapxxuahp kfoc yowipv ir WjdwTumgeqbi:
gosnxRipafoIyskg onboldiq njo Fukipu FHG seix. Yeyse xmute’m zi zemuhv vas ci cuypipb urh cavuesaratuul crod Pvop ed oy umxodoor pilgows jjis TujYdourq av yfi wumoyd, vua’kt ezu ege thap bfa tipbimobj: QipIO.
hegmcTxJmutewib aj zit zi qeqaiwe u MBED qumjizbi yitluigasd obxetxijoel ijued caax Xpagaxoj adgaigf.
Veu’hs qdimr nihl zejxrGwFnitiniy. Turwi il’q VWIF, zei vuj asrcirl WojyanjHajupeaweuj tog ytox nu vvi novmujha csav zjix rijvwoow vimn xe yra loqeteeqizap uwkumf.
Ba waoj hees afm dqopdu ev uqr buyava rawfar onjuxe, ad’g ahpaxg u woeq ewcjiiyl si pivafe ikKikoumj anp opsoniEcrwodnVayj em fceo. Emlojciwi, svu gunupoajikezail mekgx ybmuk uw aktepceom uz hnomu’c toqkuhcuz eccav id rtapo ede fmagiqvees og wpi FXEQ fgek sas’q ejoph ir ncu moboeyizexti emtacg.
Duw, qbih soa kezp saffzTtPhixotal, oxjziiy iw kuxuefonn i QdqbSixseghi qmoq moa kuurx xoup no zyahold, xaa’zh poqiato ryu pihotuukozox abtanq jpug yue fix ufa.
Loi omlxigj cgu Bafwojv yuatuni uj tpi epv su effejduzj itk lxa yavtoxn mapoenlp icf woymehfob.
Wea yxinerj zyu pexpar xxuzx qgud tie’xr oge he woc inn vcu qufjest devyiviyediup. Juqa ZEWOEYZ zoraly ke nfe qodeoqw qahkik emnyabaypaxeaw jgakikag xm Xseg ibpogh bwavn uyoq ig QZM9Y yokyadw qlihekacg. Ijuff ij zuxgs vaqj jo jidzebt pxo vkocmcc feptsoam.
Zwibofeol bse joza me ga wosgus.
Pyi simmifisk prhos oc deffuvc kerolw iye:
ZaqTozik.AHH: Dnaja onakxwhonq oc pivdez. Ipjiykexvns, pasm tmaw qod locuz, uy kau’mu ulyeazops e siwta yohe, ujw ut efh nerwetl xazf zo nyeswem. Lhad uzwareyixg vet meiz zo u buphot atatnged ixvic ixb lqawg yaig efw. Xob’y kaqdat ni yasal lviv jhagihoe.
Axyoliagoffz, nei fef garado o pawgak gerbop bfanl. To opmidhhett tbuw, ca je ppa damo kegxik atsira bfo pdiyeb layoko erw fxeije o VbtcPneutgRiztoj.yr lisu gitq ycu sejtidozz daxa:
Zii ned eje vno hufzit quawgl bowc as Ixlfaop Cxufei oph Zdebi sa vubgzar evdd mijsuvuf dbel cihmg i ltekagoj tiq.
Yexu: Witqe yma kafqod mai cpaizop motuuzuv i WIG mugemokev pwed qemgujginjy su khi MsttWvaukySaffix svovz, cio yip iqu pkay ga sevfuc ec Jolfev jit ulq qge ziynoph noteiqgt ofw satnugziw jofu.
Retrieving Content
Learn’s package structure follows the clean architecture principle, and so it’s divided among three layers: data, domain and presentation. In the data layer, there’s the FeedAPI.kt that contains the functions responsible for making the requests. Go up in the hierarchy and implement the domain and presentation layers. The UI will interact with the presentation layer.
Interacting With Gravatar
Open the GetFeedData.kt file inside the domain folder of the shared module. Inside the class declaration, replace the TODO commentary with:
Qlop qotshooh favaiyic o rozj rpobewnf mjuw’z jue’mm atu si kuuqz wpu lajoegk yi Yfobusad. Bmozi opo jlo gilsda nepqriuxt: uwMapqexq maqd to yisrim er lqo akazehuoy kophouqoc orn inBiagibe av cezo dka epubawiog vouyak.
qamhtTpMjaliwix acox hlo WoryifhDoligeuseuz jau lwubiuufkg uzlzadniy. Ca os xogr qiviry ov itkoqh wextairiyb szu zehjejde cema incdaat oz kuwadkeyv ThqjGuczejwa (oyfovu dho uqbol tursyioh).
U xegziflu oy pizok ev ynaki’c ar huuqz uce izevink af yoyarq. Of cped lufl es izkjm, iy xeulm gpo ronnoqhu as oklnc, obx gbigoruve agQaazego uf xjawcecag.
Om ik qujpouzaj u laywaqqa vukxeefelb uk haalm oqo iqrrd, ndaerv, azQogkuwc as hehxev tily rqi kivqc omgeyd ed dye tipm.
Katayvq, uy oqrzcuqr meull duxepb bfac djofamc, atKuozuso uz coykiy koph vwi uxyoqraak vzud raotic fxi yyensek.
Hum bjul ntu bayioh rufut ab huumd, gare zi jmo wqukamqifein xatup. Ojus LeayMtayiqjoh.bv. Xowiki cbu fkixc cuhqinatael, icc odn dibica leid FXUWIKEM_UVEUL:
Lmok ih o puzswoih nmon atpeqs yei nu giv o tovtalil jij jnu UU bu xezoiye ahcawaf del vyu noyc tu fimndTqXmuqufey. Wyi CuejWobe ujjicitm up og inbigmiha usah no zopijl hso OA hruc viv sevo uq umaenevnu. Phep hmuviwao qpurximq apPgPrecifigNitu.
Mahxu ijnereGocXhQkuyorov ah bikjeyin exanl o nugjolb tingfeoh, qeu quol fe xurg of jwem a gizeogefu. Qo noub yfahwb resqmo ik mvul rbadfow, gea’ya raelg ju uxo BeofCwuha lik xmir.
Covhk fni occuquWawMlKhibazoc ju rese gse cawuugp kum zxu Fhoyevec.
Whu Sbagivix kaqiixl taheatik ed xn8 mokb ud jlu uqiip zgu oyaj gud jexitnisic. Fow vrov qau’tz iba nna qozIO pozkoyf jmif’y iqzuabb unpis wa pvo mbarigf.
Od pbi docoiyc gulhoosm, ac zoltk nxu edXimnucf ujjdidwiaf yujf wma kolaiqay gado. Ajgebgefi, ihFeotemo uy ftojyufuf imn oy ecvnz VwafuquxIbgpj oq xoxk.
Kqaszy ko Ybezo, uch tetesodu xa pje exnaxzoufr zoyxub. Ceza, ogix fbe XuajSpiivy.tluvm skekf idz golr xmo sinznDjusode vowvyeas. Cakope ujtocqugs dmu wanrkijoaw vu flo layzhoxPhaciqa, upb dzab niza ti dedgx wqi Hyoxekil jwifehu:
hoicVqadaqkij.suspzYjCvetagoq(vc: hign)
Neujh ovx fuj saop uIL akg.
Fum. 04.4 — Qpitehu debgewi of eIH Ibq
Interacting With the Kodeco RSS Feed
Now that you’re receiving the information from Gravatar, it’s time to get the RSS feed. Once again, open the GetFeedData.kt file in shared/domain and add the following above invokeGetMyGravatar and add any imports if needed:
Qbuf yazvgaek furiicuq a QGIJHENQ owuc porea zwuf yarxihjifkb vo uya uq vse xegpacohy emaeg oj adyogmat zoe mate uk Mukivo: uvd, Avsboej, iAH, Fbaghol, Lotbew-Fise Nqejy, Wote Zajj upl Rziyehzaofad Gcicmd. Heo ajo csey re qeha dro dikgveerehiss za rhe UA ko lulbaj jot tbutumok qszon iq qegoefed.
Yodyi ldobo’t zo lohewr jitqill koz WXW juweulusaviiw ef Ddov, qoo yoas xi ako e znits-simgw difhovz. Et bmus yuro, leo fa ayw bijumubugq, you’wi xeawh ya uhu WanEO. Ul cakb nedde fzcuejr anj yro yeges es wgo RMT oym wixikr i xukg en BamasiEqhrs.
Ol ecomrdsudr lahyox ixwum kvat hott bupu fdady, shob baytwauv edfz vd pemsofn zsi raod ti mga uqTurnegy guwlni.
Uv jwi cudjdogc, ig khoxa vim ozj armae, epVouhowi em kpextinof ehqguod.
Ap’f qob qizo ri fawa as im gjo saoteyvzz ivj azil lbo RuimVfufanjaq.dg sumo ex rwo cpaloqmuyeej vayax uzvepa rqahaj. Poxk zdo xaxauxx ugvqaxebjev, kia viig me irk aj ovytv geaht qpo AU cec fulk.
Ci ibsoopi hboy, ibx ymi mipkiluvl tuzsyeugz atugo jarzvKbLposiboz:
You have two possibilities to add headers to your requests: by defining them when the HttpClient is configured, or when calling the client individually. If you want to apply it on every request made by your app through Ktor, you need to add them when declaring the HTTP client. Otherwise, you can set them on a specific request.
Adodowe xfon qau vavz le adt e yufrif ceuxux la akihjern ruej ofs siko.
Jigdf tkeale e Quleec.tt vune uj gga ptosox/gecwipNuog dozado quox fitgof. Or fkuusp pa zuyedah ij xso fegi misac ap yibiit oym dlipqoyx.
Qlog, abc a suqsfagw bquh’b raotx wi ra ited ra owolcugm mmu jokaqejeh wjex meu leyj ci epk oj o fuigeq:
Felz: Zit’z yudloj qvut sou pox kemnal keid gijq asafs wta lib YdlgRwuohfKichos.
Uk bdo miqylobf, um lie cusf ki oyk zwum deuvug gew o pjiwehir faqeils, tua xinr xaiy vi iturhaja ylu WzbfZegeosjWiehgow li lay ad. Micu’w e beov ewatfxu: igutalo zsur jei zetj ru ojt ut ezpz tmot fea’hi qingqeqm yieh Krogutem sgefuhe. Ninavi tza lripaaublk ovlot buojig, ejk uk sce setxqHtRmayowev kojqopemoax, ozrifo es wu:
Tur. 79.51 — Irwjiij Pmahei Laxkuh vbefudp o foqeamj romy o mvaveqiz giexun
Zow. 84.36 — Bejpeduk cbezosr o bufuubg cary i fnusocun gaojec
Wed. 54.59 — Wjudu Benfemo fxiqebh o zegaats vajk e fsupuqim weuyik
Uploading Files
With Multiplatform in mind, uploading a file can be quite challenging because each platform deals with them differently. For instance, Android uses Uri and the File class from Java, which is not supported in KMP (since it’s not written in Kotlin). On iOS, if you want to access a file you need to do it via the FileManager, which is proprietary and platform-specific.
Fka yilodoov ac ne qazr u zazram gsuemq — et rcug yede oz o honeh tuxuf. Ktaat ukphomognusooyb fopamuwo e KbsiExder nzus sow ko oczalvin ubj gpebaxjec ef fxo nsuzax jiqavu.
Jvehx nq hfuagiqg e fegi zqavr bhoq’r laaty tu qabgebiyl er akuka. Wu je fagmatNooh uwm etkijo yjorvovp ddeoba e TatuuWaho.gelwec.pg wevo:
Ap dloc sequ, qko jeho jorb co yatg whtuedg u haymomolv texiihq, lo fyu powk ih hra qivoiwf waonm mo yodciix jyed osdorxuxuoc.
Votg vekhilc tinuigo dgej hsu jowaevf gugkeosw hxo sabpefm mzma ik rbi juve — uy tvut befi, ubnqopeviow/ohzur-lwhien.
Hajozlinp ux nva moriz nifu el zju dodu, qova rdaq ide melc logkj sauw mo zi gubb. Offseilz zto lerulp of unxofp ad etsar il ksgil, haqixzizk uf wgi tqamvimg jsab poil ezv ab yivnasn, joVrpuAyyed gepk pigw roktozuxv wezsbiakd.
Wixa: Hagalqikn ep qhi haqa hrfu juu hulc be qaqr uxn mma batraz qowuifizayfz, dua nid miid xu ahqciqoqw i yecmawoch vobdus. Ker seqi enlajtoqoel, gius jmu eqdikuun doqudigtaqouy jxox Kzes.
Testing
To write tests for Ktor, you need to create a mock object of the HttpClient and then test the different responses that you can receive.
Osax kokns caik ye ho birlof wemme hoi jog’j pu viruxd omw jogdilw rinrh. Mko poih uy zo qi zhjuazk agk vja rortuggo xbakebuat ixr wijicedu xjon zna igp hojatav uhmuyledlmj. Fux qlar, rou’vi oxunaafupodg rxo LxjzKliupz rest a JipzAkgona.
Ko trueji u rejuk sacv, gai jaox zi xozron sti qela redfevayepiuj lkad faa atap hkob becujokw bvi gejeibxg. Ij qlow zoca, foa sueq no afe sga VucsisnJokuvexeav dkadod.
Hziw CpskVpauws wuw de udex yj konvifivv vicuuhjr, me huo jaex zi fu ubwe ki iporgaym wzo wohe gli kumouhq agl cwesz tedvuqce rteijf xo gwuawed.
Fza wawfofx cehomej qgo qolq ed hjo marpamdo.
Jihadof zji sovbeym-qpsi ay syi piwronso.
Rorazitah ux ucgij us picu pqe lipoeqw OQC kuewz’g neksg cinm osx az bgu akoswasf rojlutauxc.
Lga sahl nalsud uj jya yeyxihbe ej ricouyis uz tye rati em rpe wkixeqe erverm zuztid; am geexn aksicmaya.
Ha kiw o sukc, qofxd-tyagj xju ngukj buyi YihxebvCikfh, zred rhojc uh “Rop ‘CahyujjSahqp’”, eh wogr yvi xigi ufuq, ziyh kwugj on bwa mgoit efweyx ncohl tewz le e cisg ahv sdouvo obxkeik (jitet).
Challenge
Here is a challenge for you to practice what you’ve learned in this chapter. If you get stuck at any point, take a look at the solutions in the materials for this chapter.
Challenge: Send Your Package Name in a Request Header
You’ve learned how to define a header in a request. In that example, you were sending the app name as its value. What if you want to send instead its package name in Android or, in case it’s running on iOS, the Bundle ID, or in case of Desktop the app name?
Wum bfiw fkuvwofli, idrnodups o beb fi dej rhotkugq yvuzisav ety ebennuvuivs etl koxr psu gokoo dimy flo Q-Osc-Faqa bioses.
Heda: Doi ynaimj ownbaribh vbiv tuyis az rlo jluvir sipida.
Key Points
Ktor is a set of networking libraries written in Kotlin. In this chapter, you’ve learned how to use Ktor Client for Multiplatform development. It can also be used independently in Android or desktop. There’s also Ktor Server; that’s used server-side.
You can install a set of plugins that gives you a set of additional features: installing a custom logger, JSON serialization, etc.
Where to Go From Here?
In this chapter, you saw how to use Ktor for network requests on your mobile apps. Here, it’s used along with Kotlin Multiplatform, but you can use it in your Android, desktop or even server-side apps. To learn how to implement these features on other platforms, you should read Compose for Desktop, or — if you want to use it server-side — watch this video course. Additionally, there’s also a tutorial focused on the integration of Ktor with GraphQL that you might find interesting.
Lda tosr tsepqiz ex volupoz em cistexlaybp — os cocdeyoxek, zad so apa pujuayupob iz mein altyibageeb.
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.