没人觉得 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 的东西就有一种偏见，总感觉它们给人一种清高，爱咋地咋地，你们用户爱用不用，你们开发者爱学不学的态度。

[jasonchen168]

Xcode 不好用吗？直接上手写就好了

[dangyuluo]

高冷

[tscat]

是这样。
不过可能因为我有 java 基础先入为主的观念，我觉得安卓简单好多。ios 的体系架构特别不清晰

[zhaidoudou123]

Android 这是 入门指南 吧，Apple 好像没这个东西，他可能认为入门的话玩玩 playground 就够了

[kx5d62Jn1J9MjoXP]

觉得 Android 文档不友好, 很多概念和 api 都没有解释清楚

[mingweili0x]

@ssynhtn @zhaidoudou123 #5 我说的就是指入门指南啊

[zhaidoudou123]

@mingweili0x 我的意思是 Apple 可能认为文档就是文档，查 API 用的，入门之类的自己找教程，再基础的入门就用 playground

[shanjinwei]

关键安卓可以看源码 @ssynhtn

[kx5d62Jn1J9MjoXP]

@shanjinwei 幸好可以看源码, 不过源码不是你想看就看的, 既看不过来, 也不能全都看懂

[cubesugar]

你是说类似这样的 https://developer.apple.com/library/content/referencelibrary/GettingStarted/DevelopiOSAppsSwift/

另外还有各种视频教程，如白胡子老师，开源 demo

[mingweili0x]

@cubesugar 但是这只是无数 guide 里边的一篇，如果去它的主页： https://developer.apple.com/library/content/navigation/ 仍然感觉很杂

[mingweili0x]

@zhaidoudou123 哈哈，刚 google 一下 playground 是什么，笑死我了。那是给小学生用的拌方块的啊。

[mcluyu]

@mingweili0x 并不是哦，对于学习语法，了解编程、面向对象等基础来说，是一种非常简便的方法，你搜到的只是一部分

[mingweili0x]

@mcluyu 谢谢你的热心哈。但咱们讨论的是 Android 和 Apple 开发的东西，不是 swift，Java 的编程语言呀

[EmbraceZ]

https://developer.microsoft.com/zh-cn/windows
这个看起来如何

[mingweili0x]

@EmbraceZ 很不错啊，组织的很清楚。MSDN 不是号称最好的文档吗？之前用.NET 的时候没少查他们的文档

[webfrogs]

开发环境搭建，macOS 反倒是最简单的，下载 Xcode 安装就全部搞定了。

如果是入门，去 https://www.raywenderlich.com 里找教程，或者斯坦福老爷子的公开课，都是不错的选择。官网的文档确实不适合用来入门。

官方文档还是适合有一定经验想要具体了解某个 framework 的开发者。

还有楼主你说的那个 playground 是指 Swift Playground 这个 iPad app， @zhaidoudou123 指的是使用 Xcode 创建的 playground 环境。

[mingweili0x]

@ssynhtn 我也没深入过 android，但我从只有 Java 知识，从零开始，顺着官网上给的教程，最后弄出来一个完整的应用， 当研究生毕业设计

[mingweili0x]

@webfrogs 哦，了解，没实际做过 iOS 应用，不好意思

[chairuosen]

有两种文档，一种是写的时候让你查的，一种是一步一步带你走的。