macOS Jenkins Fastlane

前段时间被手动打包烦住了，就用另外一台Air搭建了自动打包上传环境，记录如下：

---

首先编译环境是需要的，这里是iOS应用，只需安装Xcode和命令行工具xcode-select --install。

---

安装Fastlane自动化工具集sudo gem install fastlane。完成后进入项目所在目录配置Fastlane

cd ... #项目所在路径
fastlane init 

在国内会出现停留在bundle update画面,如下

这是由于Ruby源被墙的问题。直接结束命令进入项目目录，会多出一个文件夹fastlane和文件Gemfile。编辑Gemfile修改source为http://gems.ruby-china.com。由于只用于测试打包，不进行Appfile文件处理，只编辑任务文件Fastfile:

default_platform(:ios)

platform :ios do
  desc "iOS Test Enviroment Archieve"
  lane :ci do|options|
    puts "Start ..."
    branch = options[:branch]
    ipa_name = options[:name]

    #确认分支、git状态、拉取最新代码, 由于Git环境原因注释了下面2行检查操作
#sh "git checkout #{branch}"
    ensure_git_branch(branch: branch)
#ensure_git_status_clean
    git_pull

    build_ios_app(
        configuration: "Debug",
        silent: true,
        export_method: "development",
        output_directory: "~/Desktop/Out",
        output_name: "#{ipa_name}"
    )

    sh "~/Desktop/Out/commit.sh ~/Desktop/Out "
    puts "Finish upload!"
  end
end

注意export_method方法如果不填写，默认构建为AppStore的包，需要配置苹果开发者信息。这里用于测试，填写为development。
脚本中lane :ci do|options| 注意这个opthions的位置，后面则可以使用branch = options[:branch]进行输入参数引用。
脚本中用到的commit.shshell脚本，用于上传打好的包到分发服务器。如下：

#!/bin/bash

if test -z $1
then
   echo "Not change path."
else
   cd $1
fi

rm -rf .git

git init
git add *
git commit -m "Z"
git remote add origin https://.../XXX.git
git push -u origin master --force

现在这样一个行为集「拉取master分支最新的代码，打包为ABC.ipa并上传到分发服务器」，只需要到项目目录执行如下命令:fastlane ios ci branch:master name:ABC

---

有了自动打包环境现在需要远程控制，安装Jenkins。有两种方式，一种是DMG包安装；一种是Jar包直接运行（此方式在当前用户的目录下创建文件，权限不会受到影响）。先讲Jar包运行方式后续阐述DMG方式。
注意Jenkins运行需要的Java环境，12的版本不支持，需要退到11以前。
在Jenkins下载jenkins.war包，运行java -jar jenkins.war命令后，服务就会开启。
打开浏览器进入http://localhost:8080/，第一次会要求输入密码Unlock Jenkins、安装需要的插件和创建管理者账号。注意包含解锁密码的文件所在路径在网页上有标识，直接复制里面内容输入就行，对于插件安装建议的就行，后面创建管理者账号也很简单。完成后进入主面板建立需要的任务，点击新建，输入任务名后选择构建一个自由风格的软件项目（由于需求只是进入项目目录后执行Fastlane命令），点击确定进入配置页面，只需在构建模块下点击增加构建步骤，选择执行 shell，输入命令：

cd ... #项目所在路径
fastlane ios ci branch:master name:ABC

点击保存,Jenkins任务就配置完成了(砍柴用了青龙刀...)。在其他电脑上用浏览器打开http://Jenkins安装电脑IP地址:8080/登录后，选择前面建立的任务，点击构建，等待打包上传完成。

---

下面只是一些闲谈，可以忽略。故事到此就结束了吗？下面才是写这个随笔的原因。DMG安装包安装Jenkins遇到的问题。在官网下载Jenkins安装包后，点击安装后，会在操作系统上创建名为Jenkins的用户，进入系统登录界面就能看见，正确的做法是用这个账号登录，进行前面Jar包相应的操作，一切都会正常。由于我们的项目文件已经在特定的用户目录下，所有会出现下面的一些问题。

• 在Jenkins的任务配置下添加的cd命令不能得以执行，首先想到是权限问题，我们就用管理员的命令运行sudo cd ...，得到错误信息sudo: no tty present and no askpass program specified，需要配置Jenkins运行sudo命令不需要密码，终端中执行命令sudo visudo，添加配置jenkins ALL=(ALL) NOPASSWD: ALL到文件末尾，保存，重启Jenkins服务。
• 能执行sudo cd操作后，但没有真实切换到指定的目录，通过echo $PWD不对， 尝试了软连接ln -s 也不行。再尝试把操作移动到脚本中去执行，Jenkins直接执行脚本bash xx.sh，脚本内容如下：

sudo cd ... #项目目录
echo $PWD
fastlane ios ci branch:master name:ABC

现在能成功切换，echo 也是正确的值。

• 完成上面的步骤，继续操作出现问题fastlane command not found，环境变量的问题，配置Jenkins的环境变量。在终端打印出环境变量进行复制echo $PATH，进入Jenkins控制面板，点击系统管理，点击系统设置，在全局属性模块，勾选环境变量，添加键「Path」和值「前面复制的」，点击页面底部的保存。现在执行Jenkins构建任务，fastlane命令也能成功找到。但fastlane执行中出现各种方法错误，放弃，切回到Jar的方式。

---

看下面的Refs比上面的好看多了^_^
Refs:
Jenkins Sudo 问题
Jenkins 环境变量配置