iOS编码规范整理(供参考)

作者: 小曼blog | 来源:发表于2017-06-27 09:54 被阅读89次

每个公司甚至每个程序员都有自己的一套编码习惯,个体不同,风格自然是迥异的,为了项目的代码质量,团队往往会制定自己的编码规范。这是我们整理的编码规范,发表出来供大家参考哟。
iOS 编码规范
时间:2017-05-10 版本:1.0

前言:规范的编码可以避免很多问题,提高项目的稳定性,也增加了易读性和可维护性,所以,现在初步建立一套编码规范,之后再逐步完善。

1、命名规范
原则:
1)可读性高;
2)防止命名冲突;

类的命名
命名规范:
类名首字母大写,遵循OC语言的命名规范。类名要有实际的意义,如果类名太长,可
以省略一些不影响实际意义的单词,稍作简写。例如:
HomePageItemViewController ——> HomePageItemController
省略中间的view,大家依然知道它是一个VC,并不影响实际意义和可读性。
命名规则:
文件夹名字——类名——所属MVC类型结尾
例如:
HomeDetailViewController,————控制器
HomeDetailCell,————————-视图显示器
HomeDetailModel————————数据模型

变量命名
变量名称要有实际意义;
变量命名遵循OC的驼峰式命名规范;
如果是一个View,要以实际类型结尾;
变量名保持全英文结构,不要出现数字。
例如:cancelButton,titleLabel

常量命名
常量命名以m开头;
遵循驼峰命名规范;
例如:#define mScreenWidth ([UIScreen mainScreen].bounds.size.width)

方法名命名
小写字母开头;
有实际意义;
方法名前面一定要有注释;
公有方法最好以类名开头。
例如:
/**

  • 保存图片到相册
  • @param image 图片
  • @param success 成功回调
  • @param failure 失败回调
    /
    / + (void)saveImageToAppAlbum:(UIImage
    )image success:(void (^)())success failure:(void (^)(NSError *error))failure;

2、资源文件

图片资源

资源文件存储按照功能分类,按照现有项目举例,项目中有“首页”,“订阅”,“发现”,“我”四个模块,图片资源就按照如下图大致分类:

image.png

图片资源的命名要遵循“文件夹名字”—“子文件名字”—“图片名字”,如果图片名字很长的情况下,可以省略最外层文件夹名字,不过不建议省略。图片命名一定要是英文,禁止出现中文命名。

image.png

音频,json,plist等其他资源文件

其他资源放在Supporting Files文件夹下,资源文件注意命名。

image.png

3、项目结构

现在项目的整体结构还是可以的,只是业务文件夹有些乱,没怎么整理。
项目结构上还是遵循MVC结构,按照功能分,一个模块一个文件夹,再加上三方库(如果使用pods,这个文件夹基本可以省略),Common文件夹

image.png

Bussiness文件夹——业务

image.png

home——首页

image.png

Common——公共

image.png

类中方法顺序(这个协商决定就好)
从上到下依次是:

image.png

重写父类的方法——> get/set——> 点击方法 ——> 自定义方法 ——> 代理方法

相关文章

  • iOS编码规范整理(供参考)

    每个公司甚至每个程序员都有自己的一套编码习惯,个体不同,风格自然是迥异的,为了项目的代码质量,团队往往会制定自己的...

  • 20170317 Guidelines & AppSto

    Guidelines iOS开发规范整理 Objective-C编码规范:26个方面解决iOS开发问题 iOS开发...

  • IOS编码规范

    IOS开发规范 公司新项目马上要启动,整理一篇规范,供参考。 命名规范 驼峰法,除第一个单词之外,其他单词首字母大...

  • IOS 编码规范整理

    本文参考自《苹果Cocoa编码规范》《objective-c-style-guide》,希望能够启动抛砖引玉的功能...

  • iOS 团队编程规范

    iOS 团队编程规范 前 言 一、命名规范 二、代码注释规范 三、代码格式化规范 四、编码规范 参考资料: 转载自...

  • iOS开发 | 规范编码的四个意识

    iOS开发 | 规范编码的四个意识 iOS开发 | 规范编码的四个意识

  • swift编码规范

    看到了很好的编码规范,中文的, 推荐阅读参考 ,https://alexcode2.gitbook.io/ios-...

  • iOS 基础编码规范整理

    iOS 基础编码规范 目录 代码格式化空格 代码组织Pragma 命名通用的约定常量方法字面量 类类名初始化属性属...

  • iOS 编码规范

    Table of Contents iOS 编码规范1 文件规范1.1 文件编码1.2 文件命名2 编码格式2.1...

  • 智能合约最佳实践 之 Solidity 编码规范

    每一门语言都有其相应的编码规范, Solidity 也一样, 下面官方推荐的规范及我的总结,供大家参考,希望可以帮...

网友评论

    本文标题:iOS编码规范整理(供参考)

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