MBProgressHUD源码分析

一. 模式

首先, MBProgressHUD有以下几种视图模式.

typedef enum {
    /** 默认模式,使用系统自带的指示器 ,不能显示进度,只能不停地转呀转*/
    MBProgressHUDModeIndeterminate,
    /** 用饼图显示进度 */
    MBProgressHUDModeDeterminate,
    /** 进度条 */
    MBProgressHUDModeDeterminateHorizontalBar,
    /** 圆环 */
    MBProgressHUDModeAnnularDeterminate,
    /** 自定义视图 */
    MBProgressHUDModeCustomView,
    /** 只显示文字 */
    MBProgressHUDModeText
} MBProgressHUDMode;
明出处。

饼图.gif

圆环.gif

二.MBProgressHUD子控件

1.backgroundView 整个背景图层，可以通过MBBackgroundView的style属性设置样式。跟系统有关
2.bezel视图，提供indicator、label、detailLabel、button的背景，用来突出显示 这个可以通过animationType属性设置动画效果，其实也是可选的，当mode值为MBProgressHUDModeText时，只有文本提示
3.indicator控件，指示器显示进度情况 这个视图由我们设定的mode属性决定，可以是菊花、进度条，也可以是我们自定义的视图
4.label控件，显示简要提示 （可选）
5.detailLabel控件，显示详细提示 （可选）
6.button按钮控件，提供中间控制动作，注意：button这个按钮只有在添加响应事件时才显示 （可选）

初始化

commonInit

- (void)commonInit {
    //设置所需的子view 注意此时各个view的位置大小还未确定
    [self setupViews]; 
     //设置指示器样式
    [self updateIndicators]; 
     //注册系统通知
    [self registerForNotifications];
}

这个函数里面又调用了三个函数setupViews、updateIndicators、registerForNotifications，这三个函数的主要作用上面代码注释都说明了。特别注意的是setupViews函数返回时，各个view的位置大小还未确定

updateConstraints，这个函数主要作用是更新一下各个控件的布局,
使用自动布局AutoLayout的技术

绘制

进度条
MBBarProgressView，
MBRoundProgressView通过
drawRect进行绘制，,都是使用Quartz2D进行绘图.

progress进度的更新

1.用户更新progress属性

2.由于progress被监听,触发KVO,调用- observeValueForKeyPath:ofObject:change:context:

3.observeValueForKeyPath:ofObject:change:context:中调用了setNeedsDisplay,标识视图为需要重新绘制.

4.调用drawRect:重绘,进度条更新

显示

HUD使用的三个Timer

//宽限时间，在graceTime之后才显示HUD。此值默认是0，直接显示
//执行一次：在show方法触发后到HUD真正显示之前,前提是设定了graceTime，默认为0
@property (nonatomic, weak) NSTimer *graceTimer; 

//HUD最小显示时间，在执行短时任务时可以设置这个值控制HUD的显示时间
//执行一次：在HUD显示后到HUD被隐藏之前
@property (nonatomic, weak) NSTimer *minShowTimer;

@property (nonatomic, weak) NSTimer *hideDelayTimer;//执行一次：在HUD被隐藏的方法触发后到真正隐藏之前

• graceTimer：用来推迟HUD的显示。如果设定了graceTime，那么HUD会在show方法触发后的graceTime时间后显示。它的意义是：如果任务完成所消耗的时间非常短并且短于graceTime，则HUD就不会出现了，避免HUD一闪而过的差体验。

• minShowTimer：如果设定了minShowTime，就会在hide方法触发后判断任务执行的时间是否短于minShowTime。因此即使任务在minShowTime之前完成了，HUD也不会立即消失，它会在走完minShowTime之后才消失，这应该也是避免HUD一闪而过的情况。

• hideDelayTimer：用来推迟HUD的隐藏。如果设定了delayTime，那么在触发hide方法后HUD也不会立即隐藏，它会在走完delayTime之后才隐藏。

show系列方法：
- (void)showUsingAnimation:(BOOL)animated {
    // Cancel any previous animations
    [self.bezelView.layer removeAllAnimations];
    [self.backgroundView.layer removeAllAnimations];

    // Cancel any scheduled hideDelayed: calls
    [self.hideDelayTimer invalidate];

     //记录开始的时间
    self.showStarted = [NSDate date];
    self.alpha = 1.f;

    // Needed in case we hide and re-show with the same NSProgress object attached.
  //设置以CADisplayLink为基准的刷新，注意这里并不是所有的进度条都是以CAD来刷新的，只有设置了 progressObject 的才会使用
    [self setNSProgressDisplayLinkEnabled:YES];

    if (animated) {
        [self animateIn:YES withType:self.animationType completion:NULL];
    } else {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdeprecated-declarations"
        self.bezelView.alpha = self.opacity;
#pragma clang diagnostic pop
        self.backgroundView.alpha = 1.f;
    }
}

其中两个方法 setNSProgressDisplayLinkEnabled: 和 animateIn:withType:completion: 方法，

一个用来设置 progressObject 进度（注意，不是所有进度变化都会用到这个方法），一个用来自定义展示动画。

- (void)setNSProgressDisplayLinkEnabled:(BOOL)enabled {
    // We're using CADisplayLink, because NSProgress can change very quickly and observing it may starve the main thread,
    // so we're refreshing the progress only every frame draw
    if (enabled && self.progressObject) {
        // Only create if not already active.
        if (!self.progressObjectDisplayLink) {
            self.progressObjectDisplayLink = [CADisplayLink displayLinkWithTarget:self selector:@selector(updateProgressFromProgressObject)];
        }
    } else {
        self.progressObjectDisplayLink = nil;
    }
}

- (void)updateProgressFromProgressObject {
    self.progress = self.progressObject.fractionCompleted;
}

之所以说是设置 progressObject的进度，是因为显示的进度是以 _progress 为准的。如果你仔细看上面的 drawRect: 方法，就能发现所有的图形都是以 _progress显示的。那么这里的 progressObject
有什么用呢？如果使用了 progressObject，那么就会创建一个 CADisplayLink实例。CADisplayLink适合于高精度的定时刷新，具体使用方法可见：CADisplayLink 方式的定时器

隐藏方法

- (void)hideAnimated:(BOOL)animated {
    MBMainThreadAssert();
    [self.graceTimer invalidate];
    self.useAnimation = animated;
    self.finished = YES;
    // If the minShow time is set, calculate how long the HUD was shown,
    // and postpone the hiding operation if necessary
    if (self.minShowTime > 0.0 && self.showStarted) {
        NSTimeInterval interv = [[NSDate date] timeIntervalSinceDate:self.showStarted];
        if (interv < self.minShowTime) {
            NSTimer *timer = [NSTimer timerWithTimeInterval:(self.minShowTime - interv) target:self selector:@selector(handleMinShowTimer:) userInfo:nil repeats:NO];
            [[NSRunLoop currentRunLoop] addTimer:timer forMode:NSRunLoopCommonModes];
            self.minShowTimer = timer;
            return;
        } 
    }
    // ... otherwise hide the HUD immediately
    [self hideUsingAnimation:self.useAnimation];
}

这个方法的解构和上面的 show 类似，其中 minShowTime 表示最少显示的时间，避免加载太快，hud 一闪而过的情况出现

https://zhang759740844.github.io/2017/02/21/MBProgressHUD%E6%BA%90%E7%A0%81%E8%A7%A3%E6%9E%90/
http://www.jianshu.com/p/6a5bd5fd8124
http://www.jianshu.com/p/f85e625e2df6
http://kittenyang.com/cadisplaylinkanduibezierpath/