iOS 的自动构建流程

Posted 2023-04-11

参考技术A

用来打包做类似事情的工具很多，更主要的是为什么使用自动构建:

• 效率上，解放出开发人员的时间。也更方便其他同事使用。

• 保证打包的标准，避免配置或环境问题，带来的失败。把事情做对，比做快更重要。

• 权限安全上，通过构建系统集中管理，对于使用者来说是一个黑盒。

• 项目流程上，便于有需求时做 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/

iOS-打包上架构建版本一直不出现/正在处理/自动消失

参考技术A

iOS开发过程中，打包上架苹果审核是一个不可或缺的环节。说实话，这个问题我遇见两次了，为了让自己长点记性，决定写下来。首先，列举几种情况：
1.iPa包上传至App store后，一个小时内不显示构建版本。（等待15分钟-25分钟是正常的）

2.“活动”栏目下，所有构建版本长时间显示“正在处理”，或者一段时间之后，构建版本直接消失不见。

结果：上述两种情况出现的时候，说明你的iPa包是有问题的，需要正确处理后，才能进行正常审核流程。
【切记】不要无脑等待了，也不要反复重新打包上传了，理智一点，这些都是无用功。
【正确做法】第一时间查看苹果开发者账号邮箱，任何异常情况都会有邮件通知的，只要你能看懂苹果发的邮件，基本也就知道了处理方法。

构建版本不出现大多数都是由于info.plist文件中没有添加相应的访问权限或者对权限key值没有添加对应的value提示语。
本人此次的问题是项目中接入了即时通讯功能，但没有添加通讯录和麦克风的访问权限导致的。收到的邮件如下：

【再次提醒】 当你上传iPa包后，长时间不出现构建版本时，不要无脑等待了，也不要反复重新打包上传了，第一时间去查看邮件。