引言
iOS 7 之后蘋果推出了一個新的類 NSProgress 專門用來管理進度论泛,比如在下載數(shù)據(jù)或者執(zhí)行任務的時候要顯示進度,那么這個類就可以很方便地對進度進行管理,供開發(fā)者拿去控制表示進度的UI界面牍戚。
這個類的用法其實很簡單,總結起來就是下面幾個步驟:
- 創(chuàng)建實例氓奈,同時設定表示任務要完成的數(shù)量的總值(這個總值只是一個用來計算比例的概念)翘魄;
- 配置KVO觀察其進度的變化鼎天,從而對UI做出更新(NSProgress 類就是搭配 KVO 來操作的舀奶,關于 KVO 是什么可以看我這篇博客:iOS鍵值觀察KVO實例詳解);
- 執(zhí)行任務斋射,在執(zhí)行過程中遞增表示已完成任務量的屬性(這個屬性用來判斷任務完成情況育勺,供計算比例以及是否完成任務);
- 在 KVO 的響應方法中對UI進行更新操作罗岖,改變UI顯示的當前進度值涧至。
就這么多了,具體的用法我們舉三個例子:單任務的執(zhí)行桑包、多任務的執(zhí)行南蓬、以及 iOS 9 下新的多任務執(zhí)行方法。
單任務執(zhí)行
直接上代碼:
@interface ViewController ()
@property (nonatomic, strong) NSProgress *progress;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor lightGrayColor];
// 創(chuàng)建實例
self.progress = [NSProgress progressWithTotalUnitCount:10];
// 配置KVO觀察
[self.progress addObserver:self forKeyPath:@"fractionCompleted" options:NSKeyValueObservingOptionNew context:nil];
// 每秒執(zhí)行一次任務
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(@"=============================");
}
}
代碼還是比較明了哑了,先創(chuàng)建實例赘方,設定總?cè)蝿樟繛?0,,然后配置KVO觀察弱左,使用NSTimer模擬了一個每秒執(zhí)行一次任務的情況窄陡,在任務方法中,只要沒做完任務就增加 completedUnitCount 屬性拆火,這個屬性就表示當前已完成的任務量的跳夭。
在KVO的響應方法中涂圆,列出了三種進度表示方式,這都是原生支持的币叹,分別對應三種顯示效果润歉,如下圖:
多任務執(zhí)行
所謂的多任務執(zhí)行,是指 NSProgress 類可以添加多個子任務颈抚,分別占據(jù)主任務的一定比例卡辰,當然這個比例加起來是實例化時的總量,先看代碼:
@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 必須成對出現(xiàn)瘾婿,也就是說每個子任務都必須有赢织,一個是創(chuàng)建子任務,一個是取消注冊红省。在中間執(zhí)行子任務策菜,從子任務的方法中也可以看出晶疼,子任務其實是另外一個新的 NSProgress 實例,在進行自己的任務又憨,當然也可以對其進行 KVO 觀察翠霍,如有需要的話可以顯示子任務的進度,不過這里我們就只要完成子任務就行了蠢莺。任務進行的情況如下圖寒匙,可以看到由于每個子任務都又安排了10的總量,而子任務占總?cè)蝿盏?/10躏将,所以每次的進度是0.05:
iOS 9 多任務的新方式
其實上面這種多任務的開發(fā)方法很不方便锄弱,而且也不好理解,因此 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(@"=============================");
}
}
可以看到這種方法直觀地多,只要直接創(chuàng)建子任務蚯窥,設置 parent 掸鹅,也就是父任務是誰,然后設置占任務的比例拦赠,就可以直接進行子任務了巍沙,這里的比例是四六開,同時子任務的總量也設為10,矛紫,因此兩個子任務應該分別占父任務的0.04和0.06赎瞎,而因為兩個任務是同時進行的,因此效果如下:
結
以上颊咬,就是簡單的三個實例了务甥,其實用起來還是蠻方便的牡辽,比自己去創(chuàng)建變量來記錄和計算要好多了,而且其用法還有很多敞临,比如取消任務态辛、暫停任務、繼續(xù)任務挺尿、添加子節(jié)點奏黑、設置進度顯示模式等等,有待在使用中慢慢摸索编矾。
示例工程:https://github.com/Cloudox/NSProgressDemo