傻瓜式-iOS自动化分发部署-持续化集成方案【Fastlane+蒲公英+Jenkins】

3,933 阅读15分钟

使用初衷

公司产品版本比较多,很多版本都需要独立化部署。导致产生了每个地址需要打包,每次打包就是一件麻烦的事情,常常一下午的时间过去了却都浪费在打包这件事情上了。So....研究了下Fastlane+Jenkins+蒲公英。可以方便的发布和管理版本。看到爬了很多坑。写出来让大家参考下,遇到问题了可以私信我。尽我所能帮助你。

基础名词

  • Ruby,一种简单快捷的面向对象(面向对象程序设计)脚本语言
  • RVM是一个命令行工具,它允许您轻松地安装,管理和使用从解释器到多组gems多个ruby环境。
  • Gems RubyGems简称gems,是一个用于对 Ruby组件进行打包的 Ruby 打包系统。例如经常用的cocoapods就需要 gem 来管理。
  • Fastlane是Felix Krause大神写的fastlane是一套使用Ruby写的自动化工具集,用于iOS和Android的自动化打包、发布等工作。
  • pgyer/fir 第三方发布测试平台。

爬坑攻略

如果你在安装期间想很顺利的话,请务必按照步骤去做,本教程只针对Mac。

此文档是二次更新的,因为第一次写的时候,就根据安装记录写出来了,第二次在别的机器上部署的时候,就出现了各种问题,就感觉这是写了个P啊。。。。P P P -_-~!

所以这次就进行了二次加工,虽然变成了二手的,但是更有内涵哦~~~

Ruby处理

使用Mac的小伙伴都应该能感受的OSX的好处,本人对Mac中毒很深,要是让我说一点什么不好的话,就是价格太高。

各种环境,系统都自带了,ruby,python等等,且不会出现全家桶的问候。

回归正体接着说ruby,Mac系统自带ruby,但是是给系统自己使用,权限很小,所以在平时使用过程中,会出现很多问题,而且版本一般都比较低,所以大多人都在自己使用RVM来管理自己使用的ruby.

参照此文档来安装 RVM使用ruby 使用RVM来管理ruby

ruby安装完成之后,来进行下一步。

Fastlane 安装初始化

image

  • 确保你已经安装了最新版本的Xcode命令行工具:
xcode-select --install
  • 官方文档支持三种方式安装,我使用的是ruby,刚才不是使用RVM来管理自己的ruby 么,接下来我们来安装fastlane
方法os支持描述
Homebrew苹果系统brew cask install fastlane
安装程序脚本苹果系统下载zip文件。然后双击install脚本(或在终端窗口中运行)。
RubyGems带有Ruby版本> 2.0.0gem install fastlane -NV

如果使用的是系统自带的ruby,可能会报错没有权限。

ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.

ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /usr/bin directory.

查看自己是否使用的是自己管理的ruby

 which ruby
> 返回/Users/seven/.rvm/rubies/ruby-2.4.1/bin/ruby
> 则说明已经使用RVM管理的Ruby了非系统自带的。
> 如果是usr/bin这个目录下的则说明还在使用系统自带的,可能会出现一系列权限的问题,请更换。

如果你非要使用系统自带的,也可以,也可能出现问题,也可能没事,跟系统版本也有关系,

下面给出系统自带问题的一些些方法。如跟我一样使用非系统自带ruby,请跳过此步骤。

> 方法一:sudo gem install fastlane -NV //提升权限,部分系统权限还是不够。
> 方法二:安装到别的目录使用指定目录安装: sudo gem install -n /usr/local/bin fastlane
> 方法三:还是使用RVM管理ruby
  • 初始化

安装完毕后,在终端进入到你的项目目录下。初始化fastlane

fastlane init

如果没有报错,就跳过此条继续 报错Exit status of command 'bundle exec pod install' was 1 instead of 0. bundler: failed to load command: pod (/usr/local/bin/pod) 解决方法:在项目根目录下 fastlane/Fastfile 修改文件中的cocoapods ' cocoapods(use_bundle_exec: false)'

按照提示输入开发者账号(付费账号) 输入Bundle Identifier 用于初始化配置,后期可在配置文件改。随便输入 根据提供的信息,fastlane会自动为您生成一个配置。

您可以看到新创建的./fastlane目录,包含Appfile和Fastfile文件。

最有趣的文件是fastlane/Fastfile,其中包含分发您的应用程序所需的所有信息。

这样就完成了初始化

蒲公英插件安装

初始化完毕后直接在终端输入

//fastlane fastlane search_plugins//列出可用插件
fastlane add_plugin pgyer//安装插件

image.png

插件安装成功
./fastlane目录下会生成Pluginfile的一个文件。
插件安装不成功,就是fastlane安装的有问题。

配置Fastlane


文件名描述
Appfile从 Apple Developer Portal 获取和项目相关的信息 详情
Fastfile核心文件,存放lane任务
Deliverfiledeliver的配置文件,从 iTunes Connect 获取和项目相关的信息详细
metadata同步iTC中的元数据
screenshots同步iTC中的截图

fastlane工具集是配置fastlane最重要的

文件名描述
match证书和配置文件管理工具会重置证书,推荐新项目使用。🌟🌟🌟🌟🌟
cert自动创建管理iOS代码签名证书,会去自动创建证书,永远不会撤销现有的证书。如不能创建会报错。
sigh用来创建、更新、下载、修复Provisioning Profile的工具
gym自动化编译打包工具.shenzhen的代替品.🌟🌟🌟🌟🌟
pem自动生成、更新推送配置文件
produce如果你的产品还没在iTunes Connect(iTC)或者Apple Developer Center(ADC)建立,produce可以自动帮你完成这些工作
deliver自动上传截图,APP的元数据,二进制(ipa)文件到iTunes Connect
snapshot自动截图(基于Xcode7的UI test)
frameit可以把截的图片自动套上一层外边框
pilot管理TestFlight的测试用户,上传二进制文件
boarding建立一个添加测试用户界面,发给测试者,可自行添加邮件地址,并同步到iTunes Connect(iTC)
scan自动运行测试工具,并且可以生成漂亮的HTML报告
spaceship为pilot,boarding和deliver等工具提供和 iTC 和 ADC 的交互API。spaceship本来是个独立的项目,后来被Fastlane收编进来
WatchBuild是一个独立的iTC监控工具,开启WatchBuild可以监控iTC上的文件状态,弹出MacOS自带的Notification
supplyAndroid自动上传到Google Play工具(如果有时间,我想把国内提供API的Android Store都写个插件自动上传,这个问题从10年我刚开始工作就觉得是个痛点)
screengrabAndroid的自动截图工具

关于fastfile:

  • 里面存放了很多lane,每个lane相当于按顺序执行的工作流。每个lane可以存放多个action,action可以看做具体的执行动作
  • 生命周期
执行顺序方法名说明
1before_all在执行 lane 之前只执行一次
2before_each每次执行 lane 之前都会执行一次
3lane自定义的任务
4after_each每次执行 lane 之后都会执行一次
5after_all在执行 lane 成功结束之后执行一次
6error在执行上述情况任意环境报错都会中止并执行一次
  • 任务定义
定义是否必须说明备注
descfalse方法描述可多次使用打到换行的目的
nametrue方法名符号化的方法名
optionsfalse方法参数返回 Hash 类型
tasktrue方法主体参考 ruby 的方法代码且支持 ruby 代码
  • 一个简单的lane
lane :deploy do
  # 执行 pod instasll
  cocoapods
  # 执行 carthage bootstrap
  carthage
  # 增加build版本号
  increment_build_number
  # 编译代码
  gym
  # 发布到Apple Store
  deliver(force: true)
end
  • fastlane示例
  • 这个是我自己 配置到蒲公英的。同时导出ipa到./build文件夹下,以版本号和打包时间命名。这样就保留了每一版本包了。

只需要项目根目录下执行即可

fastlane topgyer desc:更新内容
desc "上传到测试版本到蒲公英"
  desc "生成本地版本"
  lane :topgyer do|option|
    
    #自动增加build
    # increment_build_number

    #自动生成证书
    cert

    #自动生成配置文件
    # sigh(force: true)//我使用的是手动配置关闭这个。如需自动则打开即可

    #gym配置,打包输出。

    #fastlane gym --export_method ad-hoc
    #fastlane gym --export_method enterprise
    #fastlane gym --export_method app-store
    scheme_name = "xxxx"//应用名词

    #获取version和build版本号
    version = get_info_plist_value(path: "./#{scheme_name}/Info.plist", key: "CFBundleShortVersionString")
    build = get_info_plist_value(path: "./#{scheme_name}/Info.plist", key: "CFBundleVersion")
    
    #导出路径
    output_directory = "./build"
    
    #导出名称
    output_name = "#{scheme_name}_#{version}_#{build}_#{option[:desc]}_#{Time.now.strftime('%Y%m%d%H%M%S')}.ipa"

    gym(
      export_method: "enterprise",//企业账号
      scheme: scheme_name, //名词
      clean: true,//是否清理上次编译
      output_directory: output_directory,//导出路径
      output_name: output_name//导出名词
     )

    pgyer(api_key: "1212121", user_key: "121212", update_description: "#{option[:desc]}")//蒲公英设置查看key

  end
  • 手动配置证书。 fastlane初始化Gym

    fastlane gym init

    会生成一个Gymfile的文件。增加下面代码,同时不要使用自动生成配置文件这个选项sigh(force: true)

export_options(
	 provisioningProfiles: { 
	"com.xxx.xxx" => "profilesName",#包名 证书配置文件名称
	"com.xxx.xxxxxx" => "profilesName1"
  })
  • scheme 设置 没有在gym或者fastfile写应用的名字的话。打包的时候会自动检测当前目录下的文件。列出来供你选择。
    也可以设置一下在gym中直接赋值,或者fastfile中增加即可。
  • 关闭 Enable Bitcode.如果开启会报错。
  • 设置完成即可测试打包上传到蒲公英fastlane topgyer desc:更新内容

Fastlane问题汇总

使用过程中出现了很多问题,大部分问题都已经有人躺过水了,所以有问题先去看看issues

gym编译报错解决不了请先检查三遍证书是否有问题

初始化报错请检查安装路径是否有问题。

问题 | 解决方案

---|--- ruby -v 版本低于2.0.0 | gem版本不对 请升级ruby请更新gems cocoapods没有放到Gemfile中| Gemfile文件中增加cocoapods fastlane init 提示sudo|请检查ruby路径。如果没问题请检查user目录下.bash_profile。环境变量设置是否有效。export PATH="HOME/.fastlane/bin:HOME/.fastlane/bin:PATH" 如果初始化成功|其他的问题大部分都是证书问题了。 The generated archive is invalid, this can have various reasons:Usually it's caused by the Skip Install option in Xcode, set it to NO |xcode中修改build settings Skip Install 选项为NO

Jenkins持续集成


在持续集成(Continuous integration,简称CI)这块,Jenkins无疑是目前使用的比较多的一个开源框架 jekins.png

JDK

系统要求:必须安装JDK 1.5以上版本,推荐安装最新版本的JDK[注意不支持java9]。可以通过以下命令查看是否安装JDK和JDK版本。JDK下载链接 如需卸载请看下文

java -version

1.png JDK

  • java卸载方法 以Mac为例子 [shift +cmd+g] 前往文件夹

1 删除所选版本

  • 在系统偏好设置面板移除Java

Snip20180126_14.png

  • JDK安装

下载完毕JDK后如图按照提示安装即可

Snip20180126_15.png java

安装 Jenkins

Jenkins的官网 下载最新的 war 包。

推荐使用【Long-term Support (LTS)稳定版】

war 包

下载完成后,打开终端,进入到 war 包所在目录直接运行,也可以将war包丢在Tomcat的webapp目录下面。

终端方式执行以下命令:

java -jar jenkins.war//默认对端口是8080如需指定可更改
java -jar jenkins.war --httpPort=8888 //指定8888端口二者选一即可

初始化Jenkins

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

http://localhost:8888//端口指定的多少写多少
注意不要关闭终端

第一次运行会出现如下界面,提示需要填写指定路径文件里面的内容(该内容也可以在终端上面看到)。

jenkins.png

根据提示目录打开initialAdminPassword文件,复制出密码,填写,Continue.

Jenkins用户/secrets/目录是没有读写权限的。修改权限。

安装推荐的插件  等待进度条完成···  创建管理员用户 next 设置完成

这样Jenkins初始化完毕了,可以快乐的使用了。还是介绍下如何使用吧。

Jenkins使用

  • 启动方式

上文说了,如何初始化进入Jenkins,那么如果我关了再次怎么进入呢。别急hold~~~ 两种方式都可以

  • 方式一 跟初始化一样,进入war包所在目录通过命令启动,
java -jar jenkins.war
  • 方式二 运行命令来创建配置文件
sudo touch /Library/LaunchDaemons/org.jenkins-ci.plist

如果您使用了不同的用户名,请务必在plist中使用它。需要指定用户名,否则会以系统根用户的身份运行,这会让您在使用Jenkins时遇到麻烦

plist内容如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>Jenkins</string>
    <key>KeepAlive</key>
    <true/>
    <key>ProgramArguments</key>
    <array>
      <string>/usr/bin/java</string>
      <string>-Dmail.smtp.starttls.enable=true</string>
      <string>-jar</string>
      <string>/usr/local/opt/jenkins/libexec/jenkins.war</string>
      <string>--httpListenAddress=127.0.0.1</string>
      <string>--httpPort=8080</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>UserName</key>
    <string>jenkins</string>
  </dict>
</plist>

现在可以重新启动或者运行下方命令来查看运行在http://localhost:8888的Jenkins

sudo launchctl load -w /Library/LaunchDaemons/org.jenkins-ci.plist

Jenkins配置

系统管理

插件管理

使用默认方式安装的基本插件都包含了,如果有需要可以自己来管理插件

image.png

安全配置

在工作中可能要在Jenkins中创建用户,这样你的团队的其他成员就可以访问自己的工作。首先打开左侧菜单中的“管理Jenkins”页面,然后转到“配置全局安全性”。

启用安全性,如果不那么将允许任何登录用户做任何事情。

  • 进入系统管理 -> Configure Global Security -> 点击”启用安全” 。启用安全下面选择,“Jenkins专有用户数据库”,勾选允许用户可以注册。然后在“授权策略”中选择“任何用户可以做任何事(没有任何限制)”。当然,也可以使用LDAP身份认证机制,直接使用外部统一的身份机制来做认证。
  • 返回注册一个账户,登录之后再次进入安全管理。勾选“登录用户可以做任何事”,这样就只有登录用户才能做操作了。

image.png

创建项目

  • “新建” —> 勾选“构建一个自由风格的软件项目”
    Snip20180801_112.png
  • General image.png
  • 源码管理--Git image.png
  • 设置源码的仓库,以便让 Jenkins 知道我们的 iOS 项目的代码在哪里。因为我的代码放在自己的仓库中(如果你用 Github 等其他仓库也是类似),所以要先告诉 Jenkins 如何获取代码。RepositoryUrl就是git地址

首先,我们需要配置 SSH,我们可以在 Jenkins 的证书管理中添加 SSH。在 Jenkins 管理页面,选择“Credentials”,然后选择“Global credentials (unrestricted)”,点击“Add Credentials”,如下图所示,我们填写自己的 SSH 信息,然后点击“Save”,这样就把 SSH 添加到 Jenkins 的全局域中去了。 Snip20180801_118.png

  • 类型SSH
  • userName 就是git中的名字 能知道是谁上传下载的就可以
  • PrivateKey ssh中的私钥,/Users/用户名/.ssh/id_rsa
  • Passphrase git密码。
  • 关于如何获取SSH大家可以看文尾,熟悉的人应该都会,不在此介绍
  • 回到刚刚新建的任务中,在源码管理中,选择 Git,按下图填好相关信息。注意:Credentials 不需要选择。
  • 同时也试了使用账号密码的Credentials。选择你账号密码创建的Credentials也可以。默认使用上边方法即可。

image.png

自动测试忽略,不需要设置触发器。

构建环境设置

  • 直接用 fastlane 这个工具,所以这里不需要特别设置。

构建设置

  • 选择使用shell进行构建 更新内容自己维护
cd /users/xxx/xxx   //你项目根目录
fastlane topgyer desc:更新内容!

构建后增加步骤

  • 可以邮件通知人员,逗号隔开,通知构建失败

来个整体截图

12.png

开始构建

  • 返回面板会发现自己刚才新建的任务

image.png

  • 点击任务名称进入详情、可以修改任务配置项和构建版本

image.png

  • 点击构建
  • 休息一会
  • 登陆蒲公英就会发现多了一个版本。

构建日志查看

  • 构建失败或者想看到输出的,可以在任务详情,构建历史中,选择构建中的版本。

image.png

  • 选择Console Output即可看到控制台输出

image.png

  • 截取下最后输出success送给你

image.png

节点管理可以参考以下,暂时不介绍

blog.csdn.net/birthmarkqi… www.jianshu.com/p/047362b11…

附加 SSH

SSH keys

SSH key 可以让你在你的电脑和Code服务器之间建立安全的加密连接。 先执行以下语句来判断是否已经存在本地公钥:

cat ~/.ssh/id_rsa.pub

如果你看到一长串以 ssh-rsassh-dsa开头的字符串, 你可以跳过 ssh-keygen的步骤。

提示: 最好的情况是一个密码对应一个ssh key,但是那不是必须的。你完全可以跳过创建密码这个步骤。请记住设置的密码并不能被修改或获取。

你可以按如下命令来生成ssh key:

ssh-keygen -t rsa -C "你的邮箱@xx.com"

这个指令会要求你提供一个位置和文件名去存放键值对和密码,你可以点击Enter键去使用默认值。

用以下命令获取你生成的公钥:

cat ~/.ssh/id_rsa.pub

复制这个公钥放到你的个人设置中的SSH/My SSH Keys下,请完整拷贝从ssh-开始直到你的用户名和主机名为止的内容。

如果打算拷贝你的公钥到你的粘贴板下,请参考你的操作系统使用以下的命令:

Windows:

clip < ~/.ssh/id_rsa.pub

Mac:

pbcopy < ~/.ssh/id_rsa.pub

GNU/Linux (requires xclip):

xclip -sel clip < ~/.ssh/id_rsa.pub

《一两浊酒》是我的个人公众号,我会分享一些自己的感悟,技术,理财和学习方法。 如果您喜欢我的文章,可以关注公众号,获取最新内容,及专辑。

扫码_搜索联合传播样式-标准色版