iOS進度管理NSProgress類簡單實用實例

引言

iOS 7 之后蘋果推出了一個新的類 NSProgress 專門用來管理進度,比如在下載數據或者執行任務的時候要顯示進度,那么這個類就可以很方便地對進度進行管理,供開發者拿去控制表示進度的UI界面。

這個類的用法其實很簡單,總結起來就是下面幾個步驟:

  1. 創建實例,同時設定表示任務要完成的數量的總值(這個總值只是一個用來計算比例的概念);
  2. 配置KVO觀察其進度的變化,從而對UI做出更新(NSProgress 類就是搭配 KVO 來操作的,關于 KVO 是什么可以看我這篇博客:iOS鍵值觀察KVO實例詳解);
  3. 執行任務,在執行過程中遞增表示已完成任務量的屬性(這個屬性用來判斷任務完成情況,供計算比例以及是否完成任務);
  4. 在 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的響應方法中,列出了三種進度表示方式,這都是原生支持的,分別對應三種顯示效果,如下圖:


image.png

多任務執行

所謂的多任務執行,是指 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:

image.png

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,而因為兩個任務是同時進行的,因此效果如下:

image.png

以上,就是簡單的三個實例了,其實用起來還是蠻方便的,比自己去創建變量來記錄和計算要好多了,而且其用法還有很多,比如取消任務、暫停任務、繼續任務、添加子節點、設置進度顯示模式等等,有待在使用中慢慢摸索。


示例工程:https://github.com/Cloudox/NSProgressDemo


查看作者首頁

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,885評論 6 541
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,312評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,993評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,667評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,410評論 6 411
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,778評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,775評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,955評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,521評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,266評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,468評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,998評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,696評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,095評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,385評論 1 294
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,193評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,431評論 2 378

推薦閱讀更多精彩內容