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去下载该视频。

图解：

YCDownloadSession和YCDownloadTask是两个核心类。与YCDownloadManager和YCDownloadItem相互独立。大家和可以通过YCDownloadSession和YCDownloadTask自定义需要的下载管理类的信息类。

用法

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 {
    [[YCDownloadSession downloadSession] startDownloadWithUrl:self.downloadURL delegate:self saveName:nil];
}
- (void)resume {
    [[YCDownloadSession downloadSession] resumeDownloadWithUrl:self.downloadURL delegate:self saveName:nil];
}

- (void)pause {
    [[YCDownloadSession downloadSession] pauseDownloadWithUrl:self.downloadURL];
}

- (void)stop {
    [[YCDownloadSession downloadSession] stopDownloadWithUrl:self.downloadURL];
}
	
//代理
- (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!";
    }else if (status == YCDownloadStatusFailed){
        self.progressLbl.text = @"download failed!";
    }
}

使用自定义的管理类(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;

蜂窝煤是否允许下载的方法(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 主要用于状态改变后，及时保存下载数据信息。

使用效果图

单文件下载测试

多视频下载测试

下载通知

TODO

4G/流量下载管理（完成）
对下载任务个数进一步优化和管理（完成）
下载完成后添加本地通知（完成）
301/302 视频模拟测试（完成）
Swift 版的下载 - 第一个稳定版发布后开始

下载代码详解

简书blog： http://www.jianshu.com/p/2ccb34c460fd

使用APP：https://itunes.apple.com/cn/app/id975958413

欢迎各位关注该库，如果你有任何问题请issues我，将会随时更新新功能和解决存在的问题。

技术交流QQ群： 304468625

dz-tal / ycdownloadsession Goto Github PK