iOS后台下载管理工具-XXDownload

iOS 后台下载管理工具 XXDownload,通过传入一个url地址就开始下载并且是支持后台下载的,底层是用NSURLSessionDownloadTask实现的。以下是这个工具的使用方法。

一、准备工作

1、安装
使用cocopods安装,或者直接把Demo中的XXDownload文件夹拖入到项目中

pod 'XXDownload',:git => 'https://github.com/XXDownload/XXDownload.git'

2、导入头文件

#import <XXDownload.h>

3、在appDelegate的这个代理方法中添加如下代码

- (void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)())completionHandler {
    
    [[XXDownloadManager sharedManager] addFinishBlock:completionHandler identifier:identifier];
}

4、提供数据库操作类
如果不提供这个类则下载列表的数据只会存在内存中,当应用退出再启动的时候下载列表是空的。

①数据库操作类可以把下载任务列表保存到本地,当应用退出再启动时下载列表才不会丢失。这部分可以自己实现,也可以使用demo中的 XXDownloadDBHelper 这个类,这个类用FMDB来操作数据库,所以需要 pod FMDB。

demo中的数据库操作类

[XXDownloadManager sharedManager].dbHelper = [[XXDownloadDBHelper alloc] init];

②数据库操作类只是对 XXDownloadModel 类操作,不需要操作XXDownloadTask,只有 XXDownloadModel 这些属性需要保存到数据库中去,其他的属性没有必要保存到数据库。

③自己实现的话需要遵守XXDownloadDBDelegate这个协议,并实现以下几个方法:

/**
 获取所有的下载任务
 
 @return 下载任务数组
 */
- (NSArray<XXDownloadModel *> *)getAllTasks;

/**
 将未入库的下载任务插入到库中去
 
 @param downloadArray 下载数组
 */
- (void)insertTasks:(NSArray<XXDownloadModel *> *)downloadArray;

/**
 更新下载任务 用 model 里面的所有属性去更新表里面的所有属性
 
 @param taskArray 下载任务数组
 */
- (void)updateTasks:(NSArray<XXDownloadModel *> *)taskArray;

/**
 删除表中的model记录
 
 @param model 任务
 */
- (void)deleteTask:(XXDownloadModel *)model;

二、任务操作

1、创建一个下载任务

XXDownloadTask *task = [XXDownloadTask taskWithId:taskId name:name type:XXDownloadTypeUrl url:url size:0];

2、把这个任务添加到下载队列中
① 如果是调用的 insertTask,如果同时下载的任务数大于正在下载的个数,则该任务直接开始下载,如果同时下载的任务数小于正在下载的个数,则先暂停下载数组中的第一个任务,并把被暂停的任务插入等待数组中的第一个位置,然后递归上述过程直到这个新添加的任务开始下载。

[[XXDownloadManager sharedManager] insertTask:task];

②如果是调用的 addTask,如果同时下载的任务数大于正在下载的个数,则该任务直接开始下载,如果同时下载的任务数小于正在下载的个数,则该任务直接添加到等待数组。

[[XXDownloadManager sharedManager] addTask:task];

3、开始任务
当任务是暂停状态时才调用这个方法,开始这个任务,让这个任务插入等待数组中的第一个位置

[[XXDownloadManager sharedManager] startTask:task];

4、暂停任务
当任务是等待状态或者正在下载的状态的时候调用暂停任务的方法,将该任务从等待列表或者正在下载的列表中移除。

[[XXDownloadManager sharedManager] pauseTask:task];

5、删除任务

 [[XXDownloadManager sharedManager] deleteTask:task];
三、回调

1、下载进度和下载状态的回调
①设置代理对象

[XXDownloadManager sharedManager].delegate = self;

②实现代理方法

/**
 下载状态回调
 
 @param task 下载任务
 @param state 状态
 */
- (void)downloadTask:(XXDownloadTask *)task stateChanged:(XXDownloadState)state;

/**
 下载进度回调
 
 @param task 下载任务
 @param dSize 已下载大小  单位 MB
 @param tSize 总大小     单位 MB
 @param progress  进度
 @param speed 速度
 */
- (void)downloadTask:(XXDownloadTask *)task downloadSize:(CGFloat)dSize totalSize:(CGFloat)tSize progress:(CGFloat)progress speed:(CGFloat)speed;

@optional;
/**
 下载任务的缓存目录

 @param task 下载任务
 @return 缓存目录
 */
- (NSString *)cacheDirectoryWithdownloadTask:(XXDownloadTask *)task;
/**
 下载任务的文件保存目录
 
 @param task 下载任务
 @return 缓存目录
 */
- (NSString *)downloadDirectoryWithdownloadTask:(XXDownloadTask *)task;

其中主要是下载任务的状态的变化和下载进度的回调。当任务下载完成的时候可以在下载状态的回调中对该任务的文件做相应的操作比如说拷贝和发出下载完成的本地通知等,文件的路径会保存放到 task.savePath这个属性中。

2、任务配置回调
①设置代理对象

[XXDownloadManager sharedManager].taskSetUpdelegate = self;

②实现代理方法

/**
 下载任务将要开始  可以对该任务做最后的配置   
 @param task 将要开始的任务
 @param successBlock 配置成功过后的回调
 @param failBlock 配置失败后的回调
 */
- (void)downloadTaskWillStart:(XXDownloadTask *)task setUpFinish:(void(^)())successBlock failBlock:(void(^)())failBlock;

任务将要开始的时候可以对这个任务做一些配置,配置完成后可以开始,如果配置失败则该任务不开始。

四、问题

应用退到后台的时候,当上一个任务完成的时候,感觉并没有立即开始下一个任务而是等了一段时间才开始的。如果有大神了解这块,麻烦告知一下。

五、demo及地址

https://github.com/XXDownload/XXDownload.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,099评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,828评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,540评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,848评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,971评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,132评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,193评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,934评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,376评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,687评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,846评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,537评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,175评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,887评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,134评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,674评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,741评论 2 351

推荐阅读更多精彩内容