iOS 指定初始化方法

级别： ★☆☆☆☆
标签：「NS_DESIGNATED_INITIALIZER 」「NS_UNAVAILABLE」「iOS指定初始化方法」
作者： WYW
审校： QiShare团队

前言：笔者最近了解了部分SDK开发相关的内容，在涉及指定视图控制器（下文用VC代指视图控制器）的初始化方法的时候，遇到了一些问题。这里笔者给大家分享下设置方法，如有不同见解，敬请指教。

笔者遇到的问题如下：

笔者希望使用SDK的业务能够使用 SDK中确定的初始化VC的方法；
下边笔者以需要传入VC的导航栏标题并初始化相应VC为例，来阐明相关问题。
对于上述情况，有多种处理方式，如：

在SDK暴露的头文件中，文字说明，用哪个初始化方法；在文档中说明，用哪个初始化方法；在提供的Demo中，写明相应地示例代码。

利用系统给的宏NS_DESIGNATED_INITIALIZER指定vc初始化方法
指定初始化方法部分，可以使用宏NS_DESIGNATED_INITIALIZER指定，那么如果业务没有看SDK头文件，直接使用new 或者 alloc init的方式指定初始化方法，那么我们初始化VC所需的导航栏标题就不能得以正常传入。

对于这种情况，我们可以提供如下3种方法：

把不想业务使用的初始化方法，使用系统宏 NS_UNAVAILABLE 把相应初始化方法设置为不可用；如禁用new ，这样的效果是：业务如果想使用new 初始化VC，会发现有错误提示，使用这种方法比较简单。

对于不想业务使用的初始化方法，在实现文件中，实现相应的方法，并且给予默认值。比如说对于初始化VC的导航栏标题的情况，给定默认标题为defaultNavigationTitle。不过这种初始化方法，不适用传入重要参数的情况，不然业务会觉得怪怪的。另外这种方式，以后如果有相关改动，可能改动代码会较多。

对于不想业务使用的初始化方法，在实现文件中，实现相应的方法，并且抛出崩溃，并且指定崩溃原因，在崩溃原因中说明应该使用的初始化VC的方法。对于这种方式，如果以后有改动，可能改动代码会较多。
相比如上三种处理方式，笔者更倾向于使用第一种，如果你有其他见解，欢迎讨论。

下边我们仍以初始化VC时，指定传入导航栏标题为例，贴上相关的示例代码。

第一种方式：

// .h 文件

- (instancetype)initWithSomething:(id)someThing NS_DESIGNATED_INITIALIZER;

- (instancetype)initWithNibName:(nullable NSString *)nibNameOrNil bundle:(nullable NSBundle *)nibBundleOrNil NS_UNAVAILABLE;
- (instancetype)initWithCoder:(NSCoder *)aDecoder NS_UNAVAILABLE;
- (instancetype)init NS_UNAVAILABLE;
+ (instancetype)new NS_UNAVAILABLE;

// .m 文件

/*! @brief 导航栏title */
@property (nonatomic, copy) NSString *navTitle;


- (instancetype)initWithSomething:(id)someThing {
    // Cannot assign to 'self' outside of a method in the init family
    // 指定初始化方法需要以 1. init开头 2. 并且init后边紧挨着地字母是大写的
    self = [super initWithNibName:nil bundle:nil];
    if (!self) {
        return nil;
    }
    _navTitle = someThing;
    [self commonInit];
    return self;
}

- (void)commonInit {
    
    self.navigationItem.title = _navTitle;
}

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.view.backgroundColor = [UIColor whiteColor];
}

第二种方式：

.h
- (instancetype)initWithSomething:(id)someThing;

// .m 文件

/*! @brief 导航栏title */
@property (nonatomic, copy) NSString *navTitle;


- (instancetype)initWithSomething:(id)someThing {
    
    self = [super init];
    if (!self) {
        return nil;
    }
    _navTitle = someThing;
    return self;
}

- (instancetype)init {
    
    self = [super init];
    if (!self) {
        return nil;
    }
    [self commonInit];
    return self;
}

- (instancetype)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {
    
    self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
    if (!self) {
        return nil;
    }
    [self commonInit];
    return self;
}

- (instancetype)initWithCoder:(NSCoder *)aDecoder {
    
    self = [super initWithCoder:aDecoder];
    if (!self) {
        return nil;
    }
    [self commonInit];
    return self;
}

- (void)commonInit {
    
    _navTitle = @"Default";
}

- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.navigationItem.title = _navTitle;
    self.view.backgroundColor = [UIColor whiteColor];
}

第三种方式：

// .h 文件
- (instancetype)initWithSomething:(id)someThing;

// .m 文件
static NSString *const kExceptionName = @"初始化方法有误";
static NSString *const kExceptionReason = @"请使用initWithSomething:进行初始化";

/*! @brief 导航栏title */
@property (nonatomic, copy) NSString *navTitle;


- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.navigationItem.title = _navTitle;
    self.view.backgroundColor = [UIColor whiteColor];
}

+ (instancetype)new {
    
    @throw [[self class] initExceptioin];
    return nil;
}

- (instancetype)init {
    
    @throw [[self class] initExceptioin];
    return nil;
}

- (instancetype)initWithCoder:(NSCoder *)aDecoder {
    
    @throw [[self class] initExceptioin];
    return nil;
}

- (instancetype)initWithSomething:(id)someThing {
    
    self = [super init];
    if (!self) {
        return nil;
    }
    _navTitle = someThing;
    
    return self;
}

+ (NSException *)initExceptioin {
    
    return [NSException exceptionWithName:kExceptionName reason:kExceptionReason userInfo:nil];
}

Demo：

Demo：QiDesignatedInitializer

参考学习网址

iOS指定初始化方法
iOS指定初始化方法的正确使用姿势
Effective Objective-C 2.0：编写高质量iOS与OS X代码的52个有效方法

推荐文章：
UIView中的hitTest方法
 iOS关于tabBar的几处笔记
 A的女儿是B的女儿的妈妈，A是B的谁？
算法小专栏：选择排序
 iOS Runloop（一）
iOS 常用调试方法：LLDB命令
 iOS 常用调试方法：断点
 iOS 常用调试方法：静态分析