引言
iOS 7 之后蘋果推出了一個新的類 NSProgress 專門用來管理進度,比如在下載數據或者執行任務的時候要顯示進度,那么這個類就可以很方便地對進度進行管理,供開發者拿去控制表示進度的UI界面。
這個類的用法其實很簡單,總結起來就是下面幾個步驟:
- 創建實例,同時設定表示任務要完成的數量的總值(這個總值只是一個用來計算比例的概念);
- 配置KVO觀察其進度的變化,從而對UI做出更新(NSProgress 類就是搭配 KVO 來操作的,關于 KVO 是什么可以看我這篇博客:iOS鍵值觀察KVO實例詳解);
- 執行任務,在執行過程中遞增表示已完成任務量的屬性(這個屬性用來判斷任務完成情況,供計算比例以及是否完成任務);
- 在 KVO 的響應方法中對UI進行更新操作,改變UI顯示的當前進度值。
就這么多了,具體的用法我們舉三個例子:單任務的執行、多任務的執行、以及 iOS 9 下新的多任務執行方法。
單任務執行
直接上代碼:
@interface ViewController ()
@property (nonatomic, strong) NSProgress *progress;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor lightGrayColor];
// 創建實例
self.progress = [NSProgress progressWithTotalUnitCount:10];
// 配置KVO觀察
[self.progress addObserver:self forKeyPath:@"fractionCompleted" options:NSKeyValueObservingOptionNew context:nil];
// 每秒執行一次任務
NSTimer *timer = [NSTimer scheduledTimerWithTimeInterval:1 target:self selector:@selector(doTask) userInfo:nil repeats:YES];
}
- (void)doTask {
if (self.progress.completedUnitCount < self.progress.totalUnitCount) {
self.progress.completedUnitCount ++;
}
}
#pragma mark - KVO
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary<NSKeyValueChangeKey,id> *)change context:(void *)context {
if ([keyPath isEqualToString:@"fractionCompleted"]) {
NSLog(@"進度表示形式1:%f", self.progress.fractionCompleted);
NSLog(@"進度表示形式2:%@", self.progress.localizedDescription);
NSLog(@"進度表示形式3:%@", self.progress.localizedAdditionalDescription);
NSLog(@"=============================");
}
}
代碼還是比較明了,先創建實例,設定總任務量為10,,然后配置KVO觀察,使用NSTimer模擬了一個每秒執行一次任務的情況,在任務方法中,只要沒做完任務就增加 completedUnitCount 屬性,這個屬性就表示當前已完成的任務量的。
在KVO的響應方法中,列出了三種進度表示方式,這都是原生支持的,分別對應三種顯示效果,如下圖:
多任務執行
所謂的多任務執行,是指 NSProgress 類可以添加多個子任務,分別占據主任務的一定比例,當然這個比例加起來是實例化時的總量,先看代碼:
@interface ViewController ()
@property (nonatomic, strong) NSProgress *progress;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor lightGrayColor];
self.progress = [NSProgress progressWithTotalUnitCount:10];
[self.progress addObserver:self forKeyPath:@"fractionCompleted" options:NSKeyValueObservingOptionNew context:nil];
// 第一個子任務
[self.progress becomeCurrentWithPendingUnitCount:5];
[self subTask];
[self.progress resignCurrent];// 必須與 becomeCurrentWithPendingUnitCount: 方法成對
// 第二個子任務
[self.progress becomeCurrentWithPendingUnitCount:5];
[self subTask];
[self.progress resignCurrent];// 必須與 becomeCurrentWithPendingUnitCount: 方法成對
}
- (void)subTask {
NSProgress *subProgress = [NSProgress progressWithTotalUnitCount:10];
while (subProgress.completedUnitCount < subProgress.totalUnitCount) {
subProgress.completedUnitCount ++;
}
}
#pragma mark - KVO
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary<NSKeyValueChangeKey,id> *)change context:(void *)context {
if ([keyPath isEqualToString:@"fractionCompleted"]) {
NSLog(@"進度表示形式1:%f", self.progress.fractionCompleted);
NSLog(@"進度表示形式2:%@", self.progress.localizedDescription);
NSLog(@"進度表示形式3:%@", self.progress.localizedAdditionalDescription);
NSLog(@"=============================");
}
}
這里我們安排了兩個子任務,所占的比例是五五開,要注意的是 becomeCurrentWithPendingUnitCount: 方法和 resignCurrent 必須成對出現,也就是說每個子任務都必須有,一個是創建子任務,一個是取消注冊。在中間執行子任務,從子任務的方法中也可以看出,子任務其實是另外一個新的 NSProgress 實例,在進行自己的任務,當然也可以對其進行 KVO 觀察,如有需要的話可以顯示子任務的進度,不過這里我們就只要完成子任務就行了。任務進行的情況如下圖,可以看到由于每個子任務都又安排了10的總量,而子任務占總任務的5/10,所以每次的進度是0.05:
iOS 9 多任務的新方式
其實上面這種多任務的開發方法很不方便,而且也不好理解,因此 iOS 9 提供了一種更加直觀、簡單的操作方式來進行多任務,代碼如下:
@interface ViewController ()
@property (nonatomic, strong) NSProgress *progress;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor lightGrayColor];
self.progress = [NSProgress progressWithTotalUnitCount:10];
[self.progress addObserver:self forKeyPath:@"fractionCompleted" options:NSKeyValueObservingOptionNew context:nil];
// 兩個子任務
NSProgress *sub1 = [NSProgress progressWithTotalUnitCount:10 parent:self.progress pendingUnitCount:4];
NSProgress *sub2 = [NSProgress progressWithTotalUnitCount:10 parent:self.progress pendingUnitCount:6];
for (int i = 0; i < 10; i++) {
sub1.completedUnitCount ++;
sub2.completedUnitCount ++;
}
}
#pragma mark - KVO
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary<NSKeyValueChangeKey,id> *)change context:(void *)context {
if ([keyPath isEqualToString:@"fractionCompleted"]) {
NSLog(@"進度表示形式1:%f", self.progress.fractionCompleted);
NSLog(@"進度表示形式2:%@", self.progress.localizedDescription);
NSLog(@"進度表示形式3:%@", self.progress.localizedAdditionalDescription);
NSLog(@"=============================");
}
}
可以看到這種方法直觀地多,只要直接創建子任務,設置 parent ,也就是父任務是誰,然后設置占任務的比例,就可以直接進行子任務了,這里的比例是四六開,同時子任務的總量也設為10,,因此兩個子任務應該分別占父任務的0.04和0.06,而因為兩個任務是同時進行的,因此效果如下:
結
以上,就是簡單的三個實例了,其實用起來還是蠻方便的,比自己去創建變量來記錄和計算要好多了,而且其用法還有很多,比如取消任務、暫停任務、繼續任務、添加子節點、設置進度顯示模式等等,有待在使用中慢慢摸索。
示例工程:https://github.com/Cloudox/NSProgressDemo