• iOS代码规范


    命名规范

    类命名

    l   首字母大写,之后每个单词首字母都大写

    l   使用能够反映类功能的名词短语

    l   文件和类同名

    l   举例:BaseClient、ImageStore

    特殊类命名

    l   如果是视图控制器的子类应添加后缀“ViewController”或者“Controller”

    l   如果是视图的子类应添加后缀“View”

    l   如果是按钮的子类应添加后缀“Button”

    ……

    l   举例:SettingsViewController、NavigationView

    分类(类别)命名

    l   与类命名相同,此外需添加要扩展的类名和“+”

    l   举例:NSString+URLEncoding

    协议(委托)命名

    l   与类命名相同,此外需添加“Delegate”后缀

    l   举例:ReplyViewDelegate

    方法命名

    l   首字母小写,之后每个单词首字母都大写

    l   方法名使用动词短语

    l   举例:- (void)setPostValue:(int)value

    方法参数命名

    l   首字母小写,之后每个单词首字母都大写

    l   具有足够的说明性

    l   不需要添加类型前缀

    l   举例:- (void)sendUserInfo:(NSDictionary *)userInfo

    变量命名

    l   首字母小写,之后每个单词首字母都大写

    l   具有足够的说明性

    l   成员变量不需要添加“_m”前缀

    l   成员变量添加“_”前缀

    常量

    l   常量(预定义,局部常量等)使用小写k开头的驼峰法

    l   举例:kInvalidHandle , kWritePerm

    l   枚举类型命名首字母大写,之后每个单词首字母都大写,最后加“s

    l   枚举变量使用枚举类型去掉“s”作为前缀,每个单词首字母大写,中间不允许加下划线

    l   举例:

    typedef enum UIControlEvents{

    UIControlEventTouchDown,

    UIControlEventTouchUpInside

    }UIControlEvents;

    图片命名

    l   使用英文,首字母大写,之后每个单词首字母都大写

    l   添加模块名作为前缀,避免冲突

    l   图片应该与类文件一样,按模块分组放置

    分组命名

    l   使用英文,首字母大写,之后每个单词首字母都大写

    l   每个分组使用模块的名字

    l   使用的开源库统一放在“Library”分组下

    l   使用的公共组件统一放在“Common”分组下

    l   视图控制器及AppDelegate统一放在“Controllers”分组下

    书写规范

    注释

    l   文件都包含文件头,要说明文件名、作者、创建时间、变更记录

    l   多人协作完成项目时,public接口的每个方法都应该添加关于函数,参数,返回值以及副作用的注释

    l   if语句的判断条件复杂时,需要用注释说明判断内容

    l   接口类(继承于BaseClient)的头文件每个方法前都应该注明方法的作用

    方法

    l   留一个空格在-或+和返回类型之间,但参数列表里的参数之间不要留间隔,每个冒号之前都必须有对该参数的说明词,如:

    p - (void)doSomethingWithString:(NSString *)string number:(int)num

    l   如果参数过多,推荐每个参数各占一行。使用多行的情况下,在参数前加冒号用于对齐,如:

    p  -(void)doSomethingWith:(GTMFoo *)theFoo

                                              rect:(NSRect)theRect

                                 interval:(float)theInterval

    其他规范

    l   操作符前后都要加空格

    l   避免相同的代码段在多个地方出现

    l   语句嵌套层次不得超过3层

    l   每个实现文件建议在500行以内,不能超过1000,超过之后应考虑通过抽象类对代码进行重构

    l   及时删除或注释掉无用的代码

    l   UITableViewCell里面的network client都要委托出来

    l   点击按钮之后需要切换按钮图片,当这两张图片没有关联时(例如一张图片相比另一张图片有选中效果),不应该设置为UIControlSelected

    l   控件布局使用相对坐标

    l   确定不使用的代码应该删除

  • 相关阅读:
    关于MySQL数据库中null的那些事
    Java集合之Collections 剖析
    字符串类
    C++标准库
    << 操作符
    操作符的重载
    类中的重载
    友元
    二阶构造模式
    静态成员函数
  • 原文地址:https://www.cnblogs.com/yangyuxiaozi/p/3770711.html
Copyright © 2020-2023  润新知