没人觉得 Apple 的技术文档一点都不友好吗？

[mingweili0x]

我之前开发过 Android 的应用。感觉 Google 给提供的文档，指导等对新用户非常友好。从第一步的下载 sdk，指定各种 runtime，到 hello world，到最基本的概念，新手应该知道的技术，全程下一步，下一步就好了。

后来好奇，想看看比 Android “高端”不少的 iOS 开发是什么样的。但我进了官网之后就傻眼了，不知道从哪开始，各种技术之间是平行罗列的，没有说新手的 hello world 放在最前面，最基本的库的讲解，语言的选择，适配的概念放在后边，然后稍微进阶，讲解各种可能会用到的东西。

如果说得不清楚的话，我找了几个链接，大家对比一下。（也许有可能我还真没找到 iOS 到底怎么在官网学）

Android 就很清晰，从官网也非常容易找到，网址看着都这么友好： https://developer.android.com/training/index.html

iOS，找到了相关的几个： https://developer.apple.com/library/content/referencelibrary/GettingStarted/DevelopiOSAppsSwift/Resources.html#//apple_ref/doc/uid/TP40015214-CH15-SW1，这个是从 google 直接点过来的，不是从官网找出来的）

https://developer.apple.com/documentation/ 这个简直是噩梦了，iOS，macOS，各种奇怪的技术栈就那么一列，你让新手怎么找？？？再者，点进去之后更是噩梦了。随便来一个： https://developer.apple.com/documentation/gamekit，就是简单的类罗列，哪个技术的文档能这么写？哪个能这么写？？ Apple 写文档的人就这么懒？你让别人一点主次都分不清， 上下文也没有，怎么学？？？

大家没有这种感觉吗？

没错，反正我对 Apple 的东西就有一种偏见，总感觉它们给人一种清高，爱咋地咋地，你们用户爱用不用，你们开发者爱学不学的态度。

[zieglar]

可能楼主没有看过国内大部分公司的文档，比如某牛、某信、某云

[QAPTEAWH]

我记得王垠吐槽过 Apple 的文档，顺便赞过微软的。

另外有些东西文档里没有，得去 WWDC 视频里找.....

[icyalala]

来个对比...
Google:

Apple:

[CastleBUPT]

是的，没错，而且苹果的文档特别不清晰，用词文绉绉的，不像给开发者看的

[camillo]

最后一句我来反一下 开发者不清楚 对用户以及配件商的文档 /支持倒是非常详尽的 而且更新很及时

[canxden]

开发 ios 不都是跳到.h 文件里面看每个方法的注释的吗.......这个本来就是接口的文档, 又不是怎么实现这个功能的文档, 把这个接口的功能告诉给开发者就好了啊. 而且很多.h 文件里面的注释都有很多细节上的提示.
真的需要说从入门那种构建项目, 不应该去查开发者的文档, 而是去查如何成为开发者的文档吧...

[ssynhtn]

@icyalala 这两个 drawRect 貌似意思是不一样的, 安卓的就是画一个长方形, 苹果的似乎是在给定的 rect 区域内画整个 view 的内容. 苹果的画长方形的方法似乎是 CGContextStrokeRect

[icyalala]

@ssynhtn 错了。。安卓是这个：

[nine99]

我写的

[hstdt]

苹果入门文档应该这么找吧。先在官网索关键字，比如 tableview，然后会给你一些相关文档以及 demo 工程。然后你自己去看代码，一点点跟着敲去学习 tableview。如果只是想要跑起来程序，那么用模板新建一个就行了。

[mingweili0x]

@icyalala 我觉得这正好体现了 Apple 的人没法把 API 的介绍结构化，逻辑化，只能是一片长篇大论，真正的程序员是干不出这种事来的

[virgil1988]

文档其实还不错，你用用 Xcode 半个月就疯了，我一直开发 iOS，被强制扔到 android，用了 AS 半个月后每次开 Xcode 内心都是拒绝的

[icyalala]

@mingweili0x 结构化的文档、综述这种也是有的，各种 Guide 里面就是。

安卓文档不清或者需要了解细节的话，最起码有源码能看。iOS 就不行了啊，文档和 API 描述再不完善一些，那真没办法搞了。