alias exemyfile="ruby myrubyfile.rb"
then enter exemyfile command in your terminal, it works as you want.
用来打包做类似事情的工具很多,更主要的是为什么使用自动构建:
• 效率上,解放出开发人员的时间。也更方便其他同事使用。
• 保证打包的标准,避免配置或环境问题,带来的失败。把事情做对,比做快更重要。
• 权限安全上,通过构建系统集中管理,对于使用者来说是一个黑盒。
• 项目流程上,便于有需求时做 Daily Build 或者 自动测试。
对于 如何安装 Jenkins 或者 Jenkins 参数配置 之类的基本配置不做涉及。
网上已经有不少详细的文章进行介绍。比如 手把手教你利用Jenkins持续集成iOS项目 https://www.jianshu.com/p/41ecb06ae95f 。
先介绍整体的构建流程,具体的内容会在下面分步骤介绍.
构建前
• 设置构建名
• 配置 app 图标水印(build号,分支)
• ruby 脚本根据参数,修改工程 bundleID ,宏等
• 安装第三方依赖,pod update
执行构建
• xcodebuild clean
• xcodebuild archive
• xcodebuild exportArchive
构建完成
• 上传分发平台: 蒲公英/fir/appstore(历史版本记录: git tag )
• 符号表处理:上传 bugly
• 归档产物: 上传 FTP 服务器
• 清理: 删除 IPA 等
• 设置构建描述
• 通知: 企业微信 webhook 机器人推送
首先设置我们的构建名称,我这里使用到几个参数:
• BUILD_NUMBER ,Jenkins 自带的参数,代表第几次构建
• BetaPlatform ,设置的选项参数,代表分发平台。我这里的值分别是:fir,pgyer,appstore
• Mode,设置的选项参数,代表 Xcode 构建的环境设置,为 Snapshot 和 Release
• Branch,Jenkins 自带的参数,代表 Git 分支名称
为了打包后进行测试的 APP ,便于定位问题,可以在 App Logo 上打上水印,加入构建使用的 git 分支名,jenkins 构建号,app 版本号 等关键信息。
配置图标水印的流程为:
• 判断此次是否为 appstore 分发平台。如果是 appstore 的话,将旧有的图标目录清理掉,然后将图标复制到使用的目录中。
• 如果不是 appstore ,则为测试平台分发,进行水印处理。
因为要使用替换资源的方式,所以准备两个目录。
一个目录作为 源目录,存放未处理的图片。一个目录作为目标目录,存储 App Logo 使用的图片。
为什么使用两个图片目录存储?假设只用一个,原图为A,当第一次处理,图片为 A1水印图片,当第二次再拿到的图片,已经是被处理过的 A1水印图片了,而不是原图A 。
这里注意 icons_path 为存放原图的地址, icons_dest_path 为要修改使用的目标路径。命名为 AppIcon-Internal。
可以参考 iOS APP图标版本化 https://www.jianshu.com/p/a37e114b7e66
关于 version 的获取, 因为目前版本有改动,使用 ruby 去获取,脚本会在后面提供链接:
还有一个临时存放路径,要提前创建好这个文件夹:
添加水印主要使用到了命令行工具 ImageMagick ,所以要先安装:
具体的脚本如下:
这里使用 ruby 实现参数修改(当然也可使用 python 等各种语言,自己方便就 OK )。
目前做的操作:
• 区分是否 beta 版本 -- 修改定义 beta 宏 的真假值
• 不同分发平台,使用不同 bundleID -- 对 bundleID 进行修改
脚本里依靠 CocoaPods 开源的 Xcodeproj ,对工程的 name.xcodeproj/project.pbxproj 文件进行配置修改。
python 的话,可以使用这个项目 mod-pbxproj
安装/更新第三方库,这里使用到的是 Cocoapods,其它的包管理器可使用其它方式。
在开始之前,我们要做些准备工作,比如设置要使用的变量,常量。
需要提前写好,尽量避免散落。
旧有的方式,是直接通过 info.plist 取:
然而在新的 Xcode 取 版本号 和 bundleID 的方式发生变化,现在 info.plist 里的值是变量名,取版本号为 $(MARKETING_VERSION) , bundleID 为 $(PRODUCT_BUNDLE_IDENTIFIER) .
结局思路是通过脚本到工程配置里去获取,下面使用 ruby 实现了这两个目的。
我们将 App 与 Jenkins 的 build number 设置为同一个,方便需要时,查看构建的参数以及符号表等:
加入 security 解锁操作的原因,是在子节点 ssh 登录上去之后,keychain 没有被解锁.导致打包失败.
解决方案是用 security unlock-keychain 命令将证书解锁。
另外可以通过命令查看描述文件的详细信息 包括UUID等信息
对工程进行构建打包,主要在于使用 Xcodebuild .
分为三个阶段:
• Clean
• Archive
• Export
如果在执行过程中又不喜欢日志输出的,可以在命令行最后加上
每次构建时,对工程进行 clean ,保证没有其它影响的因素。
使用xcodebuild clean [-optionName]...清除编译过程生成文件,使用如下:
非 cocoapods 的工程,将 -workspace "${APP_NAME}.xcworkspace" 换成 -project ${APP_NAME}.xcodeproj 即可。
新版本的 Xcode 有了新的构建系统,使用 -UseModernBuildSystem= 来做新旧区分。
Xcodebuild archive
更新到Xcode9.0后,之前写的自动打包脚本不可用了。
需要添加 -allowProvisioningUpdates,获取访问钥匙串权限的关键所在,设置了这个字段就会在打包过程弹框请求获取钥匙串内容权限。
特别说明的是,exportOptionsPlist 一定要检查,不同的环境和分发平台要选择对。
最简单方式,就是调好需要的环境后,直接手动 archive ,export 出来,使用产物里的 exportOptionsPlist 文件。
检查对应路径是否有 **.ipa 文件:
这里分为 蒲公英,fir,appstore 三个平台,上传 IPA.
下面使用的三个上传命令,最好先提前在机器上实验可以正常用再构建。
上传 bugly
进行完所有操作后,对于产物做一次保存,需要时可以用上。
首先将文件压缩
通过 FTP 插件,把 zip 文件上传到归档的路径下
删除 IPA 等文件,注意的是,当状态为 success 才清理,避免有时上传出问题,可以进行手动上传。
设置构建描述
完成后,企业微信 webhook 机器人推送,效果如下:
这里设置成可选项,避免频繁打扰其它同事。脚本如下:
[1] https://juejin.im/post/6844903843994533896
[2] https://www.cnblogs.com/zhou--fei/p/11371019.html
[3] https://www.jianshu.com/p/4f4d16326152
[4] https://www.jianshu.com/p/f50053d50436
[5] https://dengweijun.com/2018/12/26/Xcode%E8%87%AA%E5%8A%A8%E6%89%93%E5%8C%85%E9%82%A3%E4%BA%9B%E4%BA%8B/
正常的打包流程需要使用Xcode配置证书-执行打包-导出ipa文件-上传到第三方发布平台,例如蒲公英或者Fir。如果想只通过一行命令完成所有打包流程,减少打包步骤,就需要用到一个神奇的工具了。
fastlane 这个工具牛逼之处就是几乎包含了和ipa相关的所有功能,例如打包、提交审核、测试、自动截屏等等。这里就主要介绍一下其中的打包工具gym。
这里先说一下fastlane的安装,很简单只需在终端输入:
(需提前安装gem环境)
在安装fastlane时已默认安装了常用工具,所以不需要另外安装gym工具
调用gym需要cd到项目目录,然后执行
这个命令是自动打包然后推送到ITunesConnect中,在这个过程中需要输入AppId及密码。
如果不需要提交到ITunesConnet中,可执行
会自动生成ipa文件,以便后续操作。
详细的gym命令请参考 gym文档
之前一直是在fir的页面上进行操作,也是第一次在命令行使用fir。
安装 fir-cli
安装后可以先执行登陆操作,登陆后在后续操作中可以不用重复添加token了(token需要到fir个人账号中获得),登陆方法:
发布ipa到fir,需要提前准备好ipa文件,执行
为了实现一键打包的方案,需要将gym和fir结合到一起,这里利用了一个脚本文件,在使用时直接执行这个脚本文件即可,文件内容如下:
(1、使用该文件需要项目支持CocoaPods;2、本项目的项目名称是 Demo ,在实际使用时需要将 Demo 替换成自己的项目名称;3、需要将 XXX_YOUR_API_TOKEN_XXX 换成自己的fir token)
如文件名文 AutoPack.sh ,打包时只需要在cd到项目文件下,执行:
执行后会自动打包,ipa文件自动存储到工程文件同目录下的IPA文件夹下,并且会自动提交到Fir上,整个流程执行结束后会提示完成时间,如出现错误也会打印出来。
在执行上传到Fir上的时候遇到了SSL证书报错,最后找了半天原因是Ruby的数据源地址使用的https地址,换成http地址即可。 解决办法戳这里
1、 使用fastlane gym/xctool编写ipa打包脚本
2、 Fastlane自动化构建工具(完整解决测试和发布流程)
3、 Fastlane + Bugly自动化部署测试包
4、 iOS App 自动化上传 AppStore ,一键部署 App