| TestsTested | ✗ |
| LangLanguage | Obj-CObjective C |
| License | MIT |
| ReleasedLast Release | May 2016 |
Maintained by hiessu.
$ cd HJMURLDownloaderExample
$ pod install
$ open HJMURLDownloaderExample.xcworkspace
建议使用 Cocoapods 集成到项目中
pod 'HJMURLDownloader'
/**
* 单例方法
*/
+ (instancetype)defaultManager;
/**
* 创建普通下载器，不支持后台下载，默认不限制网络
*
* @param aMaxConcurrentFileDownloadsCount 最大并发数
*/
- (instancetype)initStandardDownloaderWithMaxConcurrentDownloads:(NSInteger)aMaxConcurrentFileDownloadsCount;
/**
* 创建后台下载器，
*
* @param identifier 唯一标识，建议identifier命名为 bundleid.XXXXBackgroundDownloader,
* @param aMaxConcurrentFileDownloadsCount 最大并发数
* @param OnlyWiFiAccess 是否仅WiFi环境下载
*/
- (instancetype)initBackgroundDownloaderWithIdentifier:(NSString *)identifier maxConcurrentDownloads:(NSInteger)aMaxConcurrentFileDownloadsCount OnlyWiFiAccess:(BOOL)isOnlyWiFiAccess;- (void)application:(UIApplication *)anApplication handleEventsForBackgroundURLSession:(NSString *)aBackgroundURLSessionIdentifier completionHandler:(void (^)())aCompletionHandler
{
// 后台使用Background downloader 两种情况
// 1. 默认使用单例
[[HJMURLDownloaderInstance sharedInstance] addCompletionHandler:aCompletionHandler forSession:aBackgroundURLSessionIdentifier];
// 2. 使用自己创建的downloader
[[CCBookDownloader sharedDownloader] getDownloadManager] addCompletionHandler:aCompletionHandler forSession:aBackgroundURLSessionIdentifier];
}
- (void)applicationWillResignActive:(UIApplication *)application {
//保存本次下载状态
[HJMDownloadCoreDataManager saveContext];
}
- (void)applicationDidEnterBackground:(UIApplication *)application {
[HJMDownloadCoreDataManager saveContext];
}
- (void)applicationWillTerminate:(UIApplication *)application {
[HJMDownloadCoreDataManager saveContext];
}/**
* 是否有足够的磁盘空间
*
* @param expectedData 需要的磁盘空间
*
* @return 如果为YES 说明有足够的空间存储目标文件
*/
- (BOOL)downloadTaskShouldHaveEnoughFreeSpace:(long long)expectedData;
/**
* 完成下载任务后的回调方法
*
* @param item 下载任务模型对象
* @param block 完成后的回调Block
*/
@optional
- (void)downloadTaskDidFinishWithDownloadItem:(id<HJMURLDownloadExItem>)item
completionBlock:(void (^)(void))block;/**
* 基本添加和取消操作
*
* @param url 下载文件的URL
* @param progressBlock 下载进度Block Block内回传下载进度，文件总长度，剩余时间
* @param completeBlock 完成后回调Block Block内回传完成后的文件的沙盒路径，是否完成状态
*/
- (void)addDownloadWithURL:(NSURL *)url
progress:(HJMURLDownloadProgressBlock)progressBlock
complete:(HJMURLDownloadCompletionBlock)completeBlock;
/**
* 增加下载任务
*
* @param downloadItem 下载对象模型
*/
- (void)addURLDownloadItem:(id<HJMURLDownloadExItem>)downloadItem;
/**
* 获取下载任务信息
*
* @param identifier 下载对象的identifier
*/
- (id<HJMURLDownloadExItem>)getAURLDownloadWithIdentifier:(NSString *)identifier;
/**
* 取消下载任务
*
* @param downloadItem 下载对象模型
*/
- (void)cancelAURLDownloadItem:(id<HJMURLDownloadExItem>)downloadItem;
/**
* 取消下载任务
*
* @param identifier 下载对象的identifier
*/
- (void)cancelAURLDownloadWithIdentifier:(NSString *)identifier;
/**
* 取消所有下载任务
*/
- (void)cancelALLDownloads;+ (instancetype)sharedInstance
{
static dispatch_once_t onceToken;
static id sharedManager = nil;
dispatch_once(&onceToken, ^{
sharedManager = [[self alloc] initWithMaxConcurrentDownloads:1 isSupportBackgroundMode:YES];
});
return sharedManager;
} [self.downloadManager addDownloadWithURL:[NSURL URLWithString:self.originURLString] progress:^(float progress, int64_t totalLength, NSInteger remainingTime) {
// 获取progress totalLength remainingTime
// UI展示等操作
} complete:^(BOOL completed, NSURL *didFinishDownloadingToURL) {
// 完成时的操作，didFinishDownloadingToURL为下载的文件在本地的沙盒路径
}];- (BOOL)downloadTaskShouldHaveEnoughFreeSpace:(long long)expectedData {
return YES;
}
- (void)downloadTaskDidFinishWithDownloadItem:(id<HJMURLDownloadExItem>)downloadObject completionBlock:(void (^)(void))block {
..........................
//文件处理
..........................
//调用block，下载队列中的任务进行下一个
block();
}
[self.downloadManager cancelAURLDownloadWithIdentifier:self.originURLString];
+ (instancetype)sharedInstance
{
static dispatch_once_t onceToken;
static id sharedManager = nil;
dispatch_once(&onceToken, ^{
sharedManager = [[self alloc] initWithMaxConcurrentDownloads:1
isSupportBackgroundMode:YES];
});
return sharedManager;
}- (LessonItem *)createALessonItem {
LessonItem *aLesson = [[LessonItem alloc] init];
__weak __typeof(&*self)weakSelf= self;
aLesson.progressBlock = ^(float progress, int64_t totalLength, NSInteger seconds) {
..........................
// 获取progress totalLength remainingTime
// UI展示等操作
..........................
};
aLesson.completionBlock = ^(BOOL completed, NSURL *didFinishDownloadingToURL) {
..........................
// 完成时的操作，didFinishDownloadingToURL为下载的文件在本地的沙盒路径
..........................
};
aLesson.remoteURL = [NSURL URLWithString:@"http://a.ali.dongting.com/fccaa2a98849bfbc/1427606533/mp3_128_300/24/75/24812476f5df9d9cdcbc90beddc05a75.mp3"];
aLesson.relativePath = [[aLesson.remoteURL absoluteString] lastPathComponent];
[self.lessonsArray addObject:aLesson];
aLesson.identifier = aLesson.remoteURL;
aLesson.title = [downloadfilename stringByDeletingPathExtension];
aLesson.category = [NSString stringWithFormat:@"Category %d", arc4random() % 4];
return aLesson;
} [self.downloadManager addURLDownloadItem:[self createALessonItem]];- (BOOL)downloadTaskShouldHaveEnoughFreeSpace:(long long)expectedData {
return YES;
}
- (void)downloadTaskDidFinishWithDownloadItem:(id<HJMURLDownloadExItem>)downloadObject completionBlock:(void (^)(void))block {
..........................
//文件处理
..........................
//调用block，下载队列中的任务进行下一个
block();
}
[self.downloadManager cancelAURLDownloadItem:[self.lessonsArray firstObject]];
/**
* 获得下载管理器同步UI显示
*/
@property (strong, nonatomic) HJMURLDownloadManager *downloadManager; // 下载管理器
@property (assign, nonatomic) NSInteger userID; // 用户标识
@property (strong, nonatomic) UIColor *segmentedControlTintColor; // segmentControl的颜色
/**
* 点击下载完成的cell的progressButton触发的动作
*
* @param otherActionBlock 回调Block
*/
- (void)setDownloadedOtherActionBlock:(void(^)(HJMDownloaderManagerTableViewController *downloaderManagerTableViewController, HJMCDDownloadItem *downloadItem))otherActionBlock;HJMDownloaderManagerContainerViewController *downloaderManagerContainerViewController =
(HJMDownloaderManagerContainerViewController *)navigationController.topViewController;
[downloaderManagerContainerViewController setSegmentedControlTintColor:[UIColor colorWithRed:0.141
green:0.553
blue:0.886
alpha:1.000]];
downloaderManagerContainerViewController.downloadManager = viewController.downloadManager;
..................................
部分用户自定义设置
.................................. [downloaderManagerContainerViewController setDownloadedOtherActionBlock:
^(HJMDownloaderManagerTableViewController *downloaderManagerTableViewController, HJMCDDownloadItem *downloadItem) {
}];/**
* 设置segmentControl的标题
*/
- (void)updateSegmentTitles;
/**
* 设置已经下载项的区头的名字
*
* @param sectionName 名字
*/
- (void)setDownloadedSectionName:(NSString *)sectionName;
/**
* 设置正在下载项的区头的名字
*
* @param sectionName 名字
*/
- (void)setDownloadingSectionName:(NSString *)sectionName;
/**
* 设置已经下载页面的tableHeaderView的高度
*
* @param height tableHeaderView的高度
*/
- (void)setDownloadedTableViewHeaderHeight:(CGFloat)height;
/**
* 设置正在下载页面的tableHeaderView的高度
*
* @param height tableHeaderView的高度
*/
- (void)setDownloadingTableViewHeaderHeight:(CGFloat)height;
/**
* 设置已经下载页面CoreData检索的谓词
*
* @param downloadedPredicate 谓词
*/
- (void)setDownloadedPredicate:(NSPredicate *)downloadedPredicate;
/**
* 设置正在下载页面CoreData检索的谓词
*
* @param downloadingPredicate 谓词
*/
- (void)setDownloadingPredicate:(NSPredicate *)downloadingPredicate;
/**
* 设置已经下载页面排序描述
*
* @param downloadedSortDescriptors 排序描述
*/
- (void)setDownloadedSortDescriptors:(NSArray *)downloadedSortDescriptors;
/**
* 设置正在下载页面排序描述
*
* @param downloadingSortDescriptors 排序描述
*/
- (void)setDownloadingSortDescriptors:(NSArray *)downloadingSortDescriptors;
/**
* 设置已经下载页面和正在下载页面tableView样式
*
* @param makeupBlock 设置样式Block
*/
- (void)makeupTableViewWithBlock:(void(^)(UITableView *tableView))makeupBlock;
/**
* 注册已经下载页面的cell 的类型
*
* @param cellClass 重用cell的类型
*/
- (void)registerDownloadedCellClass:(Class)cellClass;
/**
* 注册已经下载页面的tableHeaderView的类型
*
* @param tableViewHeaderClass tableHeaderView的类型
*/
- (void)registerDownloadedHeaderViewClass:(Class)tableViewHeaderClass;
/**
* 注册正在下载页面的cell 的类型
*
* @param cellClass 重用cell的类型
*/
- (void)registerDownloadingCellClass:(Class)cellClass;
/**
* 注册正在下载页面的tableHeaderView的类型
*
* @param tableViewHeaderClass tableHeaderView的类型
*/
- (void)registerDownloadingHeaderViewClass:(Class)tableViewHeaderClass;
/**
* 设置已经下载页面无内容页
*
* @param noContentView 无内容页
*/
- (void)setNoContentViewForDownloadedViewController:(UIView *)noContentView;
/**
* 设置正在下载页面无内容页
*
* @param noContentView 无内容页
*/
- (void)setNoContentViewForDownloadingViewController:(UIView *)noContentView;
/**
* 刷新页面（内部调用TableView的reloadData）
*/
- (void)reloadDownloadData;
本项目参考并借鉴 HWIFileDownload 和 TCBlobDownload，在此表示感谢