Instance Method


Indicates that a requested update has begun so that you’ve an opportunity to extend or reload your timeline.


optional func requestedUpdateDidBegin()


When the date returned by the getNextRequestedUpdateDate(handler:) method of your data source passes, ClockKit begins a scheduled update of your complication. At the start of that update, it calls this method or the requestedUpdateBudgetExhausted() method to let you know that the requested update has begun. These methods are your opportunity to tell ClockKit whether or not you’ve new data to add to your timeline.

If you’ve new data for your timeline, your implementation of this method should call the reloadTimeline(for:) or extendTimeline(for:) method of the complication server. ClockKit doesn’t ask your data source for new timeline entries unless you call one of those methods. If you do nothing or don’t implement this method, ClockKit calls only the getNextRequestedUpdateDate(handler:) of your data source to fetch a new update time.

See Also

Deprecated Methods

func getNextRequestedUpdateDate(handler: (Date?) -> Void)

Gets the next time at which to update your complication.

func requestedUpdateBudgetExhausted()

Indicates that your complication’s time budget is exhausted.

func getPlaceholderTemplate(for: CLKComplication, withHandler: (CLKComplicationTemplate?) -> Void)

Gets a static template to display in the selection screen for your complication.