ios之编码规范具体说明

iOS代码规范:

所有代码规范所有遵循苹果sdk的原则,不清楚的请訪问苹果SDK文档或下载官方Demo查看。

1、project部分:

将项目中每一个功能模块相应的源文件放入同一目录下,使用虚拟目录。

引用的.a和相关的文件。独立使用目录存放。并标明是SDK

2、类:

命名:首字母大写,其后每一个单词首字母大写,类文件的名字必须与类中基本的@interface类名字一致。(例:RootViewController。PersonInfo)

category和protocol能够放在独立文件里,或放在某个类之前。

3、代码:

变量:全部变量命名遵循驼峰规则,变量名需保证见名知意。(例:NSString *personName = @"123",BOOL isTrue = YES)

除此之外还需满足下面条件:

暂时变量以小写字母开头。其后每一个单词首字母所有大写,尽量不使用数字和下划线。

全局变量下面划线开头。禁止使用数字,尽量不在中间使用下划线。

4、数据类型:

能使用Objective-C的数据类型,尽量使用Objective-C的数据类型,切忌交叉使用(哪怕你知道那原本就是一个类型)。

5、属性、方法

全部属性名不能下面划线开头,尽量不使用单词简写。(例:

@property (nonatomic,strong)NSString *orderNumber;

@property (nonatomic,strong)NSMutableDictionary *studentInfo;

方法名必须以小写字母开头,每一个參数描写叙述必须明白的描写叙述后面的參数,每一个形參必须确切的表示參数的作用。严禁出现  - (id)init:(NSString *)a b:(NSString *)b作此类的方法名。

6、语句、括号

全部语句必须遵循左对齐原则,括号位置需保持一致。

换行前注意语句对齐,嵌套语句中换行和括号必须依次缩进。

7、 凝视、标记

每一个不够明白的变量和属性之前。必须加上相关凝视。

每一个略微复杂的方法。必须加上对功能的描写叙述。

运行到关键步骤时。尽量使用语句提示其作用。

出现关键性的流程选择时,使用凝视提示。

同一个类中出现其它引用。出现独立功能模块时。加入mark。

随意待优化、未完好、未測试、不确定的代码。须要加入mark。

8、宏、静态全局变量

尽量写在独立的文件里。

简短的宏命令尽量使用大写,稍长的能够大写开头,其后使用小写,但尽量加入下划线加以区分。

大量反复使用的数值尽量使用宏,嵌套层数过多、使用频率较高、格式固定无需较大更改的方法尽量使用宏。

经常使用设备信息、屏幕尺寸、固定參数尽量使用宏,接口地址、路径、固定參数可使用宏或全局静态变量。

时间: 2024-11-10 01:04:04

ios之编码规范具体说明的相关文章

iOS:Cocoa编码规范 -[译]Coding Guidelines for Cocoa

--原文地址:https://developer.apple.com/library/mac/documentation/Cocoa/Conceptual/CodingGuidelines/Articles/FrameworkImpl.html Cocoa编码规范 --前言 用公共API开发一个Cocoa框架,插件,或其他可执行目标,里面的命名编写和规范不同于一般应用程序的开发.因为你开发出来东西是给开发者用的看的,并且他们不熟悉你的编程接口.这个时候API的命名约定就派上用场了,因为它使你的写

ios之编码规范详细说明

iOS代码规范: 所有代码规范全部遵循苹果sdk的原则,不清楚的请访问苹果SDK文档或下载官方Demo查看. 1.工程部分: 将项目中每个功能模块对应的源文件放入同一文件夹下,使用虚拟文件夹. 引用的.a和相关的文件,独立使用文件夹存放,并标明是SDK 2.类: 命名:首字母大写,其后每个单词首字母大写,类文件的名字必须与类中主要的@interface类名字一致.(例:RootViewController,PersonInfo) category和protocol可以放在独立文件中,或放在某个类

节选自“Discuz! 开放平台的编码规范”(通用的)

http://open.discuz.net/?ac=document&page=dev_coderule 本文字体字号大小(只针对本文编辑器): 项目描述                             字号          加重与否             例 重要内容标题                   18pt        重色                I. 代码编写规范,“序” 一般描述性文字                13px        不加重色    

iOS 注释的5要3不要和编码规范的26个方面

注释 代码注释,可以说是比代码本身更重要.这里有一些方法可以确保你写在代码中的注释是友好的: 不要重复阅读者已经知道的内容 能明确说明代码是做什么的注释对我们是没有帮助的. // If the color is red, turn it green if (color.is_red()) { color.turn_green(); }   要注释说明推理和历史 如果代码中的业务逻辑以后可能需要更新或更改,那就应该留下注释:) /* The API currently returns an arr

iOS编码规范参考

目录 1  注释 1.1  多行注释 1.2  单行注释 1.3  函数的注释 2  命名 2.1  常量的命名 2.2  函数的命名 2.3  变量的命名 2.3.1  成员变量 2.3.2  公共变量命名 2.3.3  实例变量命名 2.4  图片的命名 2.5  类的命名 2.5.1分类名 2.6  条件语句 2.7  变量 3  下划线 4  Immutable 实例初始化 5  类型 5.1  CGRect 函数 5.2  常量 5.3  枚举类型 5.4  布尔变量 5.5  单例

【分享】[iOS翻译]Cocoa编码规范

http://www.cnblogs.com/yangfaxian/p/4673894.html 简介: 本文整理自Apple文档<Coding Guidelines for Cocoa>.这份文档原意是给Cocoa框架.插件及公共API开发者提供一些编码指导,实质上相当于Apple内部的编码规范.在多人协作时,一份统一的代码规范大大减少开发者之间的沟通成本,极力推荐. 目录: 一.代码命名基础 二.方法 三.函数 四.Property及其他 五.缩写 一.代码命名基础 1.通用原则 1.1 

html编码规范

不久前接到老大下达的任务,要拟定一份公司前端编码规范的草稿,参考了各大公司的编码规范,结合现在公司的特点,整理出以下编码规范: html规范 1 文件相关 (1) 文件名以英文为主,可以使用下划线(如active.html),压缩包以项目名+日期的形式. (2) 统一使用utf-8编码. (3) css.js发布到线上都需要压缩. (4) 在追求高度优化的站点,需要对图片也进行无损压缩. 2 代码风格 2.1 命名 (1) 元素 id 必须保证页面唯一.(解释:同一个页面中,不同的元素包含相同的

[转载]Objective-C开发编码规范:4大方面解决开发中的规范性问题

Objective-C 编码规范,内容来自苹果.谷歌的文档翻译,自己的编码经验和对其它资料的总结. 概要 Objective-C 是一门面向对象的动态编程语言,主要用于编写 iOS 和 Mac 应用程序.关于 Objective-C 的编码规范,苹果和谷歌都已经有很好的总结: Apple Coding Guidelines for Cocoa Google Objective-C Style Guide 本文主要整合了对上述文档的翻译.作者自己的编程经验和其他的相关资料,为公司总结出一份通用的编

HTML/CSS/JS编码规范

最近整理了一份HTML/CSS/JS编码规范,供大家参考.目录:一.HTML编码规范二.CSS编码规范三.JS编码规范 一.HTML编码规范 1. img标签要写alt属性 根据W3C标准,img标签要写alt属性,如果没有就写一个空的.但是一般要写一个有内容的,根据图片想要表达的意思,因为alt是在图片无法加载时显示的文字.如下不太好的写法: <img src="company-logo.svg" alt="ABC Company Logo"> 更好的