Nicolas Lauquin
Nicolas Lauquin

Reputation: 1537

NSURLSession background download - resume over network failure

After reading the Apple documentation about the background download with the new iOS7 api (NSURLSession), I'm a bit disappointed. I was sure that Apple was managing the pause/resume over the network availability in the background (or provide an option to do so) but no…

So reading the documentation, this is what we've got:

https://developer.apple.com/library/ios/documentation/cocoa/Conceptual/URLLoadingSystem/NSURLSessionConcepts/NSURLSessionConcepts.html

When any task completes, the NSURLSession object calls the delegate’s URLSession:task:didCompleteWithError: method with either an error object, or nil if the task completed successfully. If the task is a resumable download task, the NSError object’s userInfo dictionary contains a value for the NSURLSessionDownloadTaskResumeData key. Your app should use reachability APIs to determine when to retry, and should then call downloadTaskWithResumeData: or downloadTaskWithResumeData:completionHandler: to create a new download task to continue that download. Go to step 3 (creating and resuming task objects).

So far I understand the solution, but my question is: What architecture is the best to handle the loss of the network and resume downloading in the background?

On my side I'm using reachability and each time the network is available, I resume all tasks (referenced over a NSArray when creating), and suspends them when network is lost. This works well in foreground but for the background I need help on the following points:

How do I address these points? Have I missed something?

Upvotes: 20

Views: 14198

Answers (3)

gavdotnet
gavdotnet

Reputation: 2224

Implementing:

application:handleEventsForBackgroundURLSession:completionHandler:

in the app delegate - without calling the completionHandler - causes the app to hang around in the background after the device loses its connection whilst suspended. That way, the app can still listen to reachability notifications and restart the download when a network connection becomes available once again. However, this is a pretty dodgy approach and may not pass Apple's app store submission guidelines. Additionally, this approach isn't much help when the connection is lost while the app is in the foreground and the connection regained whilst the app is suspended.

In the end I did the following:

  • Made use of the application:handleEventsForBackgroundURLSession:completionHandler: notification to pause my downloads in the background.
  • Made use of the intermittent background fetch notification (ie. application:performFetchWithCompletionHandler:completionHandler) to check connection status and restart any paused downloads. (hat-tip @gugupluto)

This still doesn't provide optimal download performance and may lead users to wonder why their "background download" hasn't finished once they reopen the app, but it seems to be the best we can hope for from Apple for now.

Upvotes: 2

Zeev Vax
Zeev Vax

Reputation: 924

You should create the NSURLSession with background configurations, then your task is sent to a background demon and your app get called when it is completed.

Upvotes: 2

gugupluto
gugupluto

Reputation: 31

As I'm still in background I cannot trigger a "resume" when network is back without launching the application…


you can use "background fetch",when the app is launched by fetch,then you can check network and resume the download task.

Upvotes: 3

Related Questions