美文网首页
iOS中的编程规范

iOS中的编程规范

作者: Easy_VO | 来源:发表于2016-03-18 08:52 被阅读105次

    通用的约定

    尽可能遵守 Apple 的命名约定,
    推荐使用长的、描述性的方法和变量名。
    

    通用约定:

    UIButton *shareButton;
    不推荐:
    UIButton *shareBut;
    //常量应该以驼峰法命名,并以相关类名作为前缀。
    static const NSTimeInterval ZOCSignInViewControllerFadeOutAnimationDu    
    ration = 0.4;
    推荐使用常量来代替字符串字面值和数字,
    这样能方便复用,而且还可以快速的修改,替换。
    常量应该用static来声明为静态常量,而不要用#define,除非它明确的作为一个宏来使用。
    static AppName @"最适码"
    不推荐:
    #define AppName @"最适码"
    常量应该以如下方式暴露给外部:
    extern NSString *const AppName;
    并在实现文件中为它赋值。
    

    方法

     方法名与方法类型 (-/+ 符号)之间应该以空格间隔。
    方法段之间也应该以空格间隔。
    - (id)viewWithTag:(NSInteger)tag;
    

    字面值

    使用字面值来创建不可变的 NSString, NSDictionary, NSArray,
     和 NSNumber 对象。
    注意不要将 nil 传进 NSArray 和 NSDictionary 里,因为这样会导致崩溃。
    NSDictionary *productManagers = @{@"iPhone" : @"Kate", @"iPad" : @"Kamal", @"Mobile Web" : @"Bill"};
    NSNumber *shouldUseLiterals = @YES;
    //不要这样
    NSDictionary *productManagers = [NSDictionary dictionaryWithObjectsAndKeys: @"Kate", @"iPhone", @"Kamal", @"iPad", @"Bill", @"Mobile Web", nil];
    NSNumber *shouldUseLiterals = [NSNumber numberWithBool:YES];
    

    类名应该以三个大写字母作为前缀(双字母前缀为 Apple 的类预留)。
    尽管这个规范看起来有些古怪,但是这样做可以减少 Objective-c 没有命名空间所带来的问题。
    

    Initializer 和 dealloc

    推荐的代码组织方式是将 dealloc 方法放在实现文件的最前面
    (直接在 @synthesize 以及 @dynamic 之后),init 应该跟在 dealloc 方法后面。
    如果有多个初始化方法, 指定初始化方法 (designated initializer) 应该放在最前面,
    间接初始化方法 (secondary initializer) 跟在后面,
    这样更有逻辑性。如今有了 ARC,dealloc 方法几乎不需要实现,
    不过把 init 和 dealloc 放在一起可以从视觉上强调它们是一对的。
    通常,在 init 方法中做的事情需要在 dealloc 方法中撤销。
    

    init 方法应该是这样的结构:

    - (instancetype)init
    {
        self = [super init]; // call the designated initializer
        if (self) {
            // Custom initialization
        }
        return self;
    }
    
    为什么设置 self 为 [super init] 的返回值,以及中间发生了什么呢?这是一个十分有趣的话题。
    我们退一步讲:我们常常写 [[NSObject alloc] init] 这样的代码,从而淡化了 alloc 和 init 的区别。Objective-C 的这个特性叫做 两步创建 。
    这意味着申请分配内存和初始化被分离成两步,alloc 和 init。
    alloc 负责创建对象,这个过程包括分配足够的内存来保存对象,
    写入 isa 指针,初始化引用计数,以及重置所有实例变量。
     init 负责初始化对象,这意味着使对象处于可用状态。
    这通常意味着为对象的实例变量赋予合理有用的值。
     alloc 方法将返回一个有效的未初始化的对象实例。
    每一个对这个实例发送的消息会被转换成一次 objc_msgSend() 函数的调用,
    形参 self 的实参是 alloc 返回的指针;这样 self 在所有方法的作用域内都能够被访问。
    

    按照惯例,为了完成两步创建,新创建的实例第一个被调用的方法将是 init 方法。注意,NSObject 在实现 init 时,只是简单的返回了 self。
    关于 init 的约定还有一个重要部分:这个方法可以(并且应该)通过返回 nil 来告诉调用者,初始化失败了;初始化可能会因为各种原因失败,比如一个输入的格式错误了,或者另一个需要的对象初始化失败了。 这样我们就能理解为什么总是需要调用 self = [super init]。如果你的父类说初始化自己的时候失败了,那么你必须假定你正处于一个不稳定的状态,因此在你的实现里不要继续你自己的初始化并且也返回 nil。如果不这样做,你可能会操作一个不可用的对象,它的行为是不可预测的,最终可能会导致你的程序崩溃。
    init 方法在被调用的时候可以通过重新给 self 重新赋值来返回另一个实例,而非调用的那个实例。例如类簇,还有一些 Cocoa 类为相等的(不可变的)对象返回同一个实例。

    单例

    如果可能,请尽量避免使用单例而是依赖注入。 然而,如果一定要用,请使用一个线程安全的模式来创建共享的实例。对于 GCD,用 dispatch_once() 函数就可以咯
    + (instancetype)sharedInstance
    {
    static id sharedInstance = nil;
    static dispatch_once_t onceToken = 0;
    dispatch_once(&onceToken, ^{
    sharedInstance = [[self alloc] init];
    });
    return sharedInstance;
    }
    使用 dispatch_once(),来控制代码同步,取代了原来的约定俗成的用法。
    dispatch_once()
    的优点是,它更快,而且语法上更干净,因为dispatch_once()的意思就是 “把一些东西执行一次”,就像我们做的一样。 这样同时可以避免 possible and sometimes prolific crashes.
    经典的单例对象是:一个设备的GPS以及它的加速度传感器(也称动作感应器)。
    虽然单例对象可以子类化,但这种方式能够有用的情况非常少见。
    必须有证据表明,给定类的接口趋向于作为单例来使用。
    所以,单例通常公开一个sharedInstance的类方法就已经足够了,
    没有任何的可写属性需要被暴露出来。

    属性

    NSString *text;
    不要这样 :
     NSString* text;NSString * text;
    

    点符号

    当使用 setter getter 方法的时候尽量使用点符号。应该总是用点符号来访问以及设置属性。
    
    view.backgroundColor = [UIColor orangeColor];
    [UIApplication sharedApplication].delegate;
    不要这样
    [view setBackgroundColor:[UIColor orangeColor]];UIApplication.sharedApplication.delegate;
    

    方法

    参数断言
     你的方法可能要求一些参数来满足特定的条件(比如不能为nil),
    在这种情况下啊最好使用 NSParameterAssert() 来断言条件是否成立或是抛出一个异常。
    

    私有方法

    永远不要在你的私有方法前加上 _ 前缀。
    这个前缀是 Apple 保留的。不要冒重载苹果的私有方法的险。
    

    相关文章

      网友评论

          本文标题:iOS中的编程规范

          本文链接:https://www.haomeiwen.com/subject/ccgclttx.html