iOS7后台数据下载教程

原文：iOS 7 SDK: Background Transfer Service

这个教程将会教会你如何在后台传输数据，如何使用iOS7提供的多任务API。我将会教会你如何在后台下载一个文件，并且在文件下载完成时弹出一个本地的提醒。   后台数据传输起源于iOS6，允许在前台或者后台下载数据，但是时间是受限制的。最大的问题就是时间是受限制的让用户无法上传或下载大文件。这就是为什么苹果在iOS7上要提升框架的原因。 在iOS7中，这个功能有了很大变化，包括:

1.iOS系统管理上传和下载任务。

2.当用户关闭应用程序时后台仍然可以传输数据

3.时间不受限制

4.它可以在任意时间加入队列（前台或者后台）

5.应用程序需要被唤醒来获取验证，错误，或者完成情况

6.应用程序会有一个进度展示视图 后台传输可以应用在几个非常有用的地方：上传照片或者视频，结合后台提取和远程通知，用于保持应用程序在最新时间。

下面是范例工程。

注：原文，作者是去下载了一个PDF，由于下载的苹果那个PDF感觉比较慢，就改成下载我自己服务器上的一个mp3文件了。

1.创建工程 我们需要一个MainViewController来做这里的主要工作：

1)包含一个按钮,一个ProgeressView

像这样:





 

然后，我们需要在工程头文件里面添加我们需要的成员。

完成之后，我们的MainViewController.h会像这样

 

#import <AVFoundation/AVFoundation.h>

@interface MainViewController : UIViewController<NSURLSessionDelegate,NSURLSessionTaskDelegate,NSURLSessionDownloadDelegate,UIDocumentInteractionControllerDelegate>
@property (weak, nonatomic) IBOutlet UIProgressView *progressView;

@property (nonatomic)NSURLSession *session;
@property (nonatomic)NSURLSessionDownloadTask *downloadTask;
@property (strong,nonatomic)UIDocumentInteractionController *documentInteractionController;
@property (nonatomic,strong)AVPlayer *player;

- (IBAction)startDownload:(id)sender;

下一步我们需要使用NSURLSession来完成任务。

我们要在viewDidLoad中初始化我们需要的session成员

- (void)viewDidLoad
{
[super viewDidLoad];
// Do any additional setup after loading the view from its nib.

self.session = [self backgroundSession];
self.progressView.progress = 0;
self.progressView.hidden = YES;

}

 

然后我们要完成一个单一的session，使用dispatch_once来确保它会是同一个对象,里面有个要点，请仔细看注释

 

- (NSURLSession *)backgroundSession {
static NSURLSession *session = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{

//这个sessionConfiguration 很重要， com.zyprosoft.xxx  这里，这个com.company.这个一定要和 bundle identifier 里面的一致，否则ApplicationDelegate 不会调用handleEventsForBackgroundURLSession代理方法
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration backgroundSessionConfiguration:@"com.zyprosoft.backgroundsession"];
session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil];
});
return session;
}

我们再给开始按钮方法添加开始下载任务的执行

- (IBAction)startDownload:(id)sender {

if (self.downloadTask) {
return;
}
NSURL *downloadURL = [NSURL URLWithString:DownloadURLString];
NSURLRequest *request = [NSURLRequest requestWithURL:downloadURL];
self.downloadTask = [self.session downloadTaskWithRequest:request];
[self.downloadTask resume];
self.progressView.hidden = NO;

}

再接着我们需要来完成最重要的事情，把Session的代理方法完成

首先我们完成 NSURLSessionDownloadTaskDelegate

//这个方法用来跟踪下载数据并且根据进度刷新ProgressView
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
if (downloadTask == self.downloadTask) {
double progress = (double)totalBytesWritten / (double)totalBytesExpectedToWrite;
NSLog(@"下载任务: %@ 进度: %lf", downloadTask, progress);
dispatch_async(dispatch_get_main_queue(), ^{
self.progressView.progress = progress;
});
}
}

//下载任务完成,这个方法在下载完成时触发，它包含了已经完成下载任务得 Session Task,Download Task和一个指向临时下载文件得文件路径
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
{
NSFileManager *fileManager = [NSFileManager defaultManager];
NSArray *URLs = [fileManager URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask];
NSURL *documentsDirectory = [URLs objectAtIndex:0];
NSURL *originalURL = [[downloadTask originalRequest] URL];
NSURL *destinationURL = [documentsDirectory URLByAppendingPathComponent:[originalURL lastPathComponent]];
NSError *errorCopy;
// For the purposes of testing, remove any esisting file at the destination.
[fileManager removeItemAtURL:destinationURL error:NULL];
BOOL success = [fileManager copyItemAtURL:location toURL:destinationURL error:&errorCopy];
if (success) {
dispatch_async(dispatch_get_main_queue(), ^{
//download finished - open the pdf

//原文下载的苹果的pdf，感觉有点慢，自己又没找到比较大一点的pdf，干脆就放了个mp3歌曲在自己服务器上，所以下载完就播放mp3吧
//            self.documentInteractionController = [UIDocumentInteractionController interactionControllerWithURL:destinationURL];
//            // Configure Document Interaction Controller
//            [self.documentInteractionController setDelegate:self];
//            // Preview PDF
//            [self.documentInteractionController presentPreviewAnimated:YES];
//            self.progressView.hidden = YES;

//播放音乐
self.player = [AVPlayer playerWithURL:destinationURL];
[self.player play];

});
} else {
NSLog(@"复制文件发生错误: %@", [errorCopy localizedDescription]);
}
}

//这个方法我们暂时用不上
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
{

}

接着我们需要完成NSURLSessionTaskDelegate需要用到的代理方法

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
if (error == nil) {
NSLog(@"任务: %@ 成功完成", task);
} else {
NSLog(@"任务: %@ 发生错误: %@", task, [error localizedDescription]);
}
double progress = (double)task.countOfBytesReceived / (double)task.countOfBytesExpectedToReceive;
dispatch_async(dispatch_get_main_queue(), ^{
self.progressView.progress = progress;
});
self.downloadTask = nil;
}

最后，我们要完成NSURLSessionDelegate代理方法

- (void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session
{
ZYBackgroundServiceAppDelegate *appDelegate = (ZYBackgroundServiceAppDelegate *)[[UIApplication sharedApplication] delegate];
if (appDelegate.backgroundSessionCompletionHandler) {
void (^completionHandler)() = appDelegate.backgroundSessionCompletionHandler;
appDelegate.backgroundSessionCompletionHandler = nil;
completionHandler();
}
NSLog(@"所有任务已完成!");
}

这里我们用到了AppDelegate里面的一个成员block,用来执行当后台下载完成时调度这个方法。所以我们还要去完成我们的AppDelegate

我们在AppDelegate.h里面添加一个完成时执行的block,添加完应该是这样的

@interface ZYBackgroundServiceAppDelegate : UIResponder <UIApplicationDelegate>

@property (strong, nonatomic) UIWindow *window;
@property (copy) void (^backgroundSessionCompletionHandler)();

@end

然后，我们去AppDelegate.m里面完成我们需要弹出本地提醒的方法就大功告成了!

在AppDelegate.m里面，我们需要完成下面几个重要的方法:

添加完应该是这样的

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
// Override point for customization after application launch.
self.window.backgroundColor = [UIColor whiteColor];

//初始化
MainViewController *mainViewController = [[MainViewController alloc]initWithNibName:@"MainViewController" bundle:Nil];
mainViewController.title = @"后台下载测试Demo";
UINavigationController *rootNav = [[UINavigationController alloc]initWithRootViewController:mainViewController];
self.window.rootViewController = rootNav;

[self.window makeKeyAndVisible];
return YES;
}

- (void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier
completionHandler:(void (^)())completionHandler {
self.backgroundSessionCompletionHandler = completionHandler;
//添加本地通知
[self presentNotification];
}

-(void)presentNotification{
UILocalNotification* localNotification = [[UILocalNotification alloc] init];
localNotification.alertBody = @"下载完成!";
localNotification.alertAction = @"后台传输下载已完成!";
//提示音
localNotification.soundName = UILocalNotificationDefaultSoundName;
//icon提示加1
localNotification.applicationIconBadgeNumber = [[UIApplication sharedApplication] applicationIconBadgeNumber] + 1;
[[UIApplication sharedApplication] presentLocalNotificationNow:localNotification];
}

我们最后需要当用户点击进来时，把图标上面的数字提醒设置为0

- (void)applicationDidBecomeActive:(UIApplication *)application
{
// Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.

application.applicationIconBadgeNumber = 0;

}

最终我们运行效果会是这样的:









 

最后的最后是工程的源代码了:

ZYBackgroundService

background transfer,

iOS后台下载，iOS7,
NSURLSession