Swift GYB 简易教程,一个 Swift 内部使用的模板生成源文件工具

[中文教程]
分享到:  QQ好友和群QQ好友和群 QQ空间QQ空间 腾讯微博腾讯微博 腾讯朋友腾讯朋友 微信微信
查看查看238 回复回复2 收藏收藏 分享淘帖 转播转播 分享分享 微信
查看: 238|回复: 2
收起左侧

[中文教程] Swift GYB 简易教程,一个 Swift 内部使用的模板生成源文件工具

[复制链接]
cocoaswift 发表于 2016-7-5 18:36:37 | 显示全部楼层 |阅读模式
快来登录
获取最新的苹果动态资讯
收藏热门的iOS等技术干货
拷贝下载Swift Demo源代码
GYB(模板生成)是一个 Swift 内部使用的工具,可以用模板生成源文件。

Swift GYB 简易教程

Swift GYB 简易教程,一个 Swift 内部使用的模板生成源文件工具 - 敏捷大拇指 - Swift GYB 简易教程


如果你有多个结构体/类/枚举在共享同一个通用的结构,并且你不想维护那些相同的代码,就可以用 GYB。如果你经常需要给不同的对象写一些相似的方法或者属性,那你的维护工作(由于粗心的复制/粘贴导致的错误)就可以全部交给 GYB。这个工具在 Swift 代码库 中广泛使用,很容易就可以将它应用到你的项目中。

作为一个勤奋的荷兰猪(原文 guinea-pig,也可译为豚鼠)(据我所知,目前唯一使用 GYB 的项目是 Swift-JNI,该项目是安卓的 Swift 移植项目的一部分)我在一个用于简化 Swift 位运算的库 Bitter 中广泛使用了 GYB,在这个库里我写了很多相似的代码来扩展固定长度的 Swift 整型变量。

有了这个工具,我就不需要手工输入所有代码。我只需定义一个模板,就可以用 GYB 工具创建十个扩展。

让我们来看看如何使用 GYB。GYB的实战可以参考《通过 LeetCode 最简单的一道题探究 Swift 源码》。




1、GYB 引擎元素

使用 GYB 模板引擎相当简单,但是需要一点 Python 知识。模板是由这些元素组成:

  • 用 Python 来控制语句流,每行代码由 % 开始(空格会被忽略),如你所想,每行代码也由 % 结束,语句可以嵌套。
  • 不以 % 开头的语句被视为文本,会被直接输出。
  • ${VARIABLE_NAME} 形式的元素会被 VARIABLE__NAME 的值替换。
  • 字符 % 和 $ 分别用 %% 和 $$ 表示。
  • Python 代码块可以添加到模板中,用 %{ 和 }% 括起来,代码块外的缩进会被剥离,使你的 Python 代码不会受到影响。


让我们用这几个简单的规则来做一个例子,拿 Bitter 的模板 来说,用 allOne 为所有固定长度的整形变量添加一个计算属性,就会返回一个由带有 allOne 的位模式初始化后得到的整型变量/无符号整形变量:

[Swift] 纯文本查看 复制代码
%{
  intTypes = [8,16,32,64]
}%

% for intType in intTypes:
    % for sign in ['','U']:

/// Extension that adds a few additional functionalities to ${sign}Int${intType}
extension 
${sign}Int${intType} {

        /// Returns a ${sign}Int${intType} with all ones
        %if sign == '':
    public static var allOnes:Int${intType}{return Int${intType}(bitPattern: UInt${intType}.max)}
        %else:
    public static var allOnes:UInt${intType}{return UInt${intType}.max}
        %end

}
    %end
%end


有了 Python 代码块,我们就可以在 Swift 中建立一个固定长度整型数组,然后遍历它并使用内部循环来处理有符号和无符号整数。然后,我们可以根据符号变量的值输出两个不同的代码片段。如果标识变量为空(有符号整数)就输出第一个代码段,如果不为空(无符号整数),就输出第二个代码段。

在这个例子中,我们用到了简单的 if/else 语句和 foreach 语句,我们也可以使用一切在 Python 中合法的语句,比如 elif 或者 for 的变体。

执行 GYB,会得到 8 个扩展,对应到每一个固定长度整型变量,范围从 Int8/Uint8 到 Int64/Uint64。




2、生成源代码

你可以从 Swift 仓库下载 GYB:

[Shell] 纯文本查看 复制代码
wget [url=https://github.com/apple/swift/raw/master/utils/gyb]https://github.com/apple/swift/raw/master/utils/gyb[/url]
wget [url=https://github.com/apple/swift/raw/master/utils/gyb.py]https://github.com/apple/swift/raw/master/utils/gyb.py[/url]
chmod +x gym


通过如下方式解析模板:

[Shell] 纯文本查看 复制代码
./gyb --line-directive '' -o ../Sources/Bitter/Bitter.swift Bitter.swift.gyb


-o选项指定输出文件,最后一个文件名指定包含模板的文件的名称。

[Shell] 纯文本查看 复制代码
--line-directive ''
参数为缺省,GYB 输出会增加调试信息,在原始模板中每一部分的输出描述元素会被执行。

当你在调试自己写的模板时,调试信息会很有用。一旦模板完成之后,可以禁用调试的注释,让输出清爽一些。

GYB的实战资料可以在《通过 LeetCode 最简单的一道题探究 Swift 源码》这个帖子里了解到。

要评论?在 Twitter 上戳我。




相关内容:

通过 LeetCode 最简单的一道题探究 Swift 源码

Swift GYB 简易教程,一个 Swift 内部使用的模板生成源文件工具

总结一些iOS项目中组织代码的方法 clean code

Swift实战-模板模式




作者:Umberto Raimondi

译者:ahfepj

都看到这里了,就把这篇资料推荐给您的好朋友吧,让他们也感受一下。

回帖是一种美德,也是对楼主发帖的尊重和支持。

*声明:敏捷大拇指是全球最大的Swift开发者社区、苹果粉丝家园、智能移动门户,所载内容仅限于传递更多最新信息,并不意味赞同其观点或证实其描述;内容仅供参考,并非绝对正确的建议。本站不对上述信息的真实性、合法性、完整性做出保证;转载请注明来源并加上本站链接,敏捷大拇指将保留所有法律权益。如有疑问或建议,邮件至marketing@swifthumb.com

*联系:微信公众平台:“swifthumb” / 腾讯微博:@swifthumb / 新浪微博:@swifthumb / 官方QQ一群:343549891(满) / 官方QQ二群:245285613 ,需要报上用户名才会被同意进群,请先注册敏捷大拇指

嗯,不错!期待更多好内容,支持一把:
支持敏捷大拇指,用支付宝支付10.24元 支持敏捷大拇指,用微信支付10.24元

评分

参与人数 1金钱 +10 贡献 +10 专家分 +10 收起 理由
Anewczs + 10 + 10 + 10 32个赞!专家给力!

查看全部评分

3rdev 发表于 2016-7-6 02:29:55 | 显示全部楼层
自动生成吗?
3rdev 发表于 2016-7-7 02:37:48 | 显示全部楼层
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

做任务,领红包。
我要发帖

分享扩散

都看到这里了,就把这资料推荐给您的好朋友吧,让他们也感受一下。
您的每一位朋友访问此永久链接后,您都将获得相应的金钱积分奖励
热门推荐

合作伙伴

Swift小苹果

  • 北京治世天下科技有限公司
  • ©2014-2016 敏捷大拇指
  • 京ICP备14029482号
  • Powered by Discuz! X3.1 Licensed
  • swifthumb Wechat Code
  •   
快速回复 返回顶部 返回列表