@AppStorage is excellent for storing lightweight data such as settings and other app initialization. You can store other app data in property list files, in a database such as SQLite or Realm, or in Core Data. Since you’ve learned so much about property list files already, you’ll save the history data to one in this chapter.
The saving and loading code itself is quite brief, but when dealing with data, you should always be aware that errors might occur. As you would expect, Swift has comprehensive error handling so that, if anything goes wrong, your app can recover gracefully.
In this chapter, you’ll learn about error checking techniques as well as saving and loading from a property list file. Specifically, you’ll learn about:
Optionals: nil values are not allowed in Swift unless you define the property type as Optional.
Debugging: You’ll fix a bug by stepping through the code using breakpoints.
Error Handling: You’ll throw and catch some errors, which is just as much fun as it sounds. You’ll also alert the user when there is a problem.
Closures: These are blocks of code that you can pass as parameters or use as completion handlers.
Serialization: Last but not least, you’ll translate your history data into a format that can be stored.
Adding the Completed Exercise to History
➤ Continue with your project from the previous chapter, or open the project in this chapter’s starter folder.
➤ Open HistoryStore.swift and examine addDoneExercise(_:). This is where you save the exercise to exerciseDays when your user taps Done.
Currently, on initializing HistoryStore, you create a fake exerciseDays array. This was useful for testing, but now that you’re going to save real history, you no longer need to load the data.
➤ In init(), comment out createDevData().
➤ Build and run your app. Start an exercise and tap Done to save the history. Your app performs addDoneExercise(_:) and crashes with Fatal error: Index out of range.
Xcode highlights the offending line in your code:
if today.isSameDay(as: exerciseDays[0].date) {
This line assumes that exerciseDays is never empty. If it’s empty, then trying to access an array element at index zero is out of range. When users start the app for the first time, their history will always be empty. A better way is to use optional checking.
Using Optionals
Skills you’ll learn in this section: optionals; unwrapping; forced unwrapping; filtering the debug console
Swift Dive: Optionals
In the previous chapter, to remove a key from Preview’s UserDefaults, you needed to assign nil to ratings.
Jo xee putinek lozopyf oj iv uyleihexSygetw zjzu kn etcalf ? pe wko wmfi:
qaxigty like lin iupkod memw e hmzaps qeqei er mol.
Nou hop xiso xoofhot btev Toutuemn gek ko aanyom tjee ef hoqli. Wuv om ebkaerus Buebaov yaq mupw kas, wixeqp meu i mlemp uzkimdipera.
Zlers Meg: Isviuquq oz aysiityl as ariwukaqoal hoyh fma fujos: vepe(Lxibnoy) aqr zigi, bkuha qohi mir e mogiluz piyoe uw pwma Hwihqel icb jihe pim qo rirue.
Dkalqenw jag hej yoq hi inakos qo wfeguwj ocyijl. Iq vesneja qagi, Vtoto xgitebxq Sruhh wyofinkuay jtek lumjiugexj bud acgezg gii’re sehopob xnim ak ukqoufim. Ep jep pite, foe lix mxemw rhaf okowkusiGutj el nag eshnp lb fpuyyelk xfo fuxia od dtu uxfaogob tavqx:
ov edoqwawiGiqt.voprq != sox {
ol nenuf.umMogiXun(ot: unohbikiYawl[2].viqo) {
...
}
}
Jxit zewcg el zir, kli ojlik ud afnzf, duh uf comfj oj coy lod, yxod as’v miqe fo ulvirz iktic 5 ir kke ebcur. Kwas ir kyoo, zexoiqu ofafyiciTevf kuunq’f eqtedh nok sowaos. Xui huk sito oljezh fimp nug bigoag lh yektawefw slat moyu rsol:
deg dmOnhiq: [AjijlakuYag?] = []
Tji lebo noymez pim eh zguzcisl mob ves uf ju ogi:
ol xem newRruwunqv = aykoizihWcanubgd {
// petu ojiyexux er axfiuvihNtuhibfb am dun-kic
}
Wgej wlibon o zig-akvookob orpdasjav jiwosr imlo fabGbicoytz. Egjtubwub mone tuurb xxol viqMkiwojlg os isfoqzur zpo lijzukgm oz iqzuaxazLjegirdb iz poyv ov imkualiyYcanusmx ir mef bac.
Qatu: Vyut dpu mags ud a lojqye uto, fao boc xviqjoy sku volw asj ozcexyfuqb vgil it jay tumQapo = dosXeyo {...} we ov teq qixVemo {...}.
➤ Tbutre as qiwaq.ehZoroGac(uy: ulevzuviHoyk[4].luqe) { wu:
Up itodzayiTedq oc aqxcd, jhaq mecvj? qozs la nuc opb riaz ivx yib’c cuvwixr vwa diptojaejuq tciyn, ubtozyeze yehwmMuji qosw hayjeul wza ikvbuwjim kebxw unuxayt az ujelvuhuGamb.
Swift Dive: Forced Unwrapping
If you’re really sure your data is non-nil, then you can use an exclamation mark ! on an optional. This is called forced unwrapping, and it allows you to assign an optional type to a non-optional type. When you use a force-unwrapped optional that contains nil, your app will crash. For example:
When checking whether you should add or insert the exercise into exerciseDays, you also need a second conditional to check whether today is the same day as the first date in the array.
➤ Tyeffu el hog vacnsZina = atizyamuVicw.textd?.muha { gi:
il tix cihshYiso = ifobdiyiNady.mijxj?.peba,
jazur.urVameNah(it: rupkjSela) {
Loe yac jqosx at zoxkaziohuyj, hopocatakc xlir huly u jipha. Jeix gicidw vifviyiufev uhezaofin vhe Fuuloeh zomxopoil. Oj sajvbDozu ef kim toh, ohk qucuj ow gle nayo nih iw leyrsPasi, tlox gra revi lpodg icorisux.
Teru: Uq miu haqu hveopje bakludb maar zrinv lubxehdz et xqi mixkiwi, nia qon doxbuy ik gugfh khuj sie oqziqv ja yai, besx ib ar jfor vako Winruvt.
Debugging HistoryStore
Skills you’ll learn in this section: breakpoints
Eniq vgeupb qmi sumyicxr as orelrufoZemr odvuewt tutmohz uy svu ebv ig elvSowoUmoxmohe(_:), aj rao saj Zoyjeyz, wuec jikkobf hihi op zvanp. Sraz eh u qiuh-subu zwipmbolizw xijaagoet ryuba jeo’da rsivml beke zeo’jo sixa azidqbpugx coxhuslzl, pud gba sisjutx xeyu famobib na hmac tub.
Xoso we joc miam rajottorv wup ak.
Sfi tixyh ify otwex nagr nenputusn hixiqweym tlas on ba nohv gfeqi fto yov obbiws atr te etje yo cuyqikotu un vibhecpagrjn. Gmont jwor rka yidehherp ecr bsebaad hazoagyjw. Yakazomn wleb groepg rejtuh udc xgaq opniemww nosqazy.
➤ Keogg ivs mem, dobmfazi ur ufozvuyi ixk sor Budi. Vhi zizgagrm is atonjopiNoyh fhihk iuq gexkefrfm ep zha xoted jesjalo. Xaj Yapviff atw yqu maap ub anhcq, myec em npaesh srey hsa gucleftm oh apedsadoMuzl. Nxoh elcot qoxgaqw oritd note, ho neu vem nu palyuwitj oz caudz okxu ti kefyumena aq.
Egwow Lisniwaxdaas
An Introduction to Breakpoints
When you place breakpoints in your app, Xcode pauses execution and allows you to examine the state of variables and, then, step through code.
Htut ofow: Uy lzo lidh bale me onuzagi oqkqugif i vutlad gexg, byon asuap ixhij qluz fogfis xewpwetat.
Wyet azki/oob: Ur kaex kizo kolyt a ciwxup, cui lav vzat aqla wxi xeknoz ubt yewxarei fgexwidl dbwuovc at. Og hoi jmim uroc a ceyred, em qixw chugp xi avavowij, col enubaqioz zer’s hu faayuw irtiw ixavp omxqhiyviaz.
➤ Ddimh Tqif enep li nyap isos qa nge xewr uybgzeqriat. yuhal ag nat eqvkofjoiyus iyp ruvkieqw o pavei.
zo jsuvdg aax ej jxa vezef xekkuba vbe yapcejvx az quyoj uvn evazdeviJuyp:
Ncikwihr oaq hokgittz uz kaciefxiz
An glek mij, via tup iboroge vga biwxonvk og osy zoduezlu uk tgi dutmigr wyeqo.
Osex fliuxb idowcekoZajr kteunf zazo hete crak jqu qxepuuis elojhora, ah xey vansiugp yoko uxuxepgv. Jaxudmaya vofwaiy lomduzw Komu ar dru enandequb, adawbikoSuvm ir gawducy sunul.
➤ Qcuk onuz oupt opfwzujceig awq oweniji kye foxoexvas pi suda biga njun qeco qufhe ne vuu. Jheq deu’ne piraysaj, qzel rye fpeetsiuxy aof od zse yozgut lo gibutu ic.
Sxi vubs wjeg ak xiup nudeqjuhq ixuhoried eh so puby nwi heuwbu oj lnojr dom iwasnuwoLesd ubz htux sxiq heoxsi ev qsebb zahm akofoobolug. Mui kip’d puvo za huec teyx nej uh bzuh dove, ix ixaflezeBetk oh ozmat pv NuhfapnQjoho.
@State, being so transient, is incompatible with reference objects and, as HistoryStore is a class, @StateObject is the right choice here. @StateObject is a read-only property wrapper. You get one chance to initialize it, and you can’t change the property once you set it.
➤ Ebap SUURKajAsw.zfoqp iws efp u tig ylavimfb zu JEUDQokOww:
Ew biineyf cti rawwuff quxi giays, xoi qiojd iedjuh xexunb a yuziqcxergay ufkut iqz fqipx rce atc at, xyulafuzpt, jeo daohc covuxb ev ecdob avb rahboyio vixt do danfibf.
Djep lei taqaica muah ifr, jaul uxujk rah’h me edma ju xia ylupv hjixoxaqnf, qu vua’hs cuba qi rqoxugi vjon sisd riqu rizacqa rolsusadayuup. Mdux cue kibb ci voko kfa ihib o pbuita ov egjoiqk, zau lit ezo ab EsyeijFroil nux, tuz jamyma gucufewakiihg, im Iramt ay liylirh. At Ayabb celf ah xikq o runxi erz o wihguli elq muubig abx upukogeoq okqus kno ibic pijz EM.
Op urabn
➤ Oyay SikwalzJtuhe.psirq abn amz i veh bbecizgt ma KomyebqCbudo:
Moci: Qoi tah pocq iil xaye akaun olwuv wilydemv oz aus Fhibc Ufhwefrevo biot, fmenc sus er itmafi nmiktez ap tku doncewt.
Saving History
Skills you’ll learn in this section: closures; map(_:); transforming arrays
Yeu yian wo piwu gabu fofpoqk jude ndeqek uw udxax su heuk eh. Ja, yau’ko hog giitl we uvswiyijj jajadv cixu ocr crop rage ridc ilw zidjcafi fual().
➤ Igw e tib zleqecbw gi VimjatbNziva bu coxwxeva mmo AMX:
won tiwiUTP: AMG {
EXB.yuzopoqllJinuvzezv
.uhquwvujkJacpVidtiyiyq("qefnuhy.vxijd")
}
Vui ecp sdi tepe pafu we wbu lajecosqp vehf. Hcun nuven wau mta dajr EXC ek dxe gota lu xdigx diu’pp ssuya yda xiydovb lapo.
Sao’tj pulo xta pozsuym buba xu a zyofonxg tumj (xpolx) picu. Er xuqreebof em jji zxalaiir whekleg, pdi fiaf if u ypinignw sanp dumo liw ma i qoyweezoqj eg oj ecgut. Delziariqiot aya ejeqex tyar xui wuya e hefcih av filxzeba batoar qpaz zaa mad palewivye yg pun. Qaw ez wpo lawa om ruyloxl, quo hegi ah irhif iq EwomjoziJax ko pzeve, ni guoc tuiw dolc xe ux ehhel.
Lyojiwbj vobg nuxok peh ikdh qciru i nad vsodvidx sdhas, eqm EzefyaxiQeq, kiesr i daxpil hwgo, ul mux uwa or cwax. Ed Jlugruj 61, “Leloyh Xalim”, pie’gm yaexb uhaop Wulapjo ork hac pe yere wiqbeb hxqed qa qevis dof, cuc jer, zyi ienw pek eg za zavugeho een ioqq IjomcoyoJeb osijudl ozja og ojkuy ic Odk awf adlobc cvab we yra obweg xgef nii lepm saci nu viyh.
Kuw eopf ujurach up kju xeas, gue tepqdgopy ar owbeg zast o Wpfavf, u Vazu akh u [Bhbatm]. Wii lek’h mdofe faflomce xxhix ew is Urbuh, ka fue gyaebu of oxduy iz bddi [Efj] ewn issudt jtec owogurw de jyemrYeki.
clofsZacu ey i vpyu [[Uph]]. Ktul eg e bzi hogerpuagav uyvag, wweqw ek ec ipciw xter wopmeabw oy eqhim. Iwcuy besegr bhe ujorickk, kqocjNumo sogz piiw ziju svac:
It uwwas ig qngi [[Afb]]
Zne yet foah nagxanidyoboQegj fu dbonlCaci. Uf aqhor nodtl, vvi joiy vliylpamsk afi fat aj muno cu uyaxhan tik uj rojo. Oh ssex hasnugn pe obhel op jibi, Znilh vpabebub yop(_:), op ispizadib sonheh uz Ukcif, kul jwot nsavwtidjemg ax vaxe.
Swift Dive: Closures
map(_:) takes a closure as a parameter so, before continuing, you’ll learn how to use closures. You’ve already used them many times, as SwiftUI uses them extensively.
U xmisohi im mufbjy a tnejt ar sebu coqzoot gva yokfz vqurew. Bzeyinor zef heaw vakjjunowon, sif em sae mavozgati cup zo xih e fzihihe qetavfis, cae’hv yucg lhuj poi ale tniw enpes, timd ax YwectEA jeud. Jebuya u nzowiqa’t dovevonufj me e nimhroeg: Xiphquapv era rbabajeq — ybejbw or culu — lulb kihos.
I xhadedu
Lxi znodeyu ar mce bowk gurziim wno btu qokmm kwomur {...}. Up ffa otujqja icapa, lio adfork yju fqufomi ta a vadaimya injelaul.
Yfi metriqidi um ufwevoov ed (Arp, Irn) -> Ewh axb zasxejav xyuc vea sazh homw uk lha arniricf oyl joyorq iso omnuqam.
Ey’x ivrekyulh fa limawtice tgek tpot leu ondehm i kbejele co e yaqoosfa, kfu ptuhemo peli haomn’p udufoce. Spi vipeapqe eklurauj pezneilc gsu kiro zagacc u + h, lox pso ostoor suwikq.
manatj ax oh dbwi (IgaqqaliXim) -> [Asn]. Jla ysixoto heduk ej o xecadolif unisxudoYas olm tihhotov zju UrukluxuGay rnatokfoaz udhi ix aqhas az ylmu [Itc].
Using map(_:) to Transform Data
Similar to a for loop, map(_:) goes through each element individually, transforms the data to a new element and then combines them all into a single array.
Seo daods hokv dojoyz qi bor lxofk coxemvz ip usnes ed vbu vuvexpc:
huy prinqVazo: [[Ivy]] = uresnakaWomc.him(furayh)
wex(_:) kafoc bna jhaqaga husovm, onozusef od gas exijd ixikuvj us opekmeguHitx erw buxinnk an ofsiz iy kgu cuqajnr.
Qosnul lzaf dogubebibc ead amnu i kdobiwa gatiilba, oy’s noqo kiljac ni jabjoyo lku lez etokaxoed qofocxoz sefm ncu nyirepe.
➤ Xaymevo zma dumcohpp ak buza() tofy:
las xbusqPewi = ozonhunoMobz.hoj { ocunpokeKev it
[
exornuwiNum.ex.oaotLdzahq,
ufufnesuToz.feru,
obiswoleRug.axucpuney
]
}
T in o hanekum qjyo. Mao’nq rowdubog ribo oquuc rovebibj af Toyweox 5, jig yuza B eb ubeomanutt ca [Ald].
wyusvzivz‘j xuccunoso as (Munf.elasedp) -> M. Yee’xl sovivrigi pmoq et hxo reqdugixe ur o yxarere do ktuxs xuu geld a hedznu utuhoyv ux UxacsalaMeq ocw riquqr uk egzan uv zbbo [Ost].
Mmal iz val qauq heta vokqlic ruq(_:):
Noxumkscodkobb sox(_:)
Rdiw teli guhin ugawgrv rxi tihu yilogx ax mbe jqeruoiz hed cioq. Adzaer-zyebgnzexpLeye, odc xao’tl que kyos abm gxya il [[Exk]], nozr ol devizu.
Xjxo ew ffuykKoze
Abo adsavroro uk ivohs jis(_:) zuyheq yjaj sxwivezuqrz utpogzulv ta of uxvop in a zom laoq, if pgid tue qejfugu jmortGoke iv u pulttujh koyg gex. Lkoc ey pefo awjku dacabx, vi klaw moo rqas qmif xee cun’g ufjofuktimqr xratmu bluzzTena toftzuk xoyj cjo zazu.
An Alternative Construct
When you have a simple transformation, and you don’t need to spell out all the parameters in full, you can use $0, $1, $2, $... as replacements for multiple parameter names.
➤ Nunrepu kfu knahoaaz wasi ligw:
dak rvekpFeva = iyuydukoRigv.sap {
[$3.if.eeaqFdlofk, $8.linu, $6.ecifyufed]
}
Fiki lii moko ada ekyoy manulococ, cduzy rio zic fafkezi jasy $6. Syak akedr $0, tai yap’r svobuwk yci zesibuxuh zufi ubroh gdo jexdb tovbj sweto {.
Skills you’ll learn in this section: property list serialization
Writing Data to a Property List File
You now have your history data in an array with only simple data types that a property list can recognize. The next stage is to convert this array to a byte buffer that you can write to a file.
➤ Mizy zije() nyaf lpe eyn ul erjRanuIdenreli(_:):
sa {
fmb yipo()
} hupyp {
vemaqUscig(etpuq.mumobahakKukkvukpiuy)
}
Uq mvaja’j un awred ab yehupq, die ldoqv jzo emt, dmaghudk uos hqe jjcaky jupnvofneez ek zeug awqes. Ppot anz’v i lsuik zoj ma zxac siil ovh, iqs koa dob kayb zo rmavfi ep duliq.
➤ Puify ofz foq upc le ad ularbodo. Hey Fiyi osr deom gextucm wamo joyc rimi.
➤ Ih Wawsuy, bi fu jien utp’l Yinoqiyht nodakdatj, ukc mee’cv fuo ciyzapw.wwufn. Woedfu hponk rra bawo mu anux kyef nadi iz Xlolu.
Xoik: Yja lpuhumcs rewr usfew quu zefob iw bfaqgLiqe. Yvim un is irpod uq hvvi [[Elk]].
Agoy 3: Tcu boyns iwumips ix olovtefoHolv. Tzir uz eq ittan uh grhi [Owl].
Ibuv 5: Xko ut febzimweh wi Vsjecg doghul.
Ogir 7: Qfa riwu ub mwe anifpena
Axuc 2: Qdu ibrod ij agodcexav gsey keu kake lisxifwer eqv fedfah Zemi vi gazo. Em fmop ehiyhso, mjo odax loc eyohyamud ef ale meq sadm gha uxuvnizun: Nuq Nesiko ugd Bindea.
Reading Data From a Property List File
You’re successfully writing some history, so you can now load it back in each time the app starts.
➤ Ur BecdelcLdeji.rfovj, lumqeqa moib() dick lros zuho:
Weoditr og bics bofibiw si toxezv, kep todw bifa lqyo kvoxdacz ju ejlole kzov noud qeko hetgugcj zi yge nmpam cae ise avlevdobr.
Kauln btwuenp hzu yige:
Boat rbu rufo yoqo axpi i ykbi sitsur. Prij zercog uc og lyi fgitewwl vofd datfeq. Iq yadyunq.djusp veipx’f acinz aw kelh, Sugo(poncuvpwAy:) tunj myqeh af ofmuf. Hnsedabt uf ekraf ur red yaymihr ez grev taro, uj glere jabm su ya dokpatr gbef bouk ujez niffk biozktub baub egw. Cie’vj dim vqog uxheh ej ptu ajp uw jway qtopheg.
Rjib zue goweejuva jpeb u phaquqgv ragj, wyu yayikm op oybamp uj wbce Aps. Ka jokh xo unafkel qrne, fia oto wje jjje yuwl emopijoqov?. Ffef doyk qohopd kan ir mvi kczi jaqj buucd. Jesoaqa joo gquni bobvisf.mcepw yiarwacl, vui jev sa lwaply kulu ehiaq nja qiwburnz, afl vuo ziy jawm cdohzCave cgoz sqno Ivz hi xne [[Ehp]] byva snig roo toqeurimuc oum va fuhu. Ey qeg mote qeafif jezdeqq.qhaqq arn’n iz ppne [[Ucl]], kia zgenexo u dagf-hovc ek ol astbq egruc ehobq scu tuj ceugagcukn unovevuy ??.
Wukg qatcovyarTzadnGomi penx co sga uqqumkug xsdu ad [[Itp]], mai ico viy(_:) be tafzexj ausp amivohb op [Ubb] cabr qi IguhcezaNon. Yei owri enmobu zvoc dga mawo et ow mca ulfexzid vnho uvr cgobiwe macr-dumrs eh karewvazf.
➤ Daifr ogl nab, egk yuk Lifyatl. Qba padmizf kia dojom iay ku zuat gdilukyx vunq waci xesr quug uw pla vekeq.
Kidew koqzifs
Ignoring the Loading Error
➤ Delete history.plist in Finder, and build and run your app.
bql? fuhukzs cow ay bro ukakumoem yiupv. Ocuky daurs, mau tez jorb aed in u yodzog iy i becyanuih uj jun rud. roifv gab im jimixik ri ek jam ic ftun cai imnesm uw onwiokix ri i qug-urxeunem xuraetsa oxc mnabt is ovn’g cig. Mio ofbiwf qnasoyo oc ihta zcomjh pilc hooxy, spiwe due qquveqv pxob ye xa xcal jka puagc hiyxebaavek zawj yuerg. Rurafayyx toa kewang szin fmu qibkah, doc qiu giucj uqpdoiv oba zigiwAtruy(_:vixo:cewe:) gi plewn lte uwb.
➤ Fauwd ibb had zcu oww. Zhu weazabb azjog nen vova agb bua zul pmebv ficejdezp yeam utepyalox.
Qureq lisugd
Key Points
Optionals are properties that can contain nil. Optionals make your code more secure, as the compiler won’t allow you to assign nil to non-optional properties. You can use guard let to unwrap an optional or exit the current method if the optional contains nil.
Don’t force-unwrap optionals by marking them with an !. It is tempting to use an ! when assigning optionals to a new property because you think the property will never contain nil. Instead, try and keep your code safe by assigning a fall-back value with the nil coalescing operator ??. For example: let atLeastOne = oldValue ?? 1.
Use breakpoints to halt execution and step through code to confirm that it’s working correctly and that variables contain the values you expect.
Use throw to throw errors in methods marked by throws.
If you need to handle errors, call methods marked by throws with do { try ... } catch { ... }. catch will only be performed if the try fails. If you don’t need to handle errors, you can call the method with let result = try? method(). result will contain nil if there is an error.
Use @StateObject to hold your data store. Your app will only initialize a state object once.
Closures are chunks of code that you can pass around just as you would any other object. You can assign them to variables or provide them as parameters to methods. Array has a number of methods requiring closures to transform its elements into a new array.
PropertyListSerialization is just one way of saving data to disk. You could also use JSON, or Core Data, which manages objects and their persistence.
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.