如何优雅地使用 Playground

苹果为推动 Swift 的发展花了很大的力气,Playground 就是其中的一个。Playground 大大降低了 Swift 的学习门槛,它可以实时执行 swift 代码,并将结果显示出来,并且还有各种交互来加深你对 swift 语法的理解。

但是你要是以为这就是 Playground 的全部功能,你就错了。其实 Playground 还有很多其它的高级用法,特别是在 Xcode 7 之后,苹果再一次对 Playground 进行了改进,让它的功能更加强大了。

Sources 目录

通常情况下,我们直接在 Playground 上面写代码,然后编译器会实时编译我们代码,并将结果显示出来。这很好,我们可以实时得到代码的反馈。

但是这也会产生一个问题,如果我们写了一个函数,或者自定义了一个 view,这部分代码一般情况下是不会变的,而编译器却会一次又一次地去编译这些代码,最终的结果就是导致效率的低下。

这时,Sources 目录就派上用场了,使用 Cmd + 1 打开项目导航栏(Project Navigator),可以看到一个 Sources 目录。放到此目录下的源文件会被编译成模块(module)并自动导入到 Playground 中,并且这个编译只会进行一次(或者我们对该目录下的文件进行修改的时候),而非每次你敲入一个字母的时候就编译一次。 这将会大大提高代码执行的效率。

注意:由于此目录下的文件都是被编译成模块导入的,只有被设置成 public 的类型,属性或方法才能在 Playground 中使用。

资源

由于 Playground 并没有使用沙盒机制,所以我们无法直接使用沙盒来存储资源文件。

但是,这并不意味着在 Playground 中没办法使用资源文件,Playground 提供了两个地方来存储资源,一个是每个 Playground 都独立的资源,而另一个是所有 Playground 都共享的资源。

独立资源

在打开的项目导航栏中可以看到有一个 Resources 目录,放置到此目录下的资源是每个 Playground 独立的。

这个目录的资源是直接放到 mainBundle 中的,可以使用如下代码来获取资源路径:

if let path = NSBundle.mainBundle().pathForResource("example", ofType: "json") {
    // do something with json
    // ...
}

如果是图片文件,也可以直接使用UIImage(named:)来获取。

共享资源

共享资源的目录是放在用户目录的 Documents 目录下的。在代码中可以直接使用
XCPlaygroundSharedDataDirectoryURL
来获取共享资源目录的 URL(需要先导入 XCPlayground 模块)。

import XCPlaygroud

let sharedFileURL = XCPlaygroundSharedDataDirectoryURL.URLByAppendingPathComponent("example.json")

注意:你需要创建~/Documents/Shared Playground Data目录,并将资源放到此目录下,才能在 Playground 中获取到

异步执行

Playground 中的代码是顶层代码(top-level code),也就是它是在于全局作用域中的。这些代码将会从上到下执行,并在执行完毕之后立即停止。

我们的异步回调代码一般都无法在程序结束之前获得执行,因此如果我们在 Playground 执行网络,或者其它耗时的异步操作,都无法获得我们想要的结果(之前我在 Playgroud 中学习网络操作的时候,就被这个特性折磨到发狂,我一直以为是自己的网络代码写错了)。

为了让程序在代码执行结束后继续执行,我们可以使用如下代码:

XCPlaygroundPage.currentPage.needsIndefiniteExecution = true

这句代码会让 Playground 永远执行下去 ,当我们获取了需要的结果后,可以使用XCPlaygroundPage.currentPage.finishExecution()停止 Playground 的执行:

import XCPlayground

XCPlaygroundPage.currentPage.needsIndefiniteExecution = true

let url = NSURL(string: "http://httpbin.org/image/png")!
let task = NSURLSession.sharedSession().dataTaskWithURL(url) {
    data, _, _ in
    let image = UIImage(data: data!)
    
    XCPlaygroundPage.currentPage.finishExecution()
}
task.resume()

支持 Markdown

Playground 已经原生支持 markdown 注释渲染,只需要在单行或多行注释的后面添加冒号:,标记这是一个 markdown 注释。

//: This line will have **bold** and *italic* text.

/*:
## Headers of All Sizes

### Lists of Links

- [NSHipster](http://nshipster.com)
- [ASCIIwwdc](http://asciiwwdc.com)
- [SwiftDoc](http://swiftdoc.org)
*/

可以到菜单 Editor → Show Rendered Markup 下切换是否进行 markdown 渲染。

markdown渲染

多页面

Playground 支持多页面,这可以让我们将不同类别的代码分别写到不同的页面下,并可以在多个页面之间进行跳转。

playground多页面

在项目导航栏中,选择File > New > Playground Page, 就可以新建一个页面,或者选择项目导航栏左下角的 + 号选择 New Page

注意:如果本 Playground 是第一次新建 Page,则系统会产生两个 Page,一个代表你当前的页面,一个是新建的页面。

页面跳转

Playground 支持三种方式的页面跳转:

  1. 上一页
  2. 下一页
  3. 跳转到指定页

页面顺序都是根据它们在项目文件中的排序来决定的。

上一页与下一页的语法:

//: ["Go to Next Page"](@next)
 
//: ["Go to Previous Page"](@previous)

与 markdown 中的超链接类似,方括号中的代码要显示的文字,而小括号则代表跳转的目的地。

指定页跳转:

//: ["Go to The End"](PageName)

PageName 代表目标页面的名称,如果页面名称中有空格,则需要使用%20来代替,这是 ASCII 中空格的符号。如下:

//: ["Go to The End"](Last%20Page)

总结

Playground 中还有很多其它的高级功能,这里只是列出了我自己比较经常用到的功能,如果你比较感兴趣,可以参考官方文档,或者这本书

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容