首页 > 技术文章 > 苹果开发工具Xcode帮助文档的使用总结

yuhao309 2017-04-12 12:38 原文

1>Xcode文档的结构:(如何能够快速定位到你要找的内容)

1、左面的侧栏:一组不同版本的iOS文档库、一组不同版本的OS X文档库,以及一个Xcode文档库。文档内容区域的左侧导航区域,这里揭示了文档库的结构:

Resource Types:资源类型

  1. Getting Started —— 新手入门,一般来说,是给完全的新手看的。建议初学者看看,这里面有一些建立观念的东西,有了这些建立观念的东西,后面的学习就比较容易了。
  2. Guides —— 指南,指南是Xcode里面最酷最好的部分,学会看指南则大多数情况完全不用买书。Xcode文档里面的指南,就是一个一个问题的,从一个问题,或者系统的一个方面出发,一步一步详细介绍怎么使用Cocoa库的文档。一般程序员比较熟悉的是Reference,就是你查某个类、方法、函数的文档时候,冒出来的东西。那些其实是一点一点的细碎知识,光看那些东西就完全没有脉络。而Guides就是帮你整理好的学习的脉络。
  3. Reference —— 参考资料。一个一个框架一个一个类组织起来的文档,包含了每个方法的使用方法。
  4. Release Notes —— 发布说明。一个iOS新版本带来了哪些新特性,这样的信息,熟悉新iOS,比较不同iOS版本API不同,都需要参考这些文档。
  5. Sample Code —— 示例代码。苹果官方提供的一些示例代码,帮助你学习某些技术某些API。非常强烈建议学习的时候参考,一方面光看文档有时候还是很难弄明白具体实现是怎么回事儿。另外一方面这些示例代码都是苹果的工程师写的,你从示例代码的变迁可以看到苹果官方推荐的代码风格流变。
  6. Technical Notes —— 技术说明。一些技术主题文章,有空的时候可以浏览一下。往往会有一些收获。
  7. Technical Q&A —— 常见技术问答。这是技术社区里面一些常见问题以及回答的整理。
  8. Video —— 视频。目前主要是WWDC的视频,实际上是登录到开发者网站上去浏览的,这里就是快捷方式。想深入学习的话,一定不能错过,大量的看,不仅可以学好技术,还可以练好英文。

Topics:话题

  1. Audio & Video —— 音视频
  2. Languages & Utilities —— 语言和工具,Objective-C的一些知识,App Store的管理工具等。
  3. Mathematical Computation —— 数学计算。
  4. Xcode
  5. Data Management —— 数据管理。
  6. General —— 一般性的问题。
  7. Graphics & Animation —— 图形和动画。
  8. Networking & Internet —— 网络问题。
  9. Performance —— 性能。
  10. Security —— 安全。
  11. User Experience —— 用户体验。

Frameworks:框架

  1. Cocoa Touch Layer
  2. Media Layer
  3. Core Services Layer
  4. Core OS Layer

 

比如想看性能方面的Guides,可以有两种方法:

a、点击左面的导航Topics -> Performance,然后在右边的文档过滤器上面输入Guides

b、点击左面的导航Resource Types -> Guides,然后在文档过滤器里面输入 Performance

 

2、右面的内容区域:

Title:标题

Resource Types:资源类型

Topic:话题

Framework:框架

Date:日期

 

2>文档导读:(自学iOS开发应该遵循或者推荐的必读文档的阅读顺序)

  1. 《马上着手开发 iOS 应用程序 (Start Developing iOS Apps Today)》

阅读这个文档的目的和检测标准是,以后你看到iOS开发中的基本概念,都大致所有了解。

 

  1. 《Your First iOS App》
  2. 《Your Second iOS App: Storyboards》
  3. 《Your Third iOS App: iCloud》

阅读前三个文档的目的和检测标准是,把这三个Demo App做出来在模拟器上跑起来。

 

  1.   5. 《iOS Technology Overview》

阅读这个文档的目的和检测标准是,遇到具体问题,知道应该去看哪方面的文档。

 

  1. 《iOS Human Interface Guidelines》

阅读这个文档的目的和检测标准是,看到任何一个App,你可以知道它的任何一个UI是系统控件,还是自定义控件,它的层次关系等等。

 

  1. 《Learning Objective-C: A Primer》和《Programming with Objective-C》

阅读这个文档的目的和检测标准是,看得懂基本的Objective-C代码,方便后面的学习和阅读各种示例代码。

 

  1. 《iOS App Programming Guide》

阅读这个文档的目的和检测标准是,了解全部流程和很多细节问题。

 

  1. 《View Programming Guide for iOS》和《View Controller Programming Guide for iOS》

阅读这个文档的目的和检测标准是,深刻理解什么是View,什么是View Controller,理解什么情况用View,什么情况用View Controller

 

  1. 《Table View Programming Guide for iOS》

阅读这个文档的目的和检测标准是,深刻理解UITableViewUITableViewController的理论和使用方法。

 

3>如何查询文档:

Quick Help:

帮助信息会包括,一些简单的描述、哪个iOS操作系统开始提供,头文件,参考文档,头文件和参考文档是可以直接点击的。

a、在Xcode代码编辑器里,按住Option键,然后点击你想查询的关键词,就会获得关键词的帮助信息。

Command键加鼠标点击,即可跳到任何一个类名或者方法名的所定义的头文件。

b、快速查询帮助的另外一个方法是直接打开Quick Help栏,如下图,首先找到“右侧栏开关”,然后找到“Quick Help”开关即可打开。

搜索帮助:

文档阅读界面最左面的上端的放大镜按钮就是搜索界面。下图是我们搜索uiimage,得到的搜索结果,结果也是分为:

Reference:参考文档

System Guides:系统指南

Tools Guides:工具指南

Sample Code:示例代码

Hits Must(什么样的结果才会命中),包含了三项:

  1. contain search term 这是最常见的就是结果包含搜索词
  2. start with search term 由搜索词开始
  3. match search term 必须完全匹配搜索词

 

4>阅读文档:

  1. Inherits from 继承关系,继承自
  2. Conforms to 遵循什么协议
  3. Framework 属于什么框架
  4. Availability 从什么iOS版本开始支持
  5. Declared in 头文件
  6. Related sample code 相关例子代码
  7. Companion guide 相关的指南

推荐阅读