Instance Method

url​Session​Did​Finish​Events(for​Background​URLSession:​)

Tells the delegate that all messages enqueued for a session have been delivered.

Declaration

optional func urlSessionDidFinishEvents(forBackgroundURLSession session: URLSession)

Parameters

session

The session that no longer has any outstanding requests.

Discussion

In iOS, when a background transfer completes or requires credentials, if your app is no longer running, your app is automatically relaunched in the background, and the app’s UIApplication​Delegate is sent an application(_:​handle​Events​For​Background​URLSession:​completion​Handler:​) message. This call contains the identifier of the session that caused your app to be launched. Your app should then store that completion handler before creating a background configuration object with the same identifier, and creating a session with that configuration. The newly created session is automatically reassociated with ongoing background activity.

When your app later receives a URLSession​Did​Finish​Events​For​Background​URLSession:​ message, this indicates that all messages previously enqueued for this session have been delivered, and that it is now safe to invoke the previously stored completion handler or to begin any internal updates that may result in invoking the completion handler.