Google的ObjectiveC编码规范

Google 的Objectiv e-C 编码规范 总览 背景知识 Objective-C 是一个C 语言的扩展语言，非常动态，非常的“面向对象”，它被设计成既拥有复杂的面向对象设计理念又可以轻松使用与阅读的语言，也是Mac OS X 和iPhone 开发的首选语言。 Cocoa 是Mac OS X 的主要应用框架，提供迅速开发各种功能的Mac OS X 应用的Objective-C类集合。 Apple 已经有一个很好也被广泛接受的Objective-C 的编程规范，Google 也有类似的C++编程规范，这份 Objective-C 编程规范很自然是Apple 和Google 的共同推荐的组合。所以，在阅读本规范前，确保你已经阅读了: Apple's Cocoa Coding Guidelines Google's Open Source C++ Style Guide 注意所有已在Google 的C++编程规范里的禁用条款在Objectiv e-C里也适用，除非本文档明确指出反对意见。 本文档旨在描述可供可适用于所有Mac OS X 代码的Objective-C(包括 Objective-C++)编码规范和实践。规范中的许多条款已经改进也不断的被其他的项目和团队所证明其指导性。Google 的相关开源项目都遵守此规范。 Google 已经发布了一份作为 Google Toolbox for Mac project (文档中简称为 GTM)的组成部分的遵守本规范的开源代码。这份开放代码也是本文很好的例证(原文看不太懂－－Code meant to be shared across different projects is a good candidate to be included in this repository. ) 注意本文不是Objective-C 的教学指南，我们假设读者已经了解语言。如果你是一个Objective-C的初学者或需要重温，请阅读The Objective-C Programming Language . 示例 人们说一个例子胜过千言万语，所以就让我们用例子来让你感受以下编码规范的风格，留间距，命名等等。 下例是一份头文件，展示对@interface 声明正确的注释和留间距 // GTMFoo.h // FooProject // // Created by Greg Miller on 6/13/08. // Copyright 2008 Google, Inc. All rights reserved. // #import // A sample class demonstrating good Objective-C style. All interfaces, // categories, and protocols (read: all top-level declarations in a header) // MUST be commented. Comments must also be adjacent to the object they're // documenting. // // (no blank line b...