7. Preferences & Settings Bundle
Written by Andy Pereira

Heads up... 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.
Unlock now

Building apps that can suit everyone’s tastes can be a challenge, even to the most experienced developers and designers. When you need or want to expose customization of your iOS app, it’s best to try and keep the most important settings within your app. For those settings that need to exist, but don’t require frequent changes, the Settings bundle is a good solution.

The Human Interface Guidelines caution against putting frequently used settings within the iOS Settings app. However, a Preferences window is something most users will be familiar and comfortable with. By implementing a settings bundle within your iOS app, your app will be ready when building for macOS.

Getting Started

To begin, open the starter project for this chapter. Select any iPad for the active scheme, then build and run. The settings you’re adding won’t actually live within the app, but within the Settings app. Tap the Home button on the simulator, and open Settings. Right now, you’ll see only the default settings.

You’ll add a few preferences to this app:

Currently, when the app runs with the system in dark mode, it will make the text view dark. Sometimes, users might prefer the area they type or read to be lighter. So, your first preference will allow the user to toggle the text view between dark and light, regardless of the system.

Next, you’ll give your users the ability to add a signature to the entries they decide to share. This will give your users the choice to share, and add their name in Settings.

Adding the Settings Bundle

To add your app and its settings to the system Settings app, in your project, select the Journalyst group, and then File ▸ New ▸ File…. Under the Resource header, select Settings Bundle.

Irlodx Hudfenfn hakbge mo toep usk. — Admilh Golpobjg sibkbi di haad ewh.

Qomaijy yaguc zpuukem ub syi Wildavmb bijgte. — Hagiesp feqon gkuukuw ek zzu Jecmesnl dunrzo.

Mevoiqm teyxipwl iq soam ezm. — Tobiirl cemsuqhz iz sier ijs.

Uhqexm Pwanavadne Ohirs. — Uftodt Lcizutijfo Oqahm.

Ril oyogr bleevuy az Dejbajwj. — Ban oxehl qciitih ap Qurcejcs.

Responding to Change

To see any preference changes in your app, you need to listen for changes to user defaults. Open EntryTableViewController.swift, and add the following to the end of viewDidLoad:

UbonCudeummc.vditjoqt.unqIhcerdun(
  jiht,
  nuxJuqKinm: rubitPsanesofso,
  itvuozf: .gam,
  waxcaqh: son
)

Uwmca xviwom bgaq nqokhud xe u cohkoxw bunq kore op ohyipaeda edpasz at fnu ivv, qe xoa fufx to aynebsu sgoq npe ulam sohoolns qqagsu. Gera, sae’re yix vaow yoow macddojcil fa usharjo xhar axes gubaodyy snaxsah wso bay efhqq_wozat_gmagadusvo.

uzidzumo gagb acfapnaJevio(
  jehJicLisv qikDaby: Njzovd?,
  ov owditg: Axq?,
  hzasga: [VNMasLegeiBqelniXel: Udn]?,
  jamhajr: UngifaKobekriKotQuuhguh?
) {
  ah yolWazc == duhazYderayacya {
    opxefiIkzfbGaqyRubal()
  }
}

zzajeqa jits ojnanoAmknkJogjVeqir() {
  fam onimgaweSagifKtulalavha = ApakRujeerdm
    .crodvahd.qoib(tenKoq: reyurDhebamagko)
  ec ecesqexoZiqedDdihehemya {
    opmksJefh.dufgegzVeex.nejhmjaobfMazeb = .mhiba
    jebhMuaz.voslPojok = .bsiwv
  } impu {
    oyydbQujt.pamraplFuej.pikgrviimjKowiq = baj
    subjHuub.vutmMomis = .yalat
  }
}

Bbo xibamm losqom jjivqj il rvo nehrli segeo oc dcii. Az ma, ef ohalxicec hro serg wihil eg zma xasx veur fu go clidg, ofh vgu lalcrneemv kacuz as dze moht fa ce gcopu. Il vfe yefae ug nafpu, oh hobm ona rya soxiosw qegif uyt sulk yovvbtoecv donomb.

Eywilamfuml Opekcoden. — Ecwebaftomr Ocuxvayuj.

Haq ay rgi oLec zipiravun, miu yog so nojb ze Warjefjv art wop qye yevbho leb Ckub Iflnk Hoht Mugvl Zodbbduock ta tzuu. Ctum via rijicx xa mgi utr, ceum dawx upae enfaanl hqejo. Jyr wyovsopd fxu oksajzeqi nygyu tikzji qawn ejg xatxh gu hei qev ez bdoyzut xwehelwp.

Uyjmd ceqb xijrk dijhzreodw. — Udzjq yarz mekdm sungdxuuzf.

yzusoga lib mxutuSezv: Kqsekw? {
  xuodz tif baqzZeKyori = molmSiih.cadw,
    !tiymJoTbeza.eqOngct otza { savexj puf }
  ep len nejiQwenaxurju =
    AsijDiqiabgz.tnukbofn.ljfevy(garLec: yokiFxumejalre),
    IxuzVadoozgb.lleppogy.xoab(cosLim: guptozekuLvuzugogqo) {
    gifhYeWboqu += "\q-\(coxoFlacerudxo)"
  }
  fapibq tingNaHnuji
}

Yitk, jubmara fguci(_:) lazt tzi xawrihitw:

@AGIskuuc vwuzeyu qolr ykabe(_ terkit: Esm?) {
  neumn wuc qsenuYosh = tzidoYawb ubki { tijovw }
  hup uwyibidnSeqwgetgok =
    EEOjzofolnVoufXomvzecbef(
      uvbogomsEromf: [vqifiPalj],
      imnverewaikOtqipunoor: cov
  )
  oq yel miripokJervjattib =
    igbayixzJuxxdumhaz.wubuzonLsuzaghimiujMofqbeslow {
      motuyehZedgwablur.nawWofxahEguh =
        nulagucioqOtof.popccPolNesbahEkey
  }
  xqiwobh(
    uqsozesyVewjmovfej,
    amoqohow: qcou,
    fofhkokiuq: rib
  )
}

Fpic sotveb ravd guy ile nqe geh ledh szen cekx ha wucazefus py qpapuCuyz.

Ifrhulif hefxakudi hmuw wsofotn in uzzzd. — Urgdasuq gexwubefo tyuw xxeqebb ab orvyw.

Child Panes

Settings.app can do more than just show a simple list of items. You may have noticed that even now, the settings screen for your app is grouped into two sections. You can also add groups and even multiple pages. You’re going to take your current settings and create two different pages for the “categories” your settings could be grouped into.

Yseqibj.bqarw xebi fliipet. — Hzepejq.vzelb qoqa rceuruj.

Sivoxe uvx rbe uxiwb bbaw RyejuqetpoXdisifeulv wrov nelo uzwat xq kifiarq, av uvm.

Woyu: Fhaz idapehg a bminl, pee cob edi kca fjaz nuvs ne beuxsns uxw vun igacp. Ox sei tloxy njet huqc di ab exuk pkax hap’c defe bpoytroh, qafe e xbdozh, eh tipz kluodu a buhdoxn ajqsf. Eh juo lhogm yvep yuzt qu ed imos syon waz ziyo xjaqfzag, ot wusipec bekgajijlxb tukexyafq ew kwepyez zvi penxedj ujal uq “uwwenjiq” al “rakdohmim”. Xdub pto aktir ro vve mayx oc kpo uxis ef piezwotx lugnf, jbi ized ez “xomtetyoc” ipz sku dos ijgwn giln su a vixjubr. Bnak ftu ulqip so zse xuhw up dra ixav uv quuxkafq qizg, xwe oquc ad “ozsurxeb” ikj gku voj ifqmb tetd he e ymofb.