Xcode 9 集成了 Xcode Server,苹果提供了一个自带的 CI 方案。之前我使用的是 Jenkins + fastlane 的方案,所以我尝试了下能否用 Xcode Server 作为代替。
配置 Xcode Server
首先下载 Xcode 9,在 Xcode 设置的最后一个页签就能找到 Xcode Server。
点击右上角的 OFF/ON 按钮打开 Xcode Server,Xcode 会弹出提示让你创建 Xcode Server,推荐使用新的非管理员 Mac 账号。
完成之后 Xcode 就会在 Mac 账号下自动配置和创建一个 Xcode Server 服务,这样服务端的任务就完成了,是不是很简单。
设置客户端
现在你有了一个 Xcode Server 服务,那怎么才能搭建 CI ?这时候需要创建一个客户端。还是在 Xcode 的配置菜单里,切到第二个 Accounts 页签内,点击左下角的加号。
在弹出的菜单里选择 Xcode Server。团队里的每个人都可以建立一个客户端账号,对于没有修改 Xcode Server 权限的人就只需要选择 Guest 账号登录即可。
创建 Bot 🤖️
最后,通过创建 Bot 来运行具体的 CI 任务。点击 Xcode Menu 里的 Product -> Create Bot...
Xcode 会弹出 Bot 的配置页面,一步一步的按需求配置即可,所有的配置之后也可以再编辑。
创建好 Bot 之后,可以在 Xcode 的 report navigator 里查看。
右键点击 Bot 就可以做 创建/编辑/删除 等操作,还可以在网页上查看 Bot 的状态。可以给 integrate(集成)配置 trigger,有任务之前和之后执行的两种脚本。点击 integrate 会在右侧看到报表数据,包括任务状态、测试数据、打印信息等。
Xcode Server 是 Xcode 9 发布之前就已经有的,所以有一个旧的配置文档可以参考 Xcode Server and Continuous Integration Guide。
发布
如果之前使用过别的 CI 工具,不如 Jenkins、fastlane 等,Xcode Server 相比可能没有那么强大。只是用来给工程做 编译 CI 或者测试还好,但如果需要发布就不太好用了。
OTA
测试包的部署一般都需要 OTA 安装,即通过 itms 协议直接在网页安装 ipa 包。Xcode Server 集成的网页是由 OTA 安装的,但是通过提示得知苹果为了安全,OTA 安装只能通过服务器的局域网域名 server.local
来访问。而 server.local
在不同网段貌似是没有广播,导致一般情况下无法访问。
Triggers
另一种方法是通过 triggers 将打好的包上传到测试平台(比如 HockeyApp)或者上传到 TestFlight 用于提交审核。
比如可以添加一个 post-ingegration scripts 来上传 ipa。 如果使用 fastlane,可以在 fastfile 里用类似ENV[‘XCS_ARCHIVE’]
的方式来配置环境变量,具体查看Xcode Server Environment Variable Reference。
但是我试过几次之后发现会出现一些奇怪的问题,比如无法通过 ENV[‘XCS_ARCHIVE’]/dSYMs
获取到 dsym 的路径。
如果在 Bot 配置里选择了 export Archive 选项,Xcode Server 在任务成功后会导出 Archive 包并提供下载。但是经常碰到 Archive 包无法下载的情况,而同时 ipa 包下载就没有问题,而且也排除了是网络问题。
结论
Xcode Server 非常容易配置和使用,但并不足以取代成熟的 CI 方案(比如 Jenkins + fastlane)。所以我现在使用 Xcode Server 做 CI 和 测试,同时使用 fastlane 做发布。希望之后 Xcode 9 能更新 Xcode Server 的功能和稳定性。