【iOS 开发】使用 Fastlane 自动化打包并发布 iOS 项目

Fastlane 是一个完全开源的项目，是一款为 iOS 和 Android 开发者提供的自动化构建工具，它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来，实现完全自动化的工作流，如果使用得当，可以显著的提高开发者的开发效率，这是 GitHub 地址和官方文档。

本文最终目的：

终端输入 fastlane beta 自动打包 ad-hoc 版本的 ipa 包并自动上传到 蒲公英 。
终端输入 fastlane release 自动打包 app-store 版本的 ipa 包并自动上传到 iTunes Connect 。

1. 安装 Fastlane

检查 Ruby 版本，需要 2.0 及以上版本，并且需要将 gem 的 source 改为 https://gems.ruby-china.org/ ，在终端输入以下命令。

// 查看 Ruby 版本
ruby -v

// 查看 gem 的source
gem sources

检查 Xcode 命令行工具是否安装，在终端输入以下命令，如果安装过会有提示，如果没装过就会自动开始安装。

xcode-select --install

开始安装 Fastlane ，在终端输入以下命令。

sudo gem install fastlane --verbose

如果安装时出现错误无法安装，就使用以下命令安装。

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

安装完成后可以输入以下命令查看版本来验证是否安装成功。

fastlane --version

2. 安装蒲公英的 Fastlane 插件

fastlane 安装完成以后，在终端输入以下命令安装 蒲公英 插件。

fastlane add_plugin pgyer

最后出现 Successfully installed plugins 表示安装完成。

安装完成以后，会在系统根目录生成 Gemfile 和 Gemfile.lock 这两个文件，这两个文件不要删掉，不然插件就得重装了。

3. 修改项目配置

用 Xcode 打开你的项目，然后打开 Manage Schemes... 。

然后将工程的 Scheme 后面的 Shared 给勾上。

需要将这个改动上传到 git 仓库，不要忽略掉这个文件，提交的文件路径信息如下，如果你改完没有提示有需要改动的提交，那就看一下 .gitignore 里面是不是忽略掉了。

做这个改动的原因是，后面可能会用到 Jenkins + Fastlane 做持续集成，如果没有这个文件，Jenkins 使用 fastlane 编译项目时会提示 No schemes found in Xcode project or workspace ，所以最好先加上。

4. 初始化 Fastlane 配置

打开终端，cd 到你项目工程的根目录（xcodeproj 的同级目录），输入以下命令：

fastlane init

初始化过程中会让你输入苹果开发者账号的账号和密码，这个信息会存储在钥匙串中，后续使用无需再输入密码。
初始化过程中还会检测当前项目的 App Identifier 是否已经在 Apple Developer 中，还会检测当前 App 是否已经在 iTunes Connect 中，如果都满足的话，过程应该是比较顺利的。
初始化完成之后会在你项目工程的目录下生成一个 fastlane 文件夹，里面是 Fastlane 的一些配置文件。其中 Appfile 里面存放了 App 的基本信息包括 App_Identifier 、AppID 、Team_ID 等。Fastfile 是最重要的一个文件，在这个文件里面可以编写和定制我们打包脚本的一个文件，所有自定义的功能都写在这里。

5. 编辑 Fastlane 脚本文件

首先找到工程目录下 fastlane 文件夹下的 Fastlane 文件，如果想要了解其中内容的含义可以自己去官方文档查一下，这里就不解释了。
使用编辑器打开 Fastlane 文件，将所有内容删除替换为以下内容。

fastlane_version "xxx"

default_platform :ios

platform :ios do

  desc "以 ad-hoc 方式打包并上传到蒲公英"
  lane :beta do

    puts "自动生成 Provisioning Profiles 文件"
    sigh(
      # 指定输出的文件夹地址
      output_path: "./archive/sign",
      # 是否为 AdHoc 证书（设为 false 或不写默认为 AppStore 证书）
      adhoc: true
    )

    puts "以 ad-hoc 方式打包"
    gym(
      # 指定打包所使用的输出方式 (可选: app-store, package, ad-hoc, enterprise, development)
      export_method: "ad-hoc",
      # 指定项目的 scheme 名称
      scheme: "xxx",
      # 指定输出的文件夹地址
      output_directory: "./archive/beta/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
      # 指定打包方式 (可选: Release, Debug)
      configuration: "Release"
    )

    puts "上传 ipa 包到蒲公英"
    pgyer(
      # 蒲公英 API KEY
      api_key: "xxx",
      # 蒲公英 USER KEY
      user_key: "xxx"
    )

  end

  desc "以 app-store 方式打包并上传到 iTunes Connect"
  lane :release do

    puts "自动生成 Provisioning Profiles 文件"
    sigh(
      # 指定输出的文件夹地址
      output_path: "./archive/sign"
    )

    puts "以 app-store 方式打包"
    gym(
      # 指定打包所使用的输出方式 (可选: app-store, package, ad-hoc, enterprise, development)
      export_method: "app-store",
      # 指定项目的 scheme 名称
      scheme: "xxx",
      # 指定输出的文件夹地址
      output_directory: "./archive/release/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
      # 指定打包方式 (可选: Release, Debug)
      configuration: "Release"
    )

    puts "上传 ipa 包到 iTunes Connect"
    deliver(
      # 跳过截图上传
      skip_screenshots: true,
      # 跳过元数据上传
      skip_metadata: true,
      # 跳过审核直接上传
      force: true
    )

  end

end

需要更改的地方我已经用 xxx 标注出来了，按照说明更改即可，更改完成后保存文件。

6. 开始自动打包并发布

打开终端，cd 到你项目工程的根目录（xcodeproj 的同级目录）。
输入以下命令，即可开始自动打包并上传到 蒲公英 。

fastlane beta

输入以下命令，即可开始自动打包并上传到 iTunes Connect 。

fastlane release

打包的 .ipa 包和 dSYM 文件，以及生成的 Provisioning Profiles 都在工程目录下的 archive 文件夹内，看上面的输出地址就知道了。
最后出现一个 successfully 🎉 就表示成功了，有错误终端也会有提示，按照提示继续修改配置就行了。

Fastlane 还能实现很多自动化的功能，感兴趣的自己去了解一下吧，这里有篇文章写的很全面可以看一下：小团队的自动化发布－Fastlane带来的全自动化发布。