前言简介

fastlane是一款使用ruby实现的跨平台的持续集成工具，支持安卓和iOS平台项目的持续集成实践，fastalne处理提供包含：初始设置、屏幕截图、打包、上传到测试平台、部署等功能。本篇主要介绍fastlane的集成，以及配合jenkins自动化的搭建

iOS fastlane安装及使用：

（一）安装升级bundle

1. fastalne需要在ruby环境下才能安装,并且系统ruby版本需要高于2.6.2。如果bundle版本过低，需要先升级bundle

2. 安装升级bundle 执行命令行

    sudo gem install bundler -n/usr/local/bin

3. cd到项目根目录输入bundle init 生成Gemfile文件，在此文件写入

   source "[https://gems.ruby-china.com](https://gems.ruby-china.com/)"
   gem "fastlane"

4. 安装依赖库， 执行命令行

    bundle install

5. 更新Gemfile.lock文件的版本和依赖 执行命令行

    bundle update

（二）Fastlane安装、初始化项目

1. 使用HomeBrew安装(管理各种包)  执行命令行 brew install fastlane进行安装。可以用命令fastlane --version来查看是否安装成功

   

2. 安装成功以后cd到工程目录下初始化 执行命令行fastlane init出现下图选择你所需要的功能模块⬇️

   
   

• 1、自动化截图   

• 2、自动化beta分发至TestFlight   

• 3、自动化App Store 分发   

• 4、手动写自动化脚本（自定义发布平台如pgyer，firm等）。

3. 本篇介绍的是iOS上传到TestFLight，所以直接选择2

   

4. 输入苹果账号,等待一会儿，然后一直回车就可以了

   

5. 构建完成会自动生成如下文件：⬇️

   

（三）使用fastlane自动化构建

1. 初始化完成后，在Appfile文件内设置对应的开发者账号以及bundle id。fastFile中添加绕开二次验证的脚本。注：（如果选择是2自动化beta分发至testFlight则不需要手动填写）

   

• 注:keyid和issuer_id还有.p8文件是通过登陆苹果开发者中心-用户与访问-密钥，需账户持有者去创建并生成，生成一次可以所有项目通用

  

2. 终端输入命令行fastlane beta，等待上传成功即可

（四）项目配置

1. 电脑如已经安装fastalne，直接cd到项目跟目录下，运行fastalne init，即可生成对应文件，直接复制公用脚本文件，修改SCHEME名称，拷贝.p8文件到fastlane文件夹下即可

   
   

   

iOS jenkins配合fastlane自动化出包：

1. 在jenkins中创建单独的任务，用来专门上传到testFlight分发，将脚本写到jenkins本地。将项目名称、git地址、代码分支，开发环境写成变量在脚本中去适配不同的项目，配置好了以后如下⬇️

   

2. 项目需要分发时直接切换项目名称，和对应的选项，即可直接构建，等待上传成功即可

   
   

   

问题总结：

1. Check out the few lines of raw xcodebuild output above for potential hints

• 描述文件配置问题，项目内的描述文件需要配置正确，均使用distribution描述文件

2. jenkins构建时候报错

   13:57:17: Transporter transfer failed.

   13:57:17: Please sign in with an app-specific password. You can create one at appleid.apple.com. (-22910)

   13:57:17: Your account has 2 step verification enabled

   13:57:17: Please go to appleid.apple.com/account/man…

   13:57:17: and generate an application specific password for

   13:57:17: the iTunes Transporter, which is used to upload builds

   13:57:17: To set the application specific password on a CI machine using

   13:57:17: an environment variable, you can set the

   13:57:17: FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD variable

• 是因为苹果的双重身份验证导致的问题，需要在苹果开发者中心，用户中心，获取到对应的密钥key_id、issuer_id、还有.p8文件，注：（p8文件需要保存到本地进行备份）放到对应的位置上，获取方式如上。获取完成的.p8文件放在fastlane脚本文件同目录下，然后在Fastfile文件中添加脚本

Fastlane相关脚本：

# You can find the documentation at https://docs.fastlane.tools
#
# For a list of all available actions, check out
#
#     https://docs.fastlane.tools/actions
#
# For a list of all available plugins, check out
#
#     https://docs.fastlane.tools/plugins/available-plugins
# Uncomment the line if you want fastlane to automatically update itself
# update_fastlane

SCHEME = "项目名称"
Method = "app-store"
default_platform(:ios)

def updateBuild
  currentTime = Time.new.strftime("%Y%m%d%H%M%S")
  increment_build_number(
    build_number: "#{currentTime}"
  )
end

api_key = app_store_connect_api_key(
  key_id: "xxx",
  issuer_id: "xxx",
  key_filepath: "./fastlane/xxx.p8",
  duration: 1200,
  in_house: false
)

platform :ios do
  desc "Description of what the lane does"
  lane :beta do
    updateBuild
    gym(
      scheme: SCHEME,
      workspace: "#{SCHEME}.xcworkspace",
      output_directory: "./fastlane/release",
      output_name: "#{SCHEME}.ipa",
      export_method: Method,
      export_xcargs: "-allowProvisioningUpdates",
      silent: true,
      clean: true
    )
    upload_to_testflight(
      api_key: api_key,
      ipa: "./fastlane/release/#{SCHEME}.ipa",
      skip_waiting_for_build_processing: true,
      skip_submission: true
    )
  end
end