完全无法通过 Apple Developer Documentation 学会 iOS / macOS 开发，是我的问题吗？

已经数不清第几次被 Apple Framework (注意不是 Swift) 的学习门槛劝退。

例如，我无法通过官方文档学习一个 Button 是怎么用的：

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

点进去，想看看如何监听一个点击事件，好不容易看出了大概是 init(action: () -> Void, label: () -> Label) 这条，再点进去，只有一个 Declaration 写着用法：

init(action: @escaping () -> Void, @ViewBuilder label: () -> Label)

我有点受到惊吓，因为我不知道 @escaping 和 @ViewBuilder 是什么，我心想也许是我的 Swift 基础还不行，所以看不懂。于是我就 Google swift ui button, 搜出了很多 tutorial, 发现这些 tutorial 讲得清楚得多。

类似的例子还数不胜数，我的学习过程基本是靠 StackOverflow 的。

现在我的感觉是，我写 App 的过程中，是否能写出我要的功能，完全是靠我的 Google 能力以及运气。这让我非常泄气。写过 Android, 前端, 后端各种平台的我是没有经历过像学 Apple Framework 这样累的。我只能靠大量非官方的 Tutorial 以及零散的 Blog post 拼凑成我的 App.

我觉得看 Apple Developer Documentation 来学 Apple 开发就像看 w3c.org 来学前端...

在这里请教一下各位 Apple 开发者，你们是如何学会写一个 iOS (尤其是能搜到相关 tutorial 更少的 macOS) 应用的？

secondwtq

2020-03-03 18:32:04 +08:00

楼主看这个文档不能学会不是问题，去搜 Tutorial 也是正确的做法

一般开发文档分两大块，Tutorial/Guide （教程）和 Reference （参考），楼主发的这个 Apple 文档链接属于 Reference。
参考是给你在熟练之后日常开发找用法的，就像一门外语的字典。
教程是你学的时候带你入门的，就像一门外语的教科书。

每一个领域都有一套约定俗成的术语和模式，就像一门外语的语法、标音方式之类的。你在看参考之前，需要先看教程熟悉这些术语和模式。上来就翻字典是学不会一门外语的。

楼主对“Apple Developer Documentation”和 w3c.org 两者的类比有一定道理，但是只在“Apple Developer Documentation”只包含 Reference 的情况下成立。我知道 Apple 之前有各种各样的 Guide，一般篇幅都非常的长，也不知道是啰嗦还是详细（很多都是有关 OS X 的（用 OS X 而不用 macOS 是为了暗示时间））。Swift 之类的新东西还有没有就不知道了。