YCDownloadSession

通过NSURLSession的创建后台下载任务时，保证了APP在后台或者退出的状态下，依然能后进行下载任务，下载完成后能够唤醒APP来将下载完成的数据保存到需要的位置。

功能点介绍

创建一个后台下载的session（创建的task为私有__NSCFBackgroundDownloadTask）：

NSString *bundleId = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleIdentifier"];
        NSString *identifier = [NSString stringWithFormat:@"%@.BackgroundSession", bundleId];
        NSURLSessionConfiguration* sessionConfig = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:identifier];
        sessionConfig.allowsCellularAccess = true;
        session = [NSURLSession sessionWithConfiguration:sessionConfig
                                                delegate:self
                                           delegateQueue:[NSOperationQueue mainQueue]];

在APP处于后台、锁屏状态下依然能后下载
最强大的是：APP在手动退出后暂停，在闪退的状态下依然能够进行下载任务，下载完成后自动唤醒APP，进行任务下载完成后的逻辑处理

结构介绍

该视频下载库库主要有四个核心类：YCDownloadSession，YCDownloadTask，YCDownloadItem，YCDownloadManager

YCDownloadSession：对NSURLSession的进一步分装，是一个单例，所有的下载任务都是由其生成和管理。是最主要的核心类。实现了下载的代理方法，通过一个可下载的url，生成一个YCDownloadTask，并且将该task的所有数据进行实时存储。
YCDownloadTask 将YCDownloadSession里的代理方法进一步封装和扩展，保存session生成和所需要的一些下载信息和数据。
YCDownloadItem 存放需要下载的视频的信息
YCDownloadManager 管理下载视频操作，生成一个YCDownloadItem，并且实时保存相关信息(下载状态，文件大小，已下载文件大小，以及其它的需要和UI交互的数据)，然后调用YCDownloadSession去下载该视频。

用法

AppDelegate设置后台下载成功回调方法

-(void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)(void))completionHandler{
    [[YCDownloadSession downloadSession] addCompletionHandler:completionHandler];
}

如果想要多个任务在后台同时进行，必须要进行设置上述的代理方法。YCDownloadSession内部会处理该回调方法(completionHandler的作用将会在blog里详细说明)，内部处理逻辑：

 //等task delegate方法执行完成后去判断该逻辑
 //URLSessionDidFinishEventsForBackgroundURLSession 方法在后台执行一次，所以在此判断执行completedHandler
 if (status == YCDownloadStatusFinished) {
     
     if ([self allTaskFinised]) {
         [[NSNotificationCenter defaultCenter] postNotificationName:kDownloadAllTaskFinishedNoti object:nil];
         //所有的任务执行结束之后调用completedHanlder
         if (self.completedHandler) {
             NSLog(@"completedHandler");
             self.completedHandler();
             self.completedHandler = nil;
         }
     }
  
 }

直接使用YCDownloadSession下载文件

self.downloadURL = @"http://dldir1.qq.com/qqfile/QQforMac/QQ_V6.0.1.dmg";



- (void)start {
    self.downloadTask = [YCDownloadSession.downloadSession startDownloadWithUrl:self.downloadURL fileId:nil delegate:self];
}
- (void)resume {
    [self.downloadTask resume];
}

- (void)pause {
    [self.downloadTask pause];
}

- (void)stop {
    [self.downloadTask remove];
}
	
//代理
- (void)downloadProgress:(YCDownloadTask *)task downloadedSize:(NSUInteger)downloadedSize fileSize:(NSUInteger)fileSize {
    self.progressLbl.text = [NSString stringWithFormat:@"%f",(float)downloadedSize / fileSize * 100];
}


- (void)downloadStatusChanged:(YCDownloadStatus)status downloadTask:(YCDownloadTask *)task {
    if (status == YCDownloadStatusFinished) {
        self.progressLbl.text = @"download success!";
        NSLog(@"save file path: %@", task.savePath);
    }else if (status == YCDownloadStatusFailed){
        self.progressLbl.text = @"download failed!";
    }
}

//文件下载完成后的路径通过task.savePath读取

使用自定义的管理类(YCDownloadManager 视频类型文件专用下载管理类)下载。假如视频下载完成，自定义保存名称，那么使用fileId来标识。如果fileId为空使用下载URL的MD5的值来保存

/**
 开始/创建一个后台下载任务。downloadURLString作为整个下载任务的唯一标识。
 下载成功后用downloadURLString的MD5的值来保存
 文件后缀名取downloadURLString的后缀名，[downloadURLString pathExtension]

 @param downloadURLString 下载的资源的url
 @param fileName 资源名称,可以为空
 @param imagUrl 资源的图片,可以为空
 */
+ (void)startDownloadWithUrl:(NSString *)downloadURLString fileName:(NSString *)fileName imageUrl:(NSString *)imagUrl;

/**
 开始/创建一个后台下载任务。downloadURLString作为整个下载任务的唯一标识。
 下载成功后用fileId来保存, 要确保fileId唯一
 文件后缀名取downloadURLString的后缀名，[downloadURLString pathExtension]
 
 @param downloadURLString 下载的资源的url， 不可以为空， 下载任务标识
 @param fileName 资源名称,可以为空
 @param imagUrl 资源的图片,可以为空
 @param fileId 非资源的标识,可以为空，用作下载文件保存的名称
 */
+ (void)startDownloadWithUrl:(NSString *)downloadURLString fileName:(NSString *)fileName imageUrl:(NSString *)imagUrl fileId:(NSString *)fileId;


    /**
 暂停一个后台下载任务
 
 @param item 创建的下载任务item
 */
+ (void)pauseDownloadWithItem:(YCDownloadItem *)item;

/**
 继续开始一个后台下载任务
 
 @param item 创建的下载任务item
 */
+ (void)resumeDownloadWithItem:(YCDownloadItem *)item;

/**
 删除一个后台下载任务，同时会删除当前任务下载的缓存数据
 
 @param item 创建的下载任务item
 */
+ (void)stopDownloadWithItem:(YCDownloadItem *)item;

/**
 暂停所有的下载
 */
+ (void)pauseAllDownloadTask;

蜂窝煤是否允许下载的方法(YCDownloadSession, YCDownloadManager)

YCDownloadSession: 
/**
 是否允许蜂窝煤网络下载，以及网络状态变为蜂窝煤是否允许下载，必须把所有的downloadTask全部暂停，然后重新创建。否则，原先创建的
 下载task依旧在网络切换为蜂窝煤网络时会继续下载
 
 @param isAllow 是否允许蜂窝煤网络下载
 */
- (void)allowsCellularAccess:(BOOL)isAllow;

YCDownloadManager:
/**
 获取当前是否允许蜂窝煤访问状态
 */
- (BOOL)isAllowsCellularAccess;

设置最大同时进行下载的任务数

YCDownloadSession: 
/**
 设置下载任务的个数，最多支持3个下载任务同时进行。
 NSURLSession最多支持5个任务同时进行
 但是5个任务，在某些情况下，部分任务会出现等待的状态，所有设置最多支持3个
 */
@property (nonatomic, assign) NSInteger maxTaskCount;



YCDownloadManager:
/**
 设置下载任务的个数，最多支持3个下载任务同时进行。
 */
+ (void)setMaxTaskCount:(NSInteger)count;

下载完成的通知
- 本地通知(YCDownloadManager实现)：
```
 /**
  本地通知的开关，默认是false,可以根据通知名称自定义通知类型
  */
 + (void)localPushOn:(BOOL)isOn;
```
- 当前session中所有的任务下载完成的通知。不包括失败、暂停的任务: kDownloadAllTaskFinishedNoti
- 某一的任务下载完成的通知object为YCDownloadItem对象：kDownloadTaskFinishedNoti
某一任务下载的状态发生变化的通知: kDownloadStatusChangedNoti 主要用于状态改变后，及时保存下载数据信息。