KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

MBSessionDownload

★ 14 Open GitHub ↗

MBSessionDownload can download files for background process in iOS7

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

MBSessionDownload
=================

MBSessionDownload is best way to download files in your apps. Your apps can download files in a foreground or background.

Requires **iOS 7.0 or later**.

======

## Features
1. Download files in background threads.
2. Use blocks!
3. Pause and resume a download.
4. Custom download path and auto path creation.
5. Continue to download files when your app is in a background

## Methods
#### MBDownloadManager
```objective-c
+(MBDownloadManager *)defaultManager;
-(NSUInteger)makeSessionWithProgressBlock:(ProgressBlock)progressBlock
                               errorBlock:(ErrorBlock)errorBlock
                            completeBolck:(CompleteBlock)completeBlock;

-(NSUInteger)startDownloadWithURL:(NSString *)downloadURLString sessionID:(NSUInteger)sessionID;
-(NSUInteger)startDownloadWithURL:(NSString *)downloadURLString destination:(NSString *)destination sessionID:(NSUInteger)sessionID;

-(void)pauseDownloadWithIdentifier:(NSUInteger)taskID;
-(void)pauseAllTasks;

-(void)stopDownloadWithIdentifier:(NSUInteger)taskID;
-(void)stopAllTasks;
```

#### MBURLSessionManager
```objective-c
-(NSURLSession *)getSessionWithConfiguration:(NSURLSessionConfiguration *)configuration
                               progressBlock:(ProgressBlock)progressBlock
                                  errorBlock:(ErrorBlock)errorBlock
                               completeBolck:(CompleteBlock)completeBlock;
```

## Usage

### 1. Blocks
You can set different process blocks each session. But remember the session ID, that will be used to use a download process you set.

To immediately start a download in the default MBDownloadManager directory (`<Application_Home>/temp` by default):

```objective-c
#import "MBDowloadManager/MBDownloadManager.h"

_currentSessionID = [[MBDownloadManager defaultManager]
                         makeSessionWithProgressBlock:^(NSUInteger taskID, int64_t bytesWritten,
                                                        int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite){
        
        NSLog(@"received data lenth : %lld \ntotal received data length : %lld \ntotal data length : %lld", bytesWritten, totalBytesWritten, totalBytesExpectedToWrite);
        [_progress setProgress:((double)totalBytesWritten/(double)totalBytesExpectedToWrite)];
        
    } errorBlock:^(NSUInteger taskID, NSError *error){
        
        NSLog(@"download error : %@", [error localizedDescription]);
        
    } completeBolck:^(NSUInteger taskID, BOOL isFinish, NSString *filePath){
        
        if (isFinish) {
            NSLog(@"file path is %@", filePath);
        }
        
    }];

_currentTaskID = [[MBDownloadManager defaultManager] startDownloadWithURL:DownloadURLString sessionID:_currentSessionID];

```

If you set a customPath:

```objective-c

_currentTaskID = [[MBDownloadManager defaultManager] startDownloadWithURL:DownloadURLString destination:CUSTOM_PATH sessionID:_currentSessionID];

```

Pause and resume download:

```objective-c

[[MBDownloadManager defaultManager] pauseDownloadWithIdentifier:taskID];
[[MBDownloadManager defaultManager] pauseAllTasks];

```

Stop download:

```objective-c

[[MBDownloadManager defaultManager] stopDownloadWithIdentifier:taskID];
[[MBDownloadManager defaultManager] stopAllTasks];

```

This will **create** the given path if needed and download the file. Apple recommend putting file to download in `<Application_Home>/Library/Caches` directory. **Remember that you should follow the [iOS Data Storage Guidelines](https://developer.apple.com/icloud/documentation/data-storage/)**.

### 2. Other things you should know
**1** This download manager is made using [NSURLSession](https://developer.apple.com/library/ios/documentation/Foundation/Reference/NSURLSession_class/Introduction/Introduction.html) and [NSURLSessionDownloadTask](https://developer.apple.com/library/ios/documentation/Foundation/Reference/NSURLSessionDownloadTask_class/Reference/Reference.html#//apple_ref/occ/cl/NSURLSessionDownloadTask)

**2** Use [EGOCache](https://github.com/enormego/EGOCache) to save resuming data. EGOCache is following a MIT license.

License
=================
The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

MBSessionDownload

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README