ios/macos Jenkins+fastlane安装和配置问题汇总

此篇文章解释jenkins+fastlane安装和配置过程中遇到的问题和解决方法

以目前最新版本jenkins为例：即jenkins2.346.3

fastlane安装讲解见我的另一篇文章：Fastlane的集成和使用 包括 ios/mac 项目示例

jenkins安装和配置见我的另一篇文章：macos12 Jenkins 最新版本 安装和项目配置

一、brew安装jenkins失败

 ~ % brew install jenkins-lts httpPort=8090
 
 Error

1. 更新java JDK版本
2. 去掉httpPort=8090，安装成功后，再在设置页修改端口号(修改端口号方法见以下说明二、)即可

 ~ % brew install jenkins-lts 
 
 Success

二、jenkins管理界面，提示“反向代理设置有误”解决方法

以homebrew安装的jenkins为例：

• 1. 查看jenkins安装路径（cmd+shift+g "/usr/local/opt/jenkins"）下的配置文件.plist中设置的ip地址和端口号
• 2. 查看jenkins web前端界面：系统管理--->系统配置(Configure System)--->Jenkins Location--->Jenkins URL的ip和端口号
• 3.需要保证两处一致

反向代理设置有误.png

解决方法

• 1. mac电脑查看本机ipv4地址：
  • 方法一：终端输入： ipconfig getifaddr en0
  • 方法二：系统偏好设置-网络-wifi-高级-TCP/IP-IPv4地址
• 2. 找到jenkins安装目录
  • homebrew安装Jenkins的路径为/usr/local/opt/jenkins/homebrew.mxcl.jenkins.plist (或/usr/local/opt/jenkins-lts/homebrew.mxcl.jenkins-lts.plist)

• 3. 打开homebrew.mxcl.jenkins.plist文件，找到查看默认ip地址(127.0.0.1)和端口号(8090)，如图：

     
     
     homebrew.mxcl.jenkins.plist.png
• 4. 修改为：步骤1中的本机ipv4地址和任意端口号如8090
• 5. 浏览器输入 本机ipv4地址:8090/configure，修改Jenkins URL改为 http://本机ipv4地址:8090/

图2.png

三、手动配置Keychains and Provisioning Profiles Management点上传按钮无反应

• 系统管理-插件管理-搜索并安装Keychains and Provisioning Profiles Management
• 安装成功后找到 系统管理-最下方未分类的 Keychains and Provisioning Profiles Management，点击进入

图片.png

Keychains and Provisioning Profiles Management插件.png

• 网上较多说换低版本的jenkins如2.263.4就能解决，但是截止到今天这种方法是不行的。因为好多插件已有更新的最低版本，就算安装了2.263.4这种低版本的jenkins，好多插件也不能安装。（首次安装jenkins选择安装默认推荐的插件选项时，在安装插件过程中很多插件安装失败显示红叉叉。）

安装过程.png

• 所以正确方法应该是不用这个插件，直接使用项目的git地址加gitlab用户名和密码加脚本配置jenkins，即可成功构建项目，项目配置如图（我司使用gitlab管理代码，其他方式按需填写）。

配置.png

填写gitlab用户名和密码.png

四、立即构建报错：分支设置错误

ERROR: Couldn't find any revision to build. Verify the repository and branch configuration for this job.
Finished: FAILURE

• 这是因为分支信息设置错误，需要修改项目的分支信息
• 项目名-配置-源码管理-Branches to build-Add Branch-指定分支填： ** ，即默认所有分支

修改项目分支红框部分.png

五、fastlane: command not found

+ sh ./fastlane/Fastlane.sh
./fastlane/Fastlane.sh: line 3: fastlane: command not found

WeChatbcf427af605ef01bf9392f9b4405c10c.png

• 使用脚本构建项目报错，但用此脚本在终端执行正常。

解决方法

• 在我们保证我们安装的fastlane没有问题的基础上要是出现这种问题（即终端可正确执行fastlane lane任务名 > ），那就一般是由于 jenkins 没有设置正确的 $PATH 环境变量导致的。正确设置的方法为：

  1、在命令行下执行 echo $PATH，记录下输出的结果
  2、在 jenkins 中 系统管理 - 系统配置(Configure System) - 向下拉找到全局属性 - 勾选环境变量 - 添加键值对列表
  3、在 key 中填写 PATH，在 value 中填写第一步中输出的结果
  4、保存即可。

  
  
  键值对列表-新建.png

六、 fastlane requires your locale to be set to UTF-8

[!] Error building the application - see the log above�[0m
[15:27:37]: �[31mWARNING: fastlane requires your locale to be set to UTF-8\. To learn more go to [https://docs.fastlane.tools/getting-started/ios/setup/#set-up-environment-variables�[0m](https://docs.fastlane.tools/getting-started/ios/setup/#set-up-environment-variables�[0m)
Build step 'Execute shell' marked build as failure
Finished: FAILURE

解决方法

• 同 五、在 jenkins 中 系统管理 - 系统配置(Configure System) - 向下拉找到全局属性 - 勾选环境变量 - 添加键值对列表，添加以下配置：

  LANG en_US.UTF-8
  LC_ALL en_US.UTF-8

键值对.png

没有，完结说明全部成功

jenkins+fastlane成功.png

七、全局安全配置时 User not found:xxx

添加用户失败.png

解决方法

• 在确保用户名真实存在的情况下，刷新页面即可

管理员默认勾选第一个勾，表示全部权限.png

八、使用scp方式上传给服务器已经打好的包文件，报错OpenSSH keys

/Library/Ruby/Gems/2.6.0/gems/net-ssh-6.1.0/lib/net/ssh/authentication/ed25519_loader.rb:21:in `raiseUnlessLoaded': OpenSSH keys only supported if ED25519 is available (NotImplementedError)
net-ssh requires the following gems for ed25519 support:
 * ed25519 (>= 1.2, < 2.0)
 * bcrypt_pbkdf (>= 1.0, < 2.0)
See https://github.com/net-ssh/net-ssh/issues/565 for more information
Gem::MissingSpecError : "Could not find 'ed25519' (~> 1.2) among 203 total gem(s)

解决方法

• 执行fastlane lane上传到服务器前先执行以下代码，注意当前目录定位在项目路径下。
• 或在fastlane.sh脚本文件执行 fastlane lane名前加以下代码也可。

ssh-add

九、gem install 权限错误

You don't have write permissions for the /Library/Ruby/Gems/2.6.0 directory.

• 终端执行

~ % export GEM_HOME="$HOME/.gem"

• 或配置 cmd+shift+G ~/.bash_profile，加入如下内容

# gem install 权限
export GEM_HOME="$HOME/.gem"

• 若终端fastlane lane任务 执行成功，但jenkins配置的fastlane失败，需要在fastlane.sh脚本文件中加入此语句，或者在jenkins系统配置中shell脚本配置里加上此语句

参考文章

Jenkins 100次构建失败踩坑全录（一）
记我Jenkins创建任务时错误
iOS自动化打包 Jenkins+Gitlab+Fastlane+蒲公英+钉钉