iOS后台下载、断点下载

后台下载时序图

具体代码实现

1. 创建一个后台下载对象
   用dispatch_once创建一个用于后台下载对象，目的是为了保证identifier的唯一，文档不建议对于相同的标识符 (identifier) 创建多个会话对象。这里创建并配置了NSURLSession，将通过backgroundSessionConfiguration其指定为后台session并设定delegate。

   - (NSURLSession *)backgroundURLSession { static NSURLSession *session = nil; static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{     NSString *identifier = @"com.yourcompany.appId.BackgroundSession";     NSURLSessionConfiguration* sessionConfig = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:identifier];     session = [NSURLSession sessionWithConfiguration:sessionConfig                                             delegate:self                                        delegateQueue:[NSOperationQueue mainQueue]]; }); return session;}

2. 向其中加入对应的传输用的NSURLSessionTask，并调用resume启动下载。

   - (void)beginDownloadWithUrl:(NSString *)downloadURLString { NSURL *downloadURL = [NSURL URLWithString:downloadURLString]; NSURLRequest *request = [NSURLRequest requestWithURL:downloadURL]; NSURLSession *session = [self backgroundURLSession]; NSURLSessionDownloadTask *downloadTask = [session downloadTaskWithRequest:request]; [downloadTask resume];}

3. 在appDelegate中实现handleEventsForBackgroundURLSession，要注意的是，需要在handleEventsForBackgroundURLSession中必须重新建立一个后台 session 的参照（可以用之前dispatch_once创建的对象），否则 NSURLSessionDownloadDelegate 和 NSURLSessionDelegate 方法会因为没有 对 session 的 delegate 设置而不会被调用。
   然后保存completionHandler()。

   - (void)application:(UIApplication *)applicationhandleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)())completionHandler {   NSURLSession *backgroundSession = [self backgroundURLSession];   NSLog(@"Rejoining session with identifier %@ %@", identifier, backgroundSession);   // 保存 completion handler 以在处理 session 事件后更新 UI   [self addCompletionHandler:completionHandler forSession:identifier];    }- (void)addCompletionHandler:(CompletionHandlerType)handler forSession:(NSString *)identifier {    if ([self.completionHandlerDictionary objectForKey:identifier]) {       NSLog(@"Error: Got multiple handlers for a single session identifier.  This should not happen.\n");    }    [self.completionHandlerDictionary setObject:handler forKey:identifier];}

   注：handleEventsForBackgroundURLSession方法是在后台下载的所有任务完成后才会调用。如果当后台传输完成时，如果应用程序已经被杀掉，iOS将会在后台启动该应用程序，下载相关的委托方法会在 application:didFinishLaunchingWithOptions:方法被调用之后被调用。

4. 实现URLSessionDidFinishEventsForBackgroundURLSession，待所有数据处理完成，UI刷新之后在改方法中在调用之前保存的completionHandler()。

   //NSURLSessionDelegate委托方法，会在NSURLSessionDownloadDelegate委托方法后执行- (void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session {     NSLog(@"Background URL session %@ finished events.\n", session);     if (session.configuration.identifier) {         // 调用在 -application:handleEventsForBackgroundURLSession: 中保存的 handler         [self callCompletionHandlerForSession:session.configuration.identifier];     }}- (void)callCompletionHandlerForSession:(NSString *)identifier {     CompletionHandlerType handler = [self.completionHandlerDictionary objectForKey: identifier];     if (handler) {        [self.completionHandlerDictionary removeObjectForKey: identifier];        NSLog(@"Calling completion handler for session %@", identifier);         handler();     }}

5. 在此，后台下载的基本功能已经具备了，如果还需要监听下载进度和对下载完成数据进行处理，则需要实现上面提到的委托方法
   URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:和URLSession:downloadTask:didFinishDownloadingToURL:

关于断点下载

对于断点下载需要考虑几个问题：

1. 如何暂停下载，暂停后，如何继续下载？
2. 下载失败后，如何恢复下载？
3. 应用被用户杀掉后，如何恢复之前的下载？

针对这几个问题，我们一个来分析

• 如何暂停下载，暂停后，如何继续下载？
  有两种方法
  • 第一种，使用cancelByProducingResumeData

    /* 对某一个NSURLSessionDownloadTask取消下载，取消后会回调给我们 resumeData，* resumeData包含了下载任务的一些状态，之后可以用户恢复下载*/- (void)cancelByProducingResumeData:(void (^)(NSData * resumeData))completionHandler;

    调用该方法会触发以下方法，会附带resumeData，用于恢复。

    - (void)URLSession:(NSURLSession *)session          task:(NSURLSessionTask *)taskdidCompleteWithError:(NSError *)error

    对应恢复方法

    //通过之前保存的resumeData，获取断点的NSURLSessionTask，调用resume恢复下载NSURLSessionDownloadTask *task = [[self backgroundURLSession] downloadTaskWithResumeData:resumeData];[task resume];

  • 第二种，使用NSURLSessionDownloadTask的suspend方法

    //暂停[self.downloadTask suspend];//恢复[self.downloadTask resume];

    通过以上的两个方法，就可以实现下载的暂停与恢复下载了
• 下载失败后，如何恢复下载？
  下载失败后，可以通过以下代码来恢复下载

  /* 该方法下载成功和失败都会回调，只是失败的是error是有值的，* 在下载失败时，error的userinfo属性可以通过NSURLSessionDownloadTaskResumeData* 这个key来取到resumeData(和上面的resumeData是一样的)，再通过resumeData恢复下载*/- (void)URLSession:(NSURLSession *)sessiona            task:(NSURLSessionTask *)taskdidCompleteWithError:(NSError *)error {  if (error) {      // check if resume data are available      if ([error.userInfo objectForKey:NSURLSessionDownloadTaskResumeData]) {          NSData *resumeData = [error.userInfo objectForKey:NSURLSessionDownloadTaskResumeData];          NSURLSessionTask *task = [[self backgroundURLSession] downloadTaskWithResumeData:resumeData];          [task resume];      }  }}

• 应用被用户杀掉后，如何恢复之前的下载？
  在应用被杀掉前，iOS系统保存应用下载sesson的信息，在重新启动应用，并且创建和之前相同identifier的session时（苹果通过identifier找到对应的session数据），iOS系统会对之前下载中的任务进行依次回调URLSession:task:didCompleteWithError:方法，之后可以使用上面提到的下载失败时的处理方法进行恢复下载

知道这些后，看下前台下载的时序图对整个下载流程就了解了。

前台下载时序图.png

关于Session的生命周期，可以阅读 Apple 的 Life Cycle of a URL Session with Custom Delegates 文档，它讲解了所有类型的会话任务的完整生命周期。

后台下载的配置和限制

NSURLSessionConfiguration 允许你设置默认的HTTP头，配置缓存策略，限制使用蜂窝数据等等。其中一个选项是discretionary标志，这个标志允许系统为分配任务进行性能优化。这意味着只有当设备有足够电量时，设备才通过 Wifi 进行数据传输。如果电量低，或者只仅有一个蜂窝连接，传输任务是不会运行的。后台传输总是在 discretionary模式下运行。timeoutIntervalForResource属性，支持资源超时特性。你可以使用这个特性指定你允许完成一个传输所需的最长时间。内容只在有限的时间可用，或者在用户只有有限Wifi带宽的时间内无法下载或上传资源的情况下，你也可以使用这个特性。

最后，我们来说一说使用后台会话的几个限制。作为一个必须实现的委托，您不能对NSURLSession使用简单的基于 block的回调方法。后台启动应用程序，是相对耗费较多资源的，所以总是采用HTTP重定向。后台传输服务只支持HTTP和HTTPS，你不能使用自定义的协议。系统会根据可用的资源进行优化，在任何时候你都不能强制传输任务在后台进行。

另外，要注意的是在后台会话中，NSURLSessionDataTasks 是完全不支持的，你应该只出于短期的，小请求为目的使用这些任务，而不是用来下载或上传。其中发现一些需要注意的点，记录下来。

NSURLSession在iOS10上的Bug

在iOS10上，resumeData不能直接使用，会提示以下错误

*** -[NSKeyedUnarchiver initForReadingWithData:]: data is NULL*** -[NSKeyedUnarchiver initForReadingWithData:]: data is NULLInvalid resume data for background download. Background downloads must use http or https and must download to an accessible file.

解决方法有点小麻烦，具体解决方法可以参照以下Demo

关于在后台启动新的下载任务，苹果对这方面有限制

大致说明如下：

1.苹果的NSURLSession这个类会维护一个Delay值（即延时执行时间），用于后台启动任务延时执行时使用；
2.当在后台启动一个新任务时，苹果会对这个任务进行延时执行，延时时间苹果那边是有一个默认的延时时间，当后台启动的任务数越多，这个值就会成2的N-1幂倍增长；
3.比如：假设苹果设定的延时时间为Delay。当在后台启动了第一个任务时，这个任务的延时时间为Delay，这个任务会在Delay时间后开始执行；当启动在后台启动第二个任务时，这个任务的延时时间为2*Delay，当启动第三个任务是，该任务的延时执行时间即为2*2*Delay以此类推，在后台启动第N个任务是，该任务的延时执行时间为2(N-1)次方*Delay；
4.但是在应用从后台切到前台或者重新启动时，这个延时时间会重置。

所以苹果对在后台启动新的下载或者上传任务时，是有限制的，苹果也是不建议这么处理的

以下为苹果官方说明的链接地址：
https://forums.developer.apple.com/thread/14854

简单的下载Demo

Demo