Start Developing iOS Apps Today系列(十三)

Start Developing iOS Apps Today系列以后续

十3、查找信息

      开发应用程序时,您会但愿先前了解或不了解的信息都随手可查。其实无需离开 Xcode,您便能得到所需的一切信息。 html

      Xcode 附带了大量不一样类型的系列文稿,包括通用指南和概念指南、框架和类参考资料,以及重点帮助文章。访问此类文稿的方式多种多样,如按住右键点按 Xcode 的各个区域来了解其使用方式、打开主项目窗口中的“Quick Help”面板来得到上下文相关的代码帮助,或者在“Documentation”窗口中进行搜索来查找指南和完整的 API 参考。 ios

image: ../Art/finding_info_2x.png

经过关联帮助文章来得到 Xcode 指导

      若要在使用 Xcode 时得到帮助,请阅读帮助文章。帮助文章会说明如何完成常见的任务,如建立新类、在 Interface Builder 中设置自定类,以及使用 Auto Layout 解决问题。 编程

      根据您尝试执行的操做内容,能够按住 Control 键点按 Xcode 中的 UI 元素来访问某些帮助文章。查找关联菜单中上一次输入的内容(此图像中为“Project Navigator Help”)。 app

image: ../Art/contextualHelp.pdf

      若是查找的是通用帮助,或者任务相关的元素不支持按住 Control 键点按来访问信息,那么您还能够在“Xcode Help”菜单中搜索关联帮助。 框架

image: ../Art/helpMenu_2x.png

使用指南来得到通用概述和概念概述

      请阅读概念指南中的相关章节,了解新技术或深刻理解框架中不一样的类之间配合工做的方式。大多数 Cocoa 框架和技术都有相应的编程指南,如《SpriteKit Programming Guide》(Sprite Kit 编程指南)、《Programming with Objective-C》(使用 Objective-C 编程),以及《Location and Maps Programming Guide》(位置和地图编程指南)。 编辑器

      在 Xcode 中,可使用文稿显示窗口来查看此类文稿,访问方法是选取“Help”>“Documentation and API Reference”(Option–Command–问号)。只需键入技术名称便可,如“Sprite Kit”。 ide

image: ../Art/findingSpriteKit_2x.png

      结果将有序显示,对您写代码最有帮助的内容排在前列。也就是说 API 参考条目将首先被列出,接着是 SDK 和“工具”指南。 工具

      若是弹出式列表中没有显示合适的结果,请选取“Show All Results”以显示可供过滤的完整结果。 ui

image: ../Art/showAllResults_2x.png

使用 API 参考来得到类信息

      阅读完指南,了解了技术的方方面面,并开始应用该技术编写代码时,您就会发现还须要进一步了解各个类能作些什么,或者须要掌握如何正确地调用特定方法。API 参考文稿提供了这些信息。 spa

      例如,要了解前面教程中使用的NSString类的更多信息,只需在文稿显示窗口的搜索栏中键入类的名称便可。

image: ../Art/searchForClass_2x.png

      最常点选的内容一般是所需内容;按下 Return 键进行选择,而后就能够看见该类的 API 参考。

image: ../Art/nsstringClassRef_2x.png

      API 参考文稿可以让您快速访问各个类的相关信息,包括类所提供的方法列表、父类,以及所采用的协议。点按“More related items”,查看关于类的通用信息。

image: ../Art/nsstringInfo_2x.png

      “Related Items”弹出式窗口还会显示相关指南的列表。例如,对于NSString来讲,若是您更想要了解概念概述,而不是深究参考资料,请阅读《String Programming Guide》(String 编程指南)。

      除了描述特定的方法或属性以外,API 参考文稿还会概述类能够执行的全部任务。

image: ../Art/nsstringTasks_2x.png

使用 Quick Help 来得到关联的源代码信息

      在源代码编辑器中写代码时,可在“Quick Help”面板中轻松访问 API 参考文稿(选取“View”>“Utilities”>“Show Quick Help Inspector”)。“Quick Help”面板会在您写代码的过程当中不断更新,显示当前正在键入的符号的相关信息。

image: ../Art/quickHelp_2x.png

      另外,您能够在源代码编辑器中按住 Option 键点按符号,从而显示带有“Quick Help”信息的弹出式窗口。

image: ../Art/optClickPopup_2x.png

      经过“Quick Help”面板或弹出式窗口,您能够在单独的文稿显示窗口中打开 API 参考,还能够查看包含所点按符号的声明的原始头文件。

经过示例代码来查看实际用法

      除了书面文稿,您还能够访问示例代码资源库。不管什么时候在文稿显示窗口中阅读快速帮助或指南和参考,都有一些条目会显示给定技术或类的相关示例代码项目。

image: ../Art/quickHelp_2x.png

      点按任何一个示例代码条目均可以在 Xcode 中下载并打开项目,以便您检查代码。

      除了在整个项目中进行代码注释以外,某些较大的代码示例还有附加文稿。例如,Sprite Kit Adventure 项目附加了《code:Explained Adventure》(代码:解释冒险)文稿。

image: ../Art/codeExplained_2x.png
相关文章
相关标签/搜索