Swift：漂亮的 print() Pt.2

   <p>时尚日志，由你做主</p>    <p>在 之前的文章 中，我们讨论了在输出日志中使用 emojis 的好处，它可以帮助我们更好的去消化和吸收大量的信息，不过我提供的实现方式并不怎么样，没有足够多的例子供你将其应用在自己的代码中。</p>    <p>我将遵守之前的约定继续讨论这个话题，向你展示如何使用 emojis 来实现输出日志的功能，只需在 print 函数上再多花费一点儿工夫。</p>    <h2>节省成本</h2>    <p>在接下来的文章中，我会打破 Swift 的命名规范，这样做我可不缺理由。为了降低新方案的成本, 要在尽可能减少键盘敲击次数的情况下达到同样的目标，比如字母大小写和标题大小写的问题。不管怎么样，如果看到文章的最后，你还在为一些细节而纠结的话, 你绝对应该把它们改成你想要的样子。</p>    <h2>介绍 log</h2>    <pre>  <code class="language-swift">enum log { }  </code></pre>    <p>这里使用枚举类型代替类或结构的原因很多。原因之一是，我们永远不需要实例化一个日志。选择枚举而不是函数，是想确保实现一个安全的日志输出方案。不用着急，一会你就会明白我所说的“安全”的含义了.</p>    <h2>枚举成员与值关联</h2>    <pre>  <code class="language-swift">enum log {      case ln(_ line: String)      case url(_ url: String)      case obj(_ any: AnyObject)  }  </code></pre>    <p>可能有些人还不知道 ln (line) 曾经在 swift 语言中出现过。 print() 在 Swift 2.0 之后替代了 println() , 且主要用于日志输出。我在这里举了一些例子来解释 log 枚举的可扩展性。</p>    <p>要先为每一个枚举值设置关联值，毕竟得现有东西才能输出日志吧？请注意，这里忽略了参数标签，因为已经使用参数名称来描述函数的参数了。</p>    <p>看一下目前的情况吧：</p>    <pre>  <code class="language-swift">print(log.ln(“Hello World”))  // ln("Hello World")    print("Hello World")  // "Hello World"  </code></pre>    <p>嗯，看样子似乎是完成了。但这看起来并不是一个可以替代 print 的方案。主要原因有这些：</p>    <ul>     <li>还是要敲击很多次键盘</li>     <li>除了原始信息外还有许多不必要的内容</li>     <li>外表不怎么样</li>     <li>没有一个 emojis</li>     <li>千言万语，就一句：“这方案太糟糕了”</li>    </ul>    <p>现在需要完善上面的五个问题, 以便实现之前定下的目标.</p>    <h2>自定义运算符</h2>    <pre>  <code class="language-swift">postfix operator / { }  </code></pre>    <p>先假定你们大多数人在这之前都没有遇到过自定义运算符的需求。没关系，我也是最近才用上这个功能, 不过用的也不是太多.</p>    <p>要创建一个 postfix 后置运算符，展示的内容会出现在运算符的左侧，想让它出现在日志代码的后面, 只用敲击一次键盘就能实现。</p>    <p>选择 / 符号是因为它最接近注释符号但不会真正产生注释，另外它也是少数几个不用 shift 键来就可以直接打出来字符。</p>    <p>…感觉自己就像是政客，在不停的想办法减少实现预算。</p>    <h2>实现</h2>    <pre>  <code class="language-swift">postfix func / (target: log) {       switch target {      case ln(let line):          log(":pencil2:", line)      case url(let url):          log(":earth_asia:", url)      case obj(let object):          log(":small_blue_diamond:", object)  }  </code></pre>    <p>这段代码看起来像声明，有代码主体（body）, 增加了在约束，确保自定义操作符接收的参数是 log 枚举值，这在一定程度上符合我所说的的“安全代码”。“安全代码”这个概念还体现在使用枚举替代类或结构体，因为枚举中的 switch 一定会把所有情况都检查一遍。这样，每次想在输出日志中添加一个新的 emoji 时, 也必须将其添加到操作符中的 switch 语句里。</p>    <pre>  <code class="language-swift">private func log<T>(emoji: String, _ object: T) {      print(emoji + “ “ + String(object))  }  </code></pre>    <p>终于得到了这个看似非常简单 log 函数。它是一个私有函数，可不被 .swift 文件之外的任何东西访问到，另外它的第二个参数是一个泛型，这个参数能够接受任意类型的值。</p>    <p>正如你所看到的一样，这是一个相当简单的打印语句，把 emoji 表情和对象用空格连起来。</p>    <h2>用起来</h2>    <pre>  <code class="language-swift">log.ln(“Pretty”)/  :pencil2: Pretty  log.url(url)/  :earth_asia: http://www.andyyhope.com  log.obj(date)/  :small_blue_diamond: 2016–04–02 23:23:05 +0000  Maybe i should use a screenshot here instead?  </code></pre>    <p>现在我们有一个可以替代系统原有输出日志的方案了, 新方案只需要进行两次敲击，相比其他的日志输出工具，脱颖而出、畅快淋漓。不过这还没完呢…</p>    <h2>性能提升</h2>    <p>大多数的程序员都会有这么一个共识，就是调用 print 方法会降低 app 的性能。如果含有 print 的代码散落在程序的不同地方, 在 debug 的时候还是可以接受, 可是要把 app 上传到 AppStore 时，最好还是移除这些内容。</p>    <p>“你是在说，每一次我都必须在提交 App Store 前注释掉所有的 print 语句, 然后再在 debug 的时候把它们恢复回来么?” —— 你</p>    <h2>预编译标识符</h2>    <p>可以用 Xcode 给工程创建配置文件, 在默认情况下 Xcode 会为每个工程提供两个配置文件 : Debug 和 Release.</p>    <p>在使用模拟器或用 USB 连接真机时，默认模式是 debug，用手机打开从 AppStore 下载的 app 时，默认模式是 relsase。</p>    <p>把刚才写好的代码放入到用于标识 debug 状态的预编译标识符里, 这样就不用在每次打包的时候对这些代码进行注释/恢复/增加/删除等操作。相当于告诉编译器：“Hi，哥们，除了 release 模式下， 你都得运行这段代码！”</p>    <h2>Build Settings</h2>    <p><img src="https://simg.open-open.com/show/d241ad98fbdbf22d3cd105423f26df7c.png"></p>    <ol>     <li>点击 Project Navigator 图标</li>     <li>点击 Project 名称</li>     <li>点击 Build Settings 按钮</li>     <li>搜索 “Compiler Flag”</li>     <li>展开 “Other C Flags”</li>     <li>点击 “+” 按钮</li>     <li>输入 “-D DEBUG”</li>    </ol>    <p>最终把整个 print 函数放到预编译的标识符中。</p>    <pre>  <code class="language-swift">private func log<T>(emoji: String, _ object: T) {      #if DEBUG          print(emoji + “ “ + String(object))      #endif  }  </code></pre>    <p>哦了！现在只有在开发状态下 print 才会生效。把 build configuration scheme 设置改为Release，运行 app，这样就可以检测之前的操作是否成功，当然别忘了检测完把状态切回到 Debug 模式。</p>    <h2>做一个支持 Carthage 或 Cocoapod 的框架</h2>    <p>读到这, 也许会想：“这些个点子太好了, 如果 Andyy 将这些功能弄成一个…”，但事实是这样做并不好。</p>    <p>原因就是, 假如我提供了上面三种方式中的任意一种, 那么每当你想利用它做日志输出的时候，你就必须在 Swift 文件里引入这个库, 这样做实在太傻了, 还需要做一些额外的操作来管理它们。这也是为什么许多 NSLog 的替代品在 Objective-C 中表现不好的原因。</p>    <pre>  <code class="language-swift">import Log // 这看起来像坨 :hankey:  </code></pre>    <h2>探索和把玩</h2>    <p>我专门提供了一个 playground 文件，能够让你测试一下今天所读到的全部内容，如果想使用这个文件，只需要将 log.swift 文件拖入到工程中即可。另外在示例代码中会有一些额外的枚举值, 或许你会发现这些额外的例子对你的日常工作很有用, 如果是这样的话，拿走不谢!</p>    <p>示例代码 可以在 Github 上下载到.</p>    <p>就像之前一样, 如果你喜欢今天读到的内容或者亲手实现了它，请记得发我一个 tweet 。很渴望听到你们的声音, 让我很受用.</p>    <p> </p>    <p> </p>    <p>来自：http://swift.gg/2017/02/21/swift-pretty-in-print-pt-2/</p>    <p> </p>