Question

我发现在Swift中学习新东西的这方面和Xcode 非常令人费解。

我似乎无法从Apple API文档中读到的内容中解读我需要编写的实际代码;在我的具体情况中：API Reference for 'PlaygroundSupport'，以及我需要的实际代码，即：

import PlaygroundSupport
let containerView = UIView(frame: CGRect(x: 0.0, y: 0.0, width: 375.0, height: 667.0))
PlaygroundPage.current.liveView = containerView

对我而言，这似乎是“隐藏的知识”，我无法从API中获得认可。没有给出示例用法。

我如何从Apple API中找到我需要以所需方式添加UIView（作为containerView）？我如何学习以假设的方式阅读Apple API文档？

Answer 1

阅读API文档很像阅读数学教科书：你需要理解你正在阅读的每个单词，否则你可能会错过你需要的东西。在这种情况下，检查该文档时，您可能会查看PlaygroundPage课程，并且您会看到liveView属性描述为＆＃34;活动的实时视图助理时间表＆＃34;。如果您不确定＆＃34;实时视图＆＃34;是，或者是什么＆＃34;助理时间表＆＃34;是的，然后可能需要进一步搜索。但是，如果您了解这些条款，则应立即将其视为您正在寻找的财产！

继续浏览文档，确保您对每种方法或属性都有足够的了解，以明确排除或进一步研究它。一开始可能会让人不知所措，但是当你阅读Swift iBook，按照教程，继续阅读文档时，你会发现自己越来越了解它所说的内容。

Answer 2

正如@ andyvn22所提到的，学习如何使用文档，了解它尝试与您沟通和实验的方式需要花费时间。我会告诉你我的思考过程：

您关联的网页有一个import PlaygroundSupport，我可以在那里看到一个类PlaygroundPage - 假设您想在Playground中使用渲染UI，我会深入研究
PlaygroundPage似乎有一个名为liveView的属性，它似乎让我实时与某些内容进行互动，因此请点击此处... https://developer.apple.com/reference/playgroundsupport/playgroundpage
我可以看到liveView是一个get / set所以我知道我需要传递一些东西，也许是我想在操场上渲染的视图对象？让我们点击此视图必须符合的PlaygroundLiveViewable协议... https://developer.apple.com/reference/playgroundsupport/playgroundpage/1964506-liveview
啊，所以UIView或UIViewController符合PlaygroundLiveViewable协议 - 如果我尝试通过它，那么它就像您在问题中确定的那样有效{{3 }}

它并不总是直截了当，因为让我们面对它，为一种只是刚刚解决的语言编写文档是一项挑战。我建议巩固一些软件工程基础，比如分类，子类化，获取/设置范例，你学习的模式越多，你会发现更多的模式，并且更容易遵循文档！

如何将Apple API文档翻译成现实代码？

2 个答案: