RRViewControllerExtension,优雅地管理UINavigationBar及内存泄漏检测

RRViewControllerExtension是我在很久之前写的一个轻量级的UIViewController分类,并且已经在户外助手上得到了成熟的应用。
开发者只需要在Xcode工程中加入'RRViewControllerExtension'的代码,甚至都不需要#import任何头文件,就可以轻松地实现不同的UIViewController的导航栏UINavigationBar的“独立”管理,包括导航栏显示/隐藏、设置背景色、背景图片、背景透明、title颜色字体以及UINavigationItem颜色。
另外 RRViewControllerExtension还可以准确地实时监测每一个UIViewController是否存在内存泄漏。

其主要功能包括:

  • 优雅地管理各个视图 UINavigationBar 显示样式
  • UIViewController内存泄漏自动检测
  • push/pop 完成后block回调
  • UIViewController 生命周期方法hook
  • 其他UIViewController方便的接口方法

github 演示demo

预览

rrvc003.gif

安装

  1. CocoaPods安装
    在你工程文件的Podfile中加入
pod 'RRViewControllerExtension'
  1. 直接下载源码
    你还可以从这里 下载源码并将RRViewControllerExtension文件夹拖入你的xcode工程文件

注意:一些特定的功能使用需要引入头文件#import <RRViewControllerExtension.h>或者#import "RRViewControllerExtension.h"取决于你是源码导入还是cocopods导入。

使用

  • 导航栏UINavigationBar 不同显示样式管理

定制导航栏 UINavigationBar在不同UIViewController不同的显示样式 ,你只需要在vc的.m文件中实现以下方法(在UIViewController+RRExtension.h中定义的)中的任何一个或多个即可

//override any of the methods below in your viewcontroller's .m file to make specific navigation bar appearance
//当前界面导航栏是否隐藏
-(BOOL)prefersNavigationBarHidden;
//当前界面导航栏是否设置为透明(只是导航栏透明,navigationItem依然显示)
-(BOOL)prefersNavigationBarTransparent;
//导航栏背景色
-(nullable UIColor *)preferredNavatationBarColor;
//navigationItem颜色
-(nullable UIColor *)preferredNavigationItemColor;
//导航栏背景图片
-(nullable UIImage *)preferredNavigationBarBackgroundImage;
//title显示样式字典
-(nullable NSDictionary *)preferredNavigationTitleTextAttributes;
  • 设定导航栏UINavigationBar默认显示样式

在大部分情况下,我们并不需要去设置每一个viewcontroller的导航栏显示样式,只需让它们显示默认样式即可,设置默认样式有两种方式:

  1. 通过UINavigationBar appearance 设置
    UINavigationBar遵循UIAppearance协议,可以通过 [[UINavigationBar appearance] setXXX:] 设定导航栏UINavigationBar的全局默认显示样式,这种设置是全局性的,也就是说在你的app中所有的导航栏都采用这种默认显示样式。
[[UINavigationBar appearance] setBarTintColor:[UIColor colorWithRed:0 green:0.45 blue:0.8 alpha:1.0]];
[[UINavigationBar appearance] setTintColor:[UIColor redColor]];
NSDictionary * dict = [NSDictionary dictionaryWithObject:[UIColor yellowColor] forKey:NSForegroundColorAttributeName];
[[UINavigationBar appearance] setTitleTextAttributes:dict];
  1. 通过RRViewControllerExtension设置
    通过RRViewControllerExtensionUINavigationController+RRSet中定义的属性,设定每一个导航控制器导航栏UINavigationBar默认显示样式,这种设定针对的是每一个导航控制器实例对象,此时需要引入头文件RRViewControllerExtension.h
// set default navigation bar appearance
@property (nonatomic) BOOL defaultNavigationBarHidden;
@property (nonatomic) BOOL defaultNavigationBarTransparent;

@property (nonatomic,copy) UIColor *defaultNavatationBarColor;
@property (nonatomic,copy) UIColor *defaultNavigationItemColor;
@property (nonatomic,strong) UIImage *defaultNavigationBarBackgroundImage;
@property (nonatomic,copy) NSDictionary *defaultNavigationTitleTextAttributes;

动态修改导航栏显示

坑爹的产品经常会给我们出这样的需求,根据scrollView的滚动高度,来隐藏/显示导航栏,或者把导航栏设置成透明样式,改变导航栏按钮颜色等待,凡此种种操作,现在都能轻松应对;程序员只要在对应的方法中,根据不同的状态返回不同的值,然后再达到触发条件的时候,调用

 [self updateNavigationAppearance:YES];

举个栗子:


    //typically in your UIScrollViewDelegate method
    - (void)scrollViewDidScroll:(UIScrollView *)scrollView
    {
        BOOL mode;
        if(scrollView.contentOffset.y > 300)
            mode = NO;
        else
            mode = YES;

        if(mode != _previewMode)
        {
            _previewMode = mode;

            //force navigation appearance update
            [self updateNavigationAppearance:YES];
        }
    }
    
    -(BOOL)prefersNavigationBarTransparent
    {
        if(_previewMode)
            return NO;
        else
            return YES;
    }
    
    -(nullable UIColor *)preferredNavigationItemColor
    {
        if(_previewMode)
            return [UIColor whiteColor];
        else
            return [UIColor blackColor];;
    }

智能内存泄漏检测

该功能默认只在debug模式下开启

只需要将RRViewControllerExtension加入到你的xcode工程当中,就可以实现viewcontroller内存泄漏的检测,一旦viewcontroller在消失后内存空间没有被释放,在你的app当中就会弹出内存泄漏警告提醒,如下图

内存泄漏监测.png

某些特定的viewcontroller我们并不希望它在消失后马上销毁,而是可以留着复用,比如微信的朋友圈就这样做的(我的必问面试题),这种情况我们并不希望将其认定为内存泄漏,RRViewControllerExtension提供的方法可以指定某一“个”viewcontroller实例或者某一“类”viewcontroller不参与内存泄漏监测

//Unavailable in release mode. in debug mode, defalut is NO for classes returned from +memoryLeakDetectionExcludedClasses method and YES for others
//当前viewController是否开启内存泄漏检测
@property (nonatomic,getter = memoryLeakDetectionEnabled) BOOL enabledMemoryLeakDetection;

//read and add or remove values from the returned set to change default excluded memory detection classes
//将你不希望参与内存泄漏检测的类添加到这个读取的set里面
+(NSMutableSet<NSString *> *)memoryLeakDetectionExcludedClasses;

//for subclass to override
//当发生内存泄漏时收到消息方法回调,子类可以重写
-(void)didReceiveMemoryLeakWarning;

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 198,932评论 5 466
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,554评论 2 375
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 145,894评论 0 328
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,442评论 1 268
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,347评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 47,899评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,325评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,980评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,196评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,163评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,085评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,826评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,389评论 3 302
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,501评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,753评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,171评论 2 344
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,616评论 2 339

推荐阅读更多精彩内容