jenkins+fastlane 持续集成iOS项目（内附多个踩

2020-06-18 本文已影响0人 Smalla

1、下载好 JDK ，双击安装：

图1.jpg

图2.jpg

图3.jpg

2、在 Jenkins 的官网下载最新的 war 包。下载完成后，打开终端，进入到 war 包所在目录，执行以下命令：

java -jar jenkins.war --httpPort=8080

启动成功如图示：

图4.jpg

待Jenkins启动后，在浏览器页面输入以下地址:

http://localhost:8080

展示如下：

图5.jpg

按照提示步骤操作，设置相应的管理员账号和密码，一直到最终进入Jenkins配置页：

图6.jpg

3、新建Item，输入项目名称，选择"Freestyle project"，点击"确定"：

图7.jpg

4、项目生成成功，比如名称为：A ，如此，Jenkins下就会多一条名称为A的项目：

图8.jpg

5、进入A项目，点击左边栏"配置"选项，根据需要配置相关信息，配置完成点击保存：

图9.jpg

踩坑记录：

1、构建报错：

FATAL: null
java.lang.NullPointerException ...

图10.jpg

解决方案：这个问题耗费了好长时间，最后发现是因为项目名称为中文，没有跟集成项目名保持一致，导致无法正常找到该项目路径报错。这里我的集成项目命名为：ABC，那么在第三步新建Item，输入的任务名称就必须也是ABC，与之对应。

2、归档失败，加载cocoapods集成的第三方文件失败：

Could not read serialized diagnostics file: Cannot Load File: Failed to open diagnostics file (in target 'Toast' from project 'Pods')

Could not read serialized diagnostics file: Cannot Load File: Failed to open diagnostics file (in target 'SDWebImage' from project 'Pods')�[0m
�[33m▸�[0m �[39;1mCompiling�[0m UIView+WebCache.m

screenshot11.jpg

解决方案：这种一般常见于集成了cocoapods管理第三方库项目，只需在jenkins的job项目命令行里加上：pod install即可

pod install
// fastlane打包脚本
bundle exec fastlane adhocLane

screenshot12.jpg

3、打包应用程序时出错：

** EXPORT FAILED **
[31mExit status: 70�[0m

error: exportArchive: Provisioning profile "A_AdHocProfile" doesn't include signing certificate "Apple Distribution: xxx公司. (xxx)".

Error packaging up the application�

screenshot13.jpg

解决方案：从错误日志来看，说的是导出失败，profile不包含Apple Distribution开头的签名证书，原因是苹果从Xcode11版本之后，要求额外再生成一份Apple Distribution签名的描述文件，

screenshot14.jpg

下载描述文件之后，双击安装，然后在jenkins的manage jenkins->Keychains and Provisioning Profiles Management里操作：

screenshot15.jpg

注意：
1、新版Mac系统下的登录钥匙串文件名为：login.keychain-db，直接上传至jenkins会报格式错误。
操作方法是将该文件拷贝至桌面，然后更改文件格式为：login.keychain，再次上传即可。

2、Keychain里Code Signing Identity的名称需要去系统钥匙串找到相应证书，打开"显示简介"，拷贝出证书名称粘贴即可。

4、Could not find action, lane or variable 'pgyer'

screenshot19.jpg

解决方案：fastlane增加了打完包自动上传蒲公英脚本，但是未安装蒲公英插件，在项目根目录下执行命令行：fastlane add_plugin pgyer即可解决。

5、Could not find fastlane-plugin-pgyer-0.2.2 in any of the sources

screenshot16.jpg

fastlane安装完蒲公英插件，直接用fastlane脚本跑是OK的，但在jenkins里跑，就会报源找不到fastlane-plugin-pgyer

解决方案：删除fastlane里安装的蒲公英插件，然后在jenkins里配置蒲公英插件及上传脚本

插件名：Upload to pgyer

screenshot17.jpg

名词解释：
1、pgyer uKey：注册蒲公英的User Key
2、pgyer api_key：注册蒲公英的API Key
3、scandir：jenkins里导出包的路径，要跟fastlane打包脚本的路径对应
4、file wildcard：包的文件名，一般是：xxx.ipa

6、Failed to connect to GitHub to update the CocoaPods/Specs specs repo

screenshot20.png

解决方案：这种一般是网络问题，导致pod update执行失败，更换网络或者翻墙反复尝试即可。

7、上传至蒲公英时未找到包文件

[UPLOAD TO PGYER] - scan dir:/./Packages
[UPLOAD TO PGYER] - scan dir isn't exist or it's not a directory!
[UPLOAD TO PGYER] - The uploaded file was not found，plase check scandir or wildcard!

screenshot21.jpg

解决方案：jenkins的job项目里，配置好上传至蒲公英包路径，这里我是直接写入jenkins里面的绝对包路径

screenshot22.jpg

8、如果需要其他设备通过域名形式访问打包机，设置如下：

1、终端找到路径/usr/local/Cellar/jenkins/2.240/homebrew.mxcl.jenkins.plist；
2、打开homebrew.mxcl.jenkins.plist，修改"--httpListenAddress=打包机IP"，保存；
3、重启jenkins服务。