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

引言

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

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

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


image.png

多任務執(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:

image.png

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

image.png

以上颊咬,就是簡單的三個實例了务甥,其實用起來還是蠻方便的牡辽,比自己去創(chuàng)建變量來記錄和計算要好多了,而且其用法還有很多敞临,比如取消任務态辛、暫停任務、繼續(xù)任務挺尿、添加子節(jié)點奏黑、設置進度顯示模式等等,有待在使用中慢慢摸索编矾。


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


查看作者首頁

最后編輯于
?著作權歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末熟史,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子窄俏,更是在濱河造成了極大的恐慌蹂匹,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,941評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件凹蜈,死亡現(xiàn)場離奇詭異限寞,居然都是意外死亡,警方通過查閱死者的電腦和手機仰坦,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,397評論 3 395
  • 文/潘曉璐 我一進店門履植,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人悄晃,你說我怎么就攤上這事玫霎。” “怎么了传泊?”我有些...
    開封第一講書人閱讀 165,345評論 0 356
  • 文/不壞的土叔 我叫張陵鼠渺,是天一觀的道長。 經(jīng)常有香客問我眷细,道長,這世上最難降的妖魔是什么鹃祖? 我笑而不...
    開封第一講書人閱讀 58,851評論 1 295
  • 正文 為了忘掉前任溪椎,我火速辦了婚禮,結果婚禮上恬口,老公的妹妹穿的比我還像新娘校读。我一直安慰自己,他們只是感情好祖能,可當我...
    茶點故事閱讀 67,868評論 6 392
  • 文/花漫 我一把揭開白布歉秫。 她就那樣靜靜地躺著,像睡著了一般养铸。 火紅的嫁衣襯著肌膚如雪雁芙。 梳的紋絲不亂的頭發(fā)上轧膘,一...
    開封第一講書人閱讀 51,688評論 1 305
  • 那天,我揣著相機與錄音兔甘,去河邊找鬼谎碍。 笑死,一個胖子當著我的面吹牛洞焙,可吹牛的內(nèi)容都是我干的蟆淀。 我是一名探鬼主播,決...
    沈念sama閱讀 40,414評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼澡匪,長吁一口氣:“原來是場噩夢啊……” “哼熔任!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起唁情,我...
    開封第一講書人閱讀 39,319評論 0 276
  • 序言:老撾萬榮一對情侶失蹤笋敞,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后荠瘪,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體夯巷,經(jīng)...
    沈念sama閱讀 45,775評論 1 315
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,945評論 3 336
  • 正文 我和宋清朗相戀三年哀墓,在試婚紗的時候發(fā)現(xiàn)自己被綠了趁餐。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,096評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡篮绰,死狀恐怖后雷,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情吠各,我是刑警寧澤臀突,帶...
    沈念sama閱讀 35,789評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站贾漏,受9級特大地震影響候学,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜纵散,卻給世界環(huán)境...
    茶點故事閱讀 41,437評論 3 331
  • 文/蒙蒙 一梳码、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧伍掀,春花似錦掰茶、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,993評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至把兔,卻和暖如春沪伙,著一層夾襖步出監(jiān)牢的瞬間瓮顽,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,107評論 1 271
  • 我被黑心中介騙來泰國打工焰坪, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留趣倾,地道東北人。 一個月前我還...
    沈念sama閱讀 48,308評論 3 372
  • 正文 我出身青樓某饰,卻偏偏與公主長得像儒恋,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子黔漂,可洞房花燭夜當晚...
    茶點故事閱讀 45,037評論 2 355

推薦閱讀更多精彩內(nèi)容