从零开始：使用Swift开发Apple TV应用的完全指南

摘要：这篇文章主要介绍了如何在Apple TV上开发一个名为tvOS的App，以及关于tvOS的一些相关的定义，最终呈现给用户一个非常有趣的界面。

本文出自：Jameson Quave's Blog，作者：Jameson Quave，译文出自：SwiftGG，译者：ray16897188

教程结束时，我们会做出这样一个应用：

你更喜欢哪个艺术家？

第一部分

开始

在我们开始之前你需要安装 Xcode 7.1 beta 版，可以从这里下载：下载 Xcode 7.1 Beta。

注意：下载 Xcode 7.1 Beta需要有一个苹果开发者账号，由于目前 Xcode 是预发行版，以后正式发布的时候可能会有变化。

安装的时候要注意，如果你重命名Xcode 7.1应用，会遇到一个已知Bug。一定有人会这么做，所以提前说明……别这么做，否则你的tvOS模拟器会崩溃。

同时要注意，虽然支持优胜美地 (Yosemite)，但是在该操作系统上，功能会受限。推荐用 OSX 10.11 El Capitan 或更新的系统。El Capitan beta可以在 这里下载。

下面我们来介绍一些 tvOS 相关的定义。

TVMLKit

TVMLKit 是 Apple 设计的一个新框架，能在使用 Swift 或 Objective-C 实现应用逻辑的同时使用 Javascript 和 XML 开发更炫酷的用户界面。

TVML

TVML 是“TV Markup Language”（TV 标记语言）的缩写，基本上是一些 XML 语句，用于实现基于C/S（client-server，客户端-服务端）架构的 tvOS 应用布局。布局界面时，我们会用到一些 Apple 提供的 TVML 模板创建我们的 UI，然后用 TVJS 写交互脚本。

TVJS

我能告诉你的是，TVJS 就是你（可能已经）熟悉的 JavaScript。

Hello World

我们从一个基本的 hello world 程序开始。就 Apple TV 而言，我们可以只把"Hello World"输出到控制台上。这也许是个不错的开始，但更好的选择是使用 Apple TV 的一些 TVMLKit 元素在屏幕上创建一个模板。

首先，打开 Xcode 7.1 并创建一个新项目。你可以看到一个模板列表，我们在左侧选择CHANGE tvOS，然后再选Single View Application模板。

这样就会根据 tvOS 模板创建一些默认文件和一个简单的 Swift 入口点，对一会儿创建 UI 很有帮助。

建立 TVJS 主文件

在 C/S 架构的 tvOS 应用中，服务端本质上就是 TVML 和 JavaScript 文件以及和它们相关的所有数据。JavaScript 文件会装载 TVML 并把页面（page）放入视图栈中。可以从另一个角度理解：JavaScript 文件就像 TVML 文件的路由器或是控制器（controller），而 TVML 文件本质上是若干视图（views）。

拉开序幕

首先我们要修改应用的AppDelegate.swift文件。第一步是让我们的应用遵循
TVApplicationControllerDelegate协议。该协议定义在 TVMLKit 框架中，所以需要导入它。更新AppDelegate.swift文件，如下所示：

[cpp] view plaincopy

1. import TVMLKit

2. class AppDelegate: UIResponder,

3. UIApplicationDelegate,

4. TVApplicationControllerDelegate {

5. ....

此协议包含四个 tvOS 实现AppDelegate后会调用的函数，用于给我们的应用发送 tvOS 生命周期通知。现在我们无需操心这些，但在后面的教程中我们会对它们进行深入研究。目前只要像上面的代码那样把协议加进去就够了。

下一步，我们要添加一些代码，让 JS 文件起作用。由于是 beta 版，我们还需要自己完成这些工作。我相信在 Xcode 的后续版本中这一步会变成一个模板。

在程序里
didFinishLaunchingWithOptions这个函数中我们要完成一些步骤。它们对所有应用来说都是一样的，所以你可以直接复制这段代码：

[js] view plaincopy

1. // 在一个可选属性中保存对 appController 的引用

2. var appController: TVApplicationController?

3. func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {

4. self.window = UIWindow(frame:UIScreen.mainScreen.bounds)

5. let appControllerContext = TVApplicationControllerContext

6. let jsFilePath = NSURL(string: "http://localhost:8000/main.js")

7. let javascriptURL = jsFilePath!

8. appControllerContext.javaScriptApplicationURL = javascriptURL

9. if let options = launchOptions

10. {

11. for (kind, value) in options

12. {

13. if let kindStr = kind as? String

14. {

15. appControllerContext.launchOptions[kindStr] = value

16. }

17. }

18. }

19. self.appController = TVApplicationController(context: appControllerContext, window: self.window, delegate: self)

20. return true

21. }

简单说说这段代码干了什么：它拿到了一个
TVApplicationControllerContext引用，这个Context只是为我们的AppDelegate类提供了一些启动数据，然后给了我们一个能调整和修改启动过程的接口。接着把 URL 传给待会儿要运行的main.js文件，并将appController的路径设置成这个 URL。

现在就要添加我们的 JavaScript 文件了，点击 File > New，然后在 iOS tab 下面选择 Other > Empty file。将这个文件命名为main.js。

用同样方法创建一个hello.tvml文件。

在main.js文件中添加一些简单的 JavaScript 代码，用来装载hello.tvml文件：

[html] view plaincopy

1. function getDocument(url) {

2. var templateXHR = new XMLHttpRequest;

3. templateXHR.responseType = "document";

4. templateXHR.addEventListener("load", function {pushDoc(templateXHR.responseXML);}, false);

5. templateXHR.open("GET", url, true);

6. templateXHR.send;

7. return templateXHR;

8. }

9. function pushDoc(document) {

10. navigationDocument.pushDocument(document);

11. }

12. App.onLaunch = function(options) {

13. var templateURL = 'http://localhost:8000/hello.tvml';

14. getDocument(templateURL);

15. }

16. App.onExit = function {

17. console.log('App finished');

18. }

现在在hello.tvml文件中添加：

[html] view plaincopy

1. <document>

2. <alertTemplate>

3. <title>Hello tvOS!</title>

4. </alertTemplate>

5. </document>

TVML 文件是 UI 的实际内容。文档（document）必须用模板编写，否则现在的代码运行时会崩溃。这个 TVML 文件只是包含了一个简单的模板和一个单元素的标题。

在编写这些代码时我发现一个问题：本地无法引用这些文件，文件必须放在一个 web 服务器上。所以最简单的解决方案是找到你刚创建 TVML 和 JS 文件的位置，并在命令行中敲进如下指令：

启动服务端

[cpp] view plaincopy

1. python -m SimpleHTTPServer 8000

这条指令用 Mac OS 内建的 python 解释器开启了一个端口号为 8000 的 web 服务器，可以用它来托管本地文件。如果在命令行中，执行了上面给出的代码，那么现在按一下 Xcode 的 play 按钮就能在 tvOS 模拟器中启动了。还有一个要注意的事情：这是一个不够安全的 HTTP 请求，在 iOS 9 中会被默认的应用传输安全机制拦截。为了能够按之前的方法来使用本地主机，我们需要在Info.plist文件中添加一个key。

允许直接加载（Allows Arbitrary Loads）

选择Info.plist文件然后按加号(+)来创建一条新记录。在列表中选择”App Transport Security Settings”并按 return 建。这将创建一个新的字典条目，展开它，在这行上按加号(+)添加一个子行。接着选中”Allows Arbitrary Loads”并将其设为true。都设好了之后我们就能用模拟器运行应用了。

添加按钮

在本例中你看到的实际上是一个被 Apple 称作alertTemplate的模板。你还能嵌入一些基本控件，比如在模板中添加文字和按钮。试着添加一些按钮吧：

[html] view plaincopy

1. <document>

2. <alertTemplate>

3. <title>Hello tvOS!</title>

4. <button>

5. <text>A Button</text>

6. </button>

7. <button>

8. <text>A Second Button</text>

9. </button>

10. </alertTemplate>

11. </document>

这里我们只加了子按钮（child button）元素，每个子按钮都有它自己的子文本（child text）元素。这段代码在 tvOS 模拟器上全屏显示alert和两个按钮。如果你自学能力很强， 苹果的官方文档中列出了你能使用的所有模板和控件。

第二部分

增加交互事件

在第一部分中我们创建了一个简单的 TVML document，里面有几个按钮。这个document看起来是这样的：

这是一个带按钮的警告（alert）界面，目前这些按钮没有任何作用。这段代码直接硬编码了具体内容，更好的方式是使用代码生成 XML，在 JS 中很容易实现。我们在main.js文件中添加一个新函数，把上面的代码封装成一个更简单的警告界面，它只包含一个 OK 按钮。

[html] view plaincopy

1. function alert(str) {

2. var alertXMLString = `<?xml version="1.0" encoding="UTF-8" ?>

3. <document>

4. <alertTemplate>

5. <title>Hey Listen!</title>

6. <description>${str}</description>

7. <button>

8. <text>OK</text>

9. </button>

10. </alertTemplate>

11. </document>`

12. var parser = new DOMParser;

13. var alertDOMElement = parser.parseFromString(alertXMLString, "application/xml");

14. navigationDocument.presentModal(alertDOMElement);

15. }

这里创建了一个alertXMLString字符串，它表示的是包含一个按钮的简单警告界面所对应的 TVML。description节点比较特殊，我们使用 TVJS 的内嵌字符串语法${variable}来插入str的值。

接下来，创建一个新的DOMParser对象，把这个字符串转换成一个实际的 XML DOM 元素。

最后，我们用navigationDocument的presentModal方法展示一个模态框，内容就是上一步的 DOM 元素。navigationDocument是一个全局变量，它永远指向 XML 文档的根节点。

现在，删除onLaunch函数中之前的代码，直接调用刚才创建的函数……

[cpp] view plaincopy

1. App.onLaunch = function(options) {

2. alert("Hello!");

3. }

Hello警告

运行应用，你会看到一个炫酷的”Hello!” tvOS 警告。但是点击 OK 没有任何反应。我们该怎么处理像触摸之类的事件呢？

通常来说，在 JavaScript 和 TVML 的世界中，你需要给 DOM 元素添加一个事件监听器（event listener）。举个例子，我们可以给alert函数添加第二个参数，把 OK 按钮触发select事件时需要调用的函数作为参数传入。下面我们就加入这个名为doneCallback的参数：

[cpp] view plaincopy

1. alertDOMElement.addEventListener("select", function { doneCallback }, false);

更新后的完整函数如下：

[cpp] view plaincopy

1. function alert(str, doneCallback) {

2. var alertXMLString = `<?xml version="1.0" encoding="UTF-8" ?>

3. <document>

4. <alertTemplate>

5. <title>Hey Listen!</title>

6. <description>${str}</description>

7. <button>

8. <text>OK</text>

9. </button>

10. </alertTemplate>

11. </document>`

12. var parser = new DOMParser;

13. var alertDOMElement = parser.parseFromString(alertXMLString, "application/xml");

14. alertDOMElement.addEventListener("select", doneCallback, false);

15. navigationDocument.presentModal(alertDOMElement);

16. }

现在我们可以修改之前的onLaunch函数，添加一个回调函数来显示一个 TVML 页面。在此之前，我们需要再添加一个getDocumentContents函数，它会在页面加载完毕之后调用回调函数。这个回调函数只有一个参数，用来接收 XMLHttpRequest 对象的响应内容。这样我们就可以轻松地加载多种 TVML 文件。

[cpp] view plaincopy

1. function getDocumentContents(url, loadCallback) {

2. var templateXHR = new XMLHttpRequest;

3. templateXHR.responseType = "document";

4. templateXHR.addEventListener("load", function { loadCallback(templateXHR) }, false);

5. templateXHR.open("GET", url, true);

6. templateXHR.send;

7. return templateXHR;

8. }

代码和之前定义的getDocument方法几乎一样，区别是这里是异步操作，而且不会在界面上显示任何内容。

有个这个函数，我们就能执行下面的调用，当 OK 按钮被点击时替换屏幕上的警告内容。

[cpp] view plaincopy

1. App.onLaunch = function(options) {

2. alert("Hello!", function {

3. var helloDocument = getDocumentContents("http://localhost:8000/hello.tvml", function(xhr) {

4. navigationDocument.dismissModal;

5. navigationDocument.pushDocument(xhr.responseXML);

6. });

7. });

8. }

我们使用stackTemplate模板来改写hello.tvml文件，这样界面会更有趣。stackTemplate非常适合用来展示一组包含标题和图片的列表内容。下面是本例用到的内容：

[html] view plaincopy

1. <document>

2. <stackTemplate>

3. <banner>

4. <title>Which Artist Do You Prefer?</title>

5. </banner>

6. <collectionList>

7. <shelf>

8. <section>

9. <lockup>

10. <img src="http://localhost:8000/nina.png" width="256" height="256" />

11. <title>Nina Simone</title>

12. </lockup>

13. <lockup>

14. <img src="http://localhost:8000/coltrane.png" width="256" height="256" />

15. <title>John Coltrane</title>

16. </lockup>

17. </section>

18. </shelf>

19. </collectionList>

20. </stackTemplate>

21. </document>

这基本上就是stackTemplate的布局方式，banner是顶部的横幅内容，collectionList包含许多shelf对象，而shelf对象则包含许多section对象，section对象又包含许多lockup对象，最后这个才真正包含我们的图片和标题。在本例中我向目录中添加了一些图片，它们是nina.png和coltrane.png。

本文为CSDN原创，点击“阅读原文”可查看完整文章并参与讨论。

如果您喜欢这篇文章，请点击右上角“…”将本文分享给你的朋友。