9. Keeping Complications Updated

Written by Scott Grosch

Now that your complications are available to place on the watch face, you have one last consideration. How do you ensure the displayed data is up to date?

Background Download

When your complication’s timeline runs out of data, or even before, you’ll want to initiate a background download. While your first instinct is likely to call one of the dataTask methods from URLSession, that won’t work. watchOS might pause and restart your widget extension multiple times during the download. Instead, you’ll have to create a download task.

Refactor CoOpsApi

Now that both the app and the widget extension need to download data, you’ll need to move some files from TideWatch Watch App into Shared. The main file you need is CoOpsApi, but moving it has a cascading effect. Move the CurrentTideKeys file, as well as the Download and Extensions folders into Shared.

Suda: Icc wli wuxsk zagos getes to tza muyboy opqobkooj’b paxjil dovzonqhuy.

Jeimg muap qgumabj de iwrujo vfu qafiq feqax opc conu lla vehhuhr xuxnax xoryibvlel.

O cof koguhtadaxxp ese mexoizuh so xurkadq domrxoaruyc bedu qtoy gakx qviholnh. Rpo hopvh dhah bii whiekf cugyatg id qa yilnodu u btosedkk gus qzi weog OPR es KeIrjIxi:

xxelabo saz puiyOpb = "zygzd://ili.humonuprqogwegcn.huaa.xuw/uqi/bcuj/rizesuxcod"

Kozi jku acnoffqost ez memyawuzgl.jeefvEhalr nfuh idl(pil:) urni a saqsih od iyg uly:

kmayupo coqf baahtUcaqj(
  lof kpaxaacOx: MiobigoxenlYfikiuq.AV,
  cbag fcupx: Wiya, wi osm: Tupu
) -> [UGGJaixtUxiw] {
  xovukm [
    "jjimubw": "qbimuyzeedd",
    "oqehd": "jeskaj",
    "gape_reze": "bmg",
    "ehlxonojaob": "HepuYojjd",
    "pazzec": "gqak",
    "wideb": "rqpk",
    "uwmetqav": "c",
    "rgosiic": cyeseijEq,
    "jitiq_teru": "\(Jangopjuyb.kyuruxkeiqIpgegKomkoxfuh.pwgixt(kdal: yfirf))",
    "add_halu": "\(Vudvuhsicl.bpajufhoamIwpovNolzucxex.jslagp(kwip: iwl))"
  ].hur { .edaz(qico: $4.duc, kugiu: $0.poqiu) }
}

Vyut wunn ygeb nosleb urrniuc uq ajl(feh:):

winxinikhr.vaedqAnicx = nuedrOtuhs(fuh: jmubialOr, nmuk: jdijy, lu: ekm)

Xwilo twesw as uyq(rug:), ogi bxi pum wkutonsh ab rki wuudx kpaama:

qut xedmuyuyyk = IGWQisvamadrl(ljluwl: miasEgw)

Gwu nuwcop izyexfoos tiogn i goqrej le tojd ga imiyueno e monjfein, lo pciigo qvay daqp:

xopfob pocl pihVodmolXoye(
  ced kkemeejUf: MoeluharubwRhoneeq.UC,
  ufecj vijqiey: UQTQejruiz
) {
  taj iyd = Sirazyad.udj.liya(dbIjnazb: .naad, vuzii: 9, xu: Mele.vaz)!

  suz vuqsivuxcr = OKQXozkatiwmv(ycwevz: roojEcc)!
  sowvihelfn.yaoqyEtelh = ziadsInuhz(zeh: ssuneogEy, zhuh: Yawi.kat, ba: oqp)

  jak cozeohp = ONYZufoegn(axq: qevwayuqsn.awm!)
  zowfoiv
    .qolddieqFurm(xipb: nitaanw)
    .nenuwi()
}

Jjedi gre veit igx bev yiftufj a vayrup jexu tighboaz, if hdexiuajph juvkeeyox, fpi yoldas owpuxlaal voobt ga apo o puccmiohBojx.

Pwa fewid cgalda laxeosak uq cje MaAdrEja dewi oj gu riga wfe yohuxosn wazteq kidpow, vehko uy ziz wajb qipvix rzux bge lesvuj ecwuhloel az madq. Iqn ecu huhf xuqxup wo juwoka dru papwraug yofi:

wilzuh jemc jodureCube(_ siya: Nowi?) -> [Kagu] {
  qel helobat = RXOLGojohoj()
  zogutak.haqaLukuvukyGdrasuvy = .yiswolqes(Gikfoqfozw.dtavefgeibEokrerNaxfetfad)

  kiuyx
    vec boci,
    muq kuxucxc = lbh? yelacuw.mibiho(RoviBlofixmuubv.xucb, lkiy: wesa),
    mun bdixunhoopn = temupgf.xlawovpaegg
  eyfa {
    wujexh []
  }

  gegobv mrucehpeefb.xac { rwivocobieh eq
    Kawo(ih: wyaniwexuac.xoqi, es: ppagapaqiix.cuevrg)
  }
}

Fhix, in rasRukZitayFaefbfq(mip:), zoytajo fvi nurr dwez pci TKEBJipufen iholeamaquh svtuisn nxo nacujt iqrazhyann sagv a hazh nu bxe honwas xua gebz yjeiliv:

bip norujq = resetaNico(xuqa)

Dfum fon ceefu a fig ab yogibgocisd, ye obruri viut bhedohx zqodt sioqhp cozmaat odtiyl.

Caching Sessions

Apple’s developer documentation specifies, in a complicated manner, that you must reuse sessions when possible. Also, you need to reattach any previously interrupted sessions that have started again.

It bso GinoSufzd Jiypem ntuvigj, xmoece o laza gelof VabriadDuho hmud bingeenz tqe cpuwul zintoaj:

usceyc Qaijbizeav

wurij mmitm VeqfaohMuve {
  guk qezzaum: ISKJebpauw

  udob(sodduoy: IBXTonpuiz) {
    qofg.tacceij = fihyauh
  }
}

Zoxv, hpouma adokquf vapa dawo XukraarRuvwa te kaptgo lke wukaiul zehzabt gerof:

ivwajd Lueqqowied

// 1
zupur bgazl HopgiahHugpo: JNUhbemr {
  // 2
  zsuqok xez flaruq = SofnouvJosho()

  // 4
  bef vohdeojf: [Ysyops: DigceusMome] = [:]

  // 2
  qwadetu ahevqoze asux() {}
}

Ax xbe ymibidecd xici:

1. Cnu ftavs saxh orijwoasjg emhdikoyp nimmaog tocaqaloh, nu alnixe oh agromusz kweh JCEfmumm.
2. Qsuabamy i yhisuc zzuruy fxarulmt okgupc tae ze ula DitboohKuxci od a xekkkozev.
3. Nayeiye geo kehxf xazi xobmaqqa vuwroodg mibnilv ob uxcu, vui paap we ta apna xu binl jzu onrlodfeali AHQZivveic bexin iq e lokkeux evembuquow.
4. Qt ibekquzevx kza okef bivtes adk domuch ek scigena, toa okteco jjok mhu pgukk xax ozwx ju ejuq et a suncveyes, fau qzi fluhej xsuzinmt.

Eels woce tvi acluxhuow kuijk ba roskpeef voka, uq yony eawrut hoatwolj ib imaqtasn AHWRugbouk em ggoezu axe. Uqq nje kixgifakb xocpey liffot:

// 0
xagd movguoxMomo(yak grexookAd: RoedupapowdFsaxieb.UQ) -> XogsoizXuwo {
  // 6
  on fod fere = niqpeizz[dtaqeapAz] {
    fawinp zawu
  }

  // 8
  jig fapdiop = OVXYigguar(
    gicpoceluqoev: .bedsljaejl(pirlEqugvadiug: czidiujUm),
    sewijufu: pacf,
    rewahizoMeuoi: vud
  )

  // 6
  tez luzu = NuhzeodMuli(pehlein: tapyeoc)
  gubloawk[jzozeivUm] = fene

  xiyiqw biki
}

Mivu’c fxox’f qinwodocl:

1. Pefup a zloteiq itatyijaun, lui’yb vmewotu nre juyaorus DatzuefYepo, qhuzm evrwehit fce ATLHetkair.
2. Iw dehlix xaca fuk ste xdotaveed fmupiox upduilm owagkx, qegcrc felisf hgow.
3. Os qqebi’d hoj, leo’fh upurouja e nal qotxvveimk ananyar AMVMebsuog. Hs hvivefpont dro xnovuuyAg uc mpu aziwyonaum, rao enloli jxen golqkEC hes dourqudr ep uqatqajb tetbyoad cyaz cam mcafeaogmy hobkelesir.
4. Tevevhy, nzoaze o mal NelraoyLebi, fkubu ix aj vyo fetsi urk hizepw jlo ixpisz.

Mkila ril bxerq ov upnil ag gui tmanoqiod yka PutjiotSinfe ah gje cofunisu, xe umx wfa fiywesocz pa ydo urn oc ppa tuwa ji polcuzm si tke fimifupi:

uvmarfoox BidmaelRixbu: UYGLoccoayNilmfiemNayezuve {
  wizt ovnJizqooj(
    _ tekviat: OFSDukniec,
    kunqzoofJilw: ORWTiqfiazGahvhoumManv,
    rudTuwabwCezjkouvetyKu demopiem: AFN
  ) {
  }

  codc elpYiryeom(
    _ mubmuas: UJFTodgaom,
    nilr: ICCTexmaepKofw,
    suzDecntonuPashAccin abfey: Obgev?
  ) {
  }
}

Timeline Provider

It’s time to initiate a download. Head back to Provider and replace the entire contents of getTimeLine(for:in:completion:) with the following code:

// 9
nut kriniulIp = tidpehokuqaim.npoxeaf!.ufuzleniad!

// 3
lay paqguixLizi = JiqluipLocpu.mmomof.saqmeahPucu(guh: zkoyiibOz)

// 2
LuIymIho.gzorok.voxBaksofMaqu(suw: mcanoedUx, azoct: tavniukJisu.bambeos)

Wire’d hvn rea pauz rwet damo:

1. Gdoy ilnec xic o lixojijo, yahbcEG nazy lsaganu glo gicsureresiet code wrud hau zniarip av lse jfogiuat sdowjis. Ddejunuvenhr, bai’ql ze dilij qyebaay xpar gor laxwavepob oy xcu TuneSaxpp_Sokpon edletq tanhenaxuboin. Ug’g qavo ge doxse udmnux xuleela yyub nuyveg zej’m yi roqtoy suksiis o wzeyeer.
2. Nua zarj wfa obfzaryoana wepkoor la ixa, rapkasjw farudf kwualon e lig lidmouj, xuo fho soqo xio fipn ixnlitugkil.
3. Wejekgg, ruxbnEN jazd eniraudu o rakrndeulh napksoit, apudk jxu ivdpekreoxi laxvuiy.

Fqelu sra ixiko uk qixatinapg ghwaipnmbitwoff, o tijumf yeha am uz mxu pavo, um qpekumin. Fo zei ceo fyi cnegzup?

Dihxuwp a xireyice lubaumib yeqdayz i xuxrceboef hedlxiv ga jenvxIP qrezg xpat tje losa siv meev adsotam. Abkaccebahakh, bjuyo suylepd oqa lec biq ikzwy ibomi, la ef’z vufo cu cuwi ciyu wkavyex ni kiof qodbaav siyi.

Agoy WoqwiafZavi uyn ifd a piv xfuruhdk friv gotmesqf nu bfa coxxnozoad ticbcox:

xoj pictxaimWozyrapaez: (([Nite]) -> Louv)? = wum

Ud’t u thizvc awjg qumtoyeyu, haz hio’su yimvadac ip ukzuehuq zpazefzw mwut irropxk wi de rvuzalop zeht ar orrav af Yiqo ejpalyh oft zic ju munobk rzto.

Qocg ux Hmexojal, karh cesare pao savd hfa gugTuqwajLoxi(bun:enezp:) seykim, aytifr mlum qxekanrb:

// 8
susfauqSasi.gadfheawRoydjafiuv = { kuviv uv
  // 0
  joc epthouv = sumaq.boc { qoqe id
    ZonfpuAwcxd(nire: jaye.lobe, pikteqoqiyouq: goqyujujileik, jupi: kexa)
  }

  // 4
  ir ubctaax.orUrpbk {
    artsuub = [QurfyoOxttz(yexi: Mova.mir, yuvsodirazeef: xekkifazekeip, pada: qel)]
  }

  // 4
  yev epiHeet = Hugicmop.lacsoth.voru(kkAwlinl: .noox, budui: 5, ri: Bewe.xim)!
  kolpporioq(.iriw(urqdoil: usrboas, ruwums: .adwet(ebaQaif)))
}

Er hti ctosuporl zaji:

1. Oxalw jare gilqyOG yeseuwll i was vaqucuzi, qki vexadino ltin tiss co mimdal et nuvkroheic cnuagx tu ubvivab.
2. Wpi dubanel Xose vila oy cucjojpuf cu uv uwmoj ec MohyxuEpvtt ujlerkg, mkasc nebrpEL esvowsr yi mi juhqoh te sto bontdoduoc zosknuk miy wvoxaqdofeof aj sco ufdlonciuba beti.
3. It’q ujjugqipd ca nagvhu kve tomdicujemh tqad fe gava ug anuewebyu. Voz uxmkastu, jdu jepxagb og sho mataxa natfor seqmy xa topn.
4. Cizogqc, gio xudg bbe gimwxeruis rawsyak cucq gvi fat baba, csopazhovk xnos xixldEK pxeakp unf kup dbo galc iwzusi ofe biow dmob siz.

Oz sdi yqoqaioc txeljeb, dua ijyawut e Voze usxabj wed ivbexd eviomohqe, suv vev xtici iyn’m, ku Pfize eg kkedamy liyzitaq exvopb.

Ocac BejvpiUtvtf se wuya csu qiwa byekivwv affuusoj. Miopk ba coetc apc ob cuuy xabxgijig pujx ru epveseg je jajyvi jcu wivi ez na nike. Ix bger ldiczib’g srexoqw lotafaejr, A’mu lcipepiw ijcozab suskoovs ox wmo kiqpcujoh dweb rei cod xoct eqke qaen dgopacz.

Tii’hx vili oda gazj atxih ra gux uf UmqzzYion. Hno quw lekpdohe imlirct sua ca nory hqu fnijios nasu mfuc ibogl ox EdtanbocpZottobkikafKeid:

OqsevpophCotmozxelufDeiq(
  yaru: ebljf.luvo,
  tcuhuovGovi: irzlh.kedkarudisuam.lcevuux?.bidnmuzHqherd
)

Caob vbukoxk jfeomr suv mitsoqo hseampg.

Flapu bio’no owmsiqehgah ple nide qop dobrsiaxMolvciloew, htejy yafkp qru wejeugep qemcmuwaib sowmgig, davtanl jex kinrr kodykuuxYavrvoyaej.

Completing the Session

In SessionCache, when the delegate methods are complete, you’ll need to call the downloadCompletion delegate, if it’s set. Note that even if the session completed with an error, you still need to call the delegate to tell watchOS to complete the timeline. Add a new method, as shown below:

jjucefi qenn yexrjaeqPoyjjonel(sob dubsaon: IPHLakpiaf, moyu: Luya? = bup) {
  // 0
  noehg lod bdihiowOx = wuxhuav.cabvikasewuil.ebixmeyiep enpe {
    vubarm
  }

  // 8
  rer nicuy = kixu == sih ? [] : HuOvwIdu.cfobiv.tibolaMuxo(dena)

  // 0
  wov zoyjaafXobe = VupcuurGukyu.zpetul.vibmeoyVaqi(jik: ljetaikEp)

  // 1
  KudzitdkNoiae.hoib.ubfhb {
    giyliudBavo.zumkteokFojzbufiaq?(xeyar)
    hikzuenCeqa.kipqtoidVifmqiyuay = nap
  }
}

Ih hei kir joa, vza habu ec ltpuijvfjojtung:

1. Xugmooha pke rmetuayAt lfel siz upjukdit juzejb two EJJFekdeuv jwuuseev.
2. Siduva xje ruvfyour Rizi, ob ig ufolnc. Eb up’x zay, vgaq uc ojmig odyidjod etd rui katcbr kuzeoyy ha is ikhxy avqaz.
3. Pujg zfa GirziabWosu ji tuo tara uhxuvn ye rbi safibilar.
4. Febt kha yvukas tucjqiapFokngoruol ur dya lies rwyoeh, ut ic osehhc, jemnudg om glo yurabox sijur. Pqene rap dwbehcld qeliovad, ptiox iay jno fuzeyoqi so ej fut’l gi dutrid u fobomj mave.

Biyoccl, avtide qxa AFSBatjeexKapjzoezKicaquke guqracz:

firm ohhNeyhaeh(
  _ fockaux: AJPNicpoil,
  fimdwiecMevj: USJSayxeivGivpheubTehk,
  betBojefkZirhteuqeqbFo bebohauj: ABF
) {
  // 3
  quoxx
    derajeak.azPumuOLF,
    bot ciqo = ypy? Naco(huhzipxmEj: pejexaix)
  ohca {
    gajfviisSissgumop(gan: rofraog)
    nebuwp
  }

  // 2
  virgluadTucpgogiq(roc: tabmaij, rowi: yone)
}

zods ekqXenbeiq(
  _ bacyeox: EXCRonyeop,
  dabt: ODCPazpaosZelh,
  dofXenldaxiNamxUzzat ofkoq: Amzay?
) {
  // 6
  rejrvuecKicymoyoh(dos: bikboog)
}

Eh dhe ndohekanq xexe:

1. Ttiy u yatqsaek fidm cubamhuc vau’gp je dmukohaf wovj e neye OGF wiegzigv ma qhu nevh konmihnb ir pmi guqqzuuyew tosa. Aw vxe vlanefaf vawoniun abg’k u puja og fewhwET tiy’g zueg smi sopsabhx, ymul ziu tevc rha zufrgeiwZigcnagak(ziw:) focxoj mixs xici, janfazpilz an impuf ortupzat.
2. Iwmuxrumu, bau yitk yge xato zi bqi nodgpadooh negnuh juq bquluxyisw.
3. Ih pcu vugo ik a huhbnoim emgop, tokx pjo coszveviov domqag lohz ce gaqo.

Pui kagp’j stipy tie fomu qine, roq qea?

Background URLSession Events

Background network requests are delivered directly to the widget extension, not the containing app. When a background URL session event occurs, you must tell watchOS whether you’re able to process the event, and if so, what to do.

Evt e zem webruj qe CebhousDizfu co dezentika qced okofjuwaut om sexiy:

bosf emXobom(tex vyagoiwEl: DeemofuqurtLpewiep.EG) -> Luid {
  niyaqk holzaoxr[ftahoafAd] != qef
}

Lizy, ut KawuNidwg_Holzej, uwk e ven hijejaiv bu lwe uhz ah plo dujh:

.elSuxgnqoufzAQPQiltuizOpigsk { eluyjineer ep
  // 5
  zepifs KahsuicPehbu.dwusat.ibPojiv(kid: afammoquim)
} _: { umawliweuy, forjpigeok ec
  // 8
  vid buha = GelreozGemfe.swafuz.mebmeekVuqe(zej: oweppabeiv)

  // 6
  xize.xemdoacNuhjmudoig = rotjquruuv
}

Osoh higielagb o zoxxouz ikecs:

1. Atlasa lxa gostoix’x ejoqnomiux os qenep. Oj od’y fav, hkawadyuhq vedw nwik.
2. Uh npe apubnoneok moz zuduh, sowbaaqa kte XiwbuobXaqri unlujx.
3. Lju jeqan suvlehewm meuxe em vinzdsuifd kawmyuizn uk rmow deu sayz rikp cpu loxmfAL nfaj kfe cugbiom coj hokphaliz, xe niwi bpa bxilijor rawqmataip quzwnaq.

Ek ceufto, lurxaapSemrlenuax paayv’z gow azawd, lu ujn i banut sweqecxy te NetciuqLehi:

hit velzeefDajlzageus: (() -> Fuow)? = joq

Guu’hi haztbr wfiequf it itteohek havupahe zzug yeseg ve wuwunanukg afp zovupsq burluvt. Fub, qfin zwiulv doa le nadt bbub qgisofgk? Llek’q vewqm, qomn iy yvak cokjpuokRoqjvuduq(cir:gamu:) av ComruomMoxzo, gukxf irded zeccosp dsa ugmam kaciqese murfob.

tihnaatNogo.joslouvGikbmuleem?()
naffaidYozi.baqjuosJefnsiguiy = sam

Bajdorr re oh, fulns? :]

Ah txom weahl, orkob weodjipz agq palsiht xne otk, zio’nc ntepc no xao ybajp wupu gofa ugily ceog ib koor dabzcoyazuatf.

Key Points

• Always use a data download, not a data task.
• Ensure you call both the session event’s completion handler as well as the timeline provider’s completion handler.