iOS开发代码规范(通用)

2018-06-11  本文已影响0人  雾中探雪
1. 关于命名

1> 统一要求

2. 私有方法及变量声明

1> 声明位置
  在.m文件中最上方,定义空的category进行声明
   例子:

#import "CodeStandardViewController.h"
    // 在这个category(类目)中定义变量和方法
    @interface CodeStandardViewController ()
    {

// 声明私有变量
    }

// 私有方法
    - (void)samplePrivateMethod;
    @end

@implementation CodeStandardViewController
    // 私有方法的实现
    - (void)samplePrivateMethod
    {
      //some code
    }

3. 关于注释

最好的代码是不需要注释的 尽量通过合理的命名
 良好的代码把含义表达清楚 在必要的地方添加注释
 注释需要与代码同步更新
 如果做不到命名尽量的见名知意的话,就可以适当的添加一些注释或者mark
 1> 属性注释
  例子:
    /// 学生
    @property (nonatomic, strong) Student student;
 2> 方法声明注释:

/
*
  * @brief 登录验证
  *
  * @param personId 用户名
  * @param password 密码
  * @param complete 执行完毕的block
  *
  * @return
  */
  + (void)loginWithPersonId:(NSString *)personId password:(NSString *)password complete:(void (^)(CheckLogon *result))complete;

4. 关于UI布局

使用Interface Builder进行界面布局
 Xib文件的命名与其对应的.h文件保持相同
 Xib文件中控件的组织结构要合理,Xib文件中控件需要有合理的可读性强的命名,方便他人理解

5. 格式化代码

1> 指针 "" 位置
  定义一个对象时,指针 "
" 靠近变量
   例子: NSString *userName;
 2> 方法的声明和定义
  在 - 、+ 和 返回值 之间留一个空格,方法名和第一个参数之间不留空格

pragma mark - private methods

- (void)samplePrivateMethod
  {...}

- (void)sampleForIf
  {...}

- (void)sampleForWhile
  {...}
  
  - (void)sampleForSwitch
  {...}

- (void)wrongExamples
  {...}

#pragma mark - public methods
  - (void)samplePublicMethodWithParam:(NSString*)sampleParam
  {...}

#pragma mark - life cycle methods
  - (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil
  {...}

- (void)viewDidLoad
  {...}

- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation
  {...}

 5> 大括号写法

return self;
}

上一篇 下一篇

猜你喜欢

热点阅读