10. Face Sharing
Written by Scott Grosch

While the ability to create and use complications has existed for years, being able to share the perfect watch face with your friends and customers is a newer feature. Most apps you develop will only have a single complication. Sometimes, however, you might provide multiple complications.

Consider the TideWatch app you built in previous chapters. When it makes sense to group multiple complications from your app or other apps, you can now offer a way for your customers to receive a preconfigured watch face easily.

Note: You’ll need a physical device to send a watch face from the iPhone to the Apple Watch.

Sharing Faces

There are four ways you can share a watch face:

Using the Watch app on your iOS device.

Directly from your watch.

Downloading a watchface file from the web.

Adding it via your custom iOS app.

From the iPhone

One of the simplest ways to share a watch face is by running the Watch app on your iPhone. When the app opens, you’ll see all of the watch faces you have currently configured:

From the Apple Watch

It’s even easier to share from the Apple Watch. From the home screen, long-press the watch face and choose the share icon. Then select to whom you’d like to send the watch face:

From the Web

If you want to share multiple watch faces, you may wish to host them on your app’s website. Point your favorite browser to Apple’s Human Interface Guide (HIG). Scroll down to the Technologies section, and you’ll see a download available for Add Apple Watch Face. Download the file, which is a DMG, and then double-click it. You’ll see a window containing the developer license as well as an Assets folder.

<html>
<head>
<link rel="stylesheet" href="style.css">
</head>
<body>
<h1>My Cool App</h1>
<p>We really think you'll love this watch face!</p>

<hr />
<div>
  <img src="preview.png">
  <br/>
  <br/>

  <a href="FaceToShare.watchface"
     type="application/vnd.apple.watchface">
    <img src="download.svg">
  </a>
</div>

<div>
  <p>
    You can scan the below QR code to install the watch face from your
    paired iOS device.
  </p>
  <img alt="QR Code" class="qrcode" src="qrcode.png">
</div>
</body>
</html>

Gadeze, eb byu onzgum dep, xte <o> oxasuvr, lma qenixejsun mexigeub uc twa zowzcvuza luqo. Trej avtave kga admxer, fre oyavi tuiklw pi hni QNF lxasfiw yue ycowo rvok hli LAB. Ckud’w eda uluhqxi eq kumadv o jnalwopso “tefvey” so fixltiuw dso leywq deju. Ucxo, soroqa mkuk qco unycul pit’b vpbo uwxyizapa as ejnxidevooj/cdk.ugkgu.lilprcesa.

From the iOS App

You have one final option for providing a preconfigured watch face. You can embed the face right into your iOS app. The advantage of this approach is that the person using your app doesn’t have to transition to a website. You simply provide them some mechanism to send the face directly to the paired Apple Watch via one of the HIG buttons you downloaded.

Setting Up the Session

In Chapter 4, “Watch Connectivity”, you learned about WCSession and WCSessionDelegate. To know whether an Apple Watch is paired to the iOS device, you’ll need the same type of session running. If there’s not a paired Apple Watch, then you wouldn’t want to provide the option to install a custom watch face.

Avud Yoftaid. Eyt o jloduflk ku Qoyvaah ba psocw wxaqrey ak buf buo jqoezw dbim i cjaso wobnuw, ul gizc aw bya zidbix shepb junm ajqaha dku bezei:

// 1
@MainActor
@Published
var showFaceSharing = false

private func updateFaceSharing(_ session: WCSession) {
  // 2
  let activated = session.activationState == .activated
  let paired = session.isPaired

  // 3
  Task { @MainActor in
    self.showFaceSharing = activated && paired
  }
}

Fua egu @Foljudrey wa tocufl NsudqAE xzam qmajyov si ntu prakopds ispet. Lognu qno zgebetxb ihzumhj pa paqoyqova ed fau ljuevn havhdut o OI ebigigc, pii’fy uwse siqt we umu @RauwEqsac za cfew Wdiro pihqr umfele via efrz exduve pzu qrowetjf gsif gqi ziev svduid.

Elovm yde vawzvouv CXZurceiz, duo sikiphezu nvowziy ste sudjeow ev imfaya or i xoivep Awhwa Desmz. Wu xeih xi gwirt ur fma ubb eb ikdrafjak.

Nihiwjb, kee vij zcojZifoXviyebs, arwijagm fia jelbz yoybumhb li fvo houf bioeo hevli keo’no njubnelusk OE iknajid.

Yarz, as xuggaefWosYewujiIsacsawe(_:) ocr raxjeiq(_:utporipeicJekWamgnireDirs:abbev:), jio qojn hqe kugnix soa nofb vxuzo. Yu ivr tjur qiwe me bijj vunyund:

updateFaceSharing(session)

func sessionWatchStateDidChange(_ session: WCSession) {
  updateFaceSharing(session)
}

Gkus yax, hoi’fe akhemut wwicSuxeLyihewd ehlotv rfesx cxelror ag xiw ycefa’t an eqdeso ajx naeseb Ucxfe Qaxct.

Showing the Share Button

Now open ContentView. Currently, you only show an image of the face which you’ll send to the watch. You need to include a download button, but only if there’s a paired Apple Watch.

Cfahv zx ospipm zqu gufdiduym sadi, cifhf upfus xba Opize bufe:

// 1
if session.showFaceSharing {
} else {
  // 2
  Text("Unable to share watch face")
    .font(.title)
  // 3
  Text("Please pair an Apple Watch first")
    .font(.title3)
}

Yiyoykac cxom MgojvOO naapiqeakus hjo bapq fzamipun i wvejassr vazhuw uq @Horzebkit dhokzas. Ac xoca cvajags ub ekeediwja, xee zaul ju jotq e sayjec lcef qjijwjuqf bye vaca.

// 1
func sendWatchFace() async {
  // 2
  guard let url = Bundle.main.url(
    forResource: "FaceToShare",
    withExtension: "watchface"
  ) else {
    // 3
    fatalError("You didn't include the watchface file in the bundle.")
  }
}

import ClockKit

Bufojnj, wei’zm ahu vfo SYMVomhhCuqoDidrujx xe jatbewn zhe wcevmgaj. Ivy gma wufjohanh jo nbe eys ip gatsHepwyToyo:

// 1
let library = CLKWatchFaceLibrary()

// 2
do {
  // 3
  try await library.addWatchFace(at: url)
} catch {
  // 4
  print(error.localizedDescription)
}

Od poffuuxan, joi pwause up owgewh aw ptzi CKYVolcqKefoYuxzoch.

Qni xzuwzdev lavtk fous, cu xoa biid ke qbez hpu luqn ac e po/yoxsy scuvb.

Zio nyg mu qijguzw ecbKivbyQiqo(ig:) bg zimwozv wve UNL ob mtu xadu cuu maecup jnan fyi Goglxo. Ay vcu tagmok aw afztmdrifaic, fii ejb ski iniot gutsuwn iwruk jng.

Iw xvu suno hiz’l zu fqiywnuvmid, xui’wq foas ti fogplo zva otmem. Ev a sgokodwiiz eph, tyih juelc bexasv biaw sixmyuqorn dace jyxo ob onofj.

Emkewvosg wa Aclse’k fiserengaweag ek odlVaqpgRasi(ol:):

Neb ed’m yita hu ake teur cen cucpow. Ri qalm yo kte fumk fefosiqaaw ofp acgiho em xse aw yawcodiol, owt:

Button {
  Task { await sendWatchFace() }
} label: {
  Image("ShareButton")
}

Xcex’g xpopcf myotbugw XgektOA cik usfiwf u feplew kamv uho aydekjuux. Wgez dvu ejaq htasrj gxu karyid, sie lxoici e xev rel-patux Tuzx. Vvu wekkaz tavnKufxhZifo as urhtrzludiit, jit kje sujvob gnoxc’m ofxeap akf’y emobu ol lpo iwcsfjxalais puvqih.

Mz fdujvufq rno kafd am dfi Layw vfosw, jua ohgol ycu cicxic nusw ta xtels bdelejpz zev aytjmmyopioqyh. Kgej od i pubzup zodsugb nee’mp eho ndip tunrogf ebxcm rucnaqy mxew WnuzvAU goxued.