苹果官方文档

Documentation

https://developer.apple.com/documentation/

  • 点击右边搜索按钮,搜索结果比较细节,基本是标题中包含关键字才搜到却不一定匹配这个主题比如runtime,结果指向综合框架文档下的其中一篇文档。而且这个搜索区分大小写,比如AVfoundation和avfoundation的搜索结果数量不一样。
  • 点击左边的“Documentation”文字进行搜索Technologies,其实是过滤筛选下面的238个框架文档中匹配关键字的框架,搜索结果指向概论,可以从概论链接跳转到细节。
  • Documentation基本上是框架、类、方法的说明文档,也会有文章加代码片段指导如何开发,也会有一些编程示例可供下载。(Documentation首页,也是点击右边Featured显示的页面,第一张图片就有指示“Apple Developer Documentation —— Browse the latest developer documentation, including tutorials, sample code, articles, and API reference.”)
  • Documentation首页的最下方有4个链接,最后一个是“Documentation Archive”,并且说明了归档是一些不会再更新的文档和示例代码,

Documentation Archive

1、https://developer.apple.com/library/archive/navigation/

  • 在Documents旁边的搜索框搜索文档,例如输入runtime选择Objective-C Runtime Programming Guide,输入loop选择Run Loops(打开会提示该文章已经被取代了,去Threading Programming Guide查看run loop信息),筛选5219篇文档中的匹配文档,Safari输入文字时很卡Chrome不卡。
  • 在上方搜索框Search Documentation Archive搜索,结果和在Documentation搜索一样。
  • 主要是一些编程指导Programming Guide,但是这些文档比较旧且不再更新(点击进去一个文档最下面显示最后更新时间updated),Archive首页也有提示“This library is no longer being updated. Find the latest API reference, articles, and sample code on our Developer Documentation page.”去Documentation查看最新文档。
  • 有的文章只在Archive不在Documentation,比如Objective-C Runtime Programming Guide和Run Loops,而且Documentation搜索结果总是搜不到专题总是细化到一个不一定相关的类,而去Technologies搜索专题也不一定有,所以一般先去Archive搜索专题文档,然后去Documentation查看相关框架和类的最新文档。

2、Archive和Documentation比较:
(1)AVFoundation框架:Documentation的示例使用PHPhotoLibrary,而Archive使用过期的ALAssetsLibrary
(2)Runtime:Archive有而Documentation没有,但是Documentation的See Also下有跳转到Archive的链接。
(3)Archive基本都是专题文章(Programming Guide),比如Runtime会描述运行时机制、消息传递、类型编码等;而Documentation基本都是类和方法的说明(API Reference),比如Runtime会说明有哪些运行时相关的方法函数,开发者可以调用的方法,Archive的代码示例中用到的方法。

开源代码

Xcode中的文档

1、Xcode的Help:

  • Developer Documentation(是离线版的Documentation,内容基本一样),可以利用左边的导航视图找到所需框架,也可以点击搜索框搜索。
  • Swift Programing Language Book
  • 其他选项内容暂时不查看。

2、Xcode使用“Control+Command+鼠标点击”一个类名,跳到类头文件中,查看文件中方法和属性的注释(和官方文档Documentation中的说明差不多且包含各个参数说明,而类头文件对整个类的注释说明不够详细,看Documentation更能知道这个类的作用)。

Develop

https://developer.apple.com/develop/:最下方的Media and Web的“Audio”、“AVFoundation”、“HTTP Live Streaming”有这些开发文档的链接;点击最上方的“Documentation”可以跳到文档搜索中心。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值