At this point, your app can reference the user info dictionary I mentioned earlier. After a face with your complication is added to a watch, your app will run and respond to a timeline request from ClockKit. This API is available in ClockKit on both watchOS and iOS. Call addWatchFace with the local URL to your preconfigured watch face file, and the customer will be prompted to add the face to their Apple Watch. To learn more, please check out the talk "Create Complications for Apple Watch." So this year, we've added new API to ClockKit that allows you to prompt a customer to add a watch face from within your app. For example, if a shared face included Dawn Patrol's complication, the user info dictionary could be used to specify which city's surf conditions are displayed. And if your complication takes advantage of user info dictionaries or user activities, those preferences can be included in a shared watch face.
Watch faces now support multiple complications from the same app. We have exciting new complication API in ClockKit this year. If the watch face has your complication, the file will include a sample entry so it can be previewed on the recipient's device even if your app's not installed. Watch face files contain all the face's configurations, including color, styles, photos and complications, anything you can configure on a watch. And Nike and Hermès watch faces can only be generated and added on respective hardware. It's also worth mentioning that some newer faces are not available on older watches. If your app's not available in the recipient's region, your complication won't be available on the watch face.
And if you include your complication in the watch face, the customer will be prompted to install your app when they add the face. With just a couple taps, the watch face you've configured can be on a customer's Apple Watch. So how can you as a developer take advantage of face sharing? Well, watch faces can be shared directly from your apps and hosted on Web sites. You'll be presented with a share sheet, where you can pick how you'd like to share your watch face. Then tap the familiar "share" icon in the upper right-hand corner. Just open the iOS Watch app and select a face. You can also share watch faces from your iPhone. They just tap the preview, and they'll be prompted to add the face to their watch. In Messages, you'll see an inline preview on your watch, and so will the recipient. Select a recipient, compose a message, and that's it. Watch faces can be shared directly from the watch by long-pressing on your face and tapping the new "share" button. Face sharing is exactly what you'd expect: the ability to share a watch face with anyone, configured just the way you like. Today, we'd like to talk about Apple Watch face sharing, a new feature in watchOS 7 and iOS 14.