Fastlane一键自动化打包发布 iOS 项目

Fastlane一键自动化打包发布 iOS 项目

###一、Fastlane简介

Fastlane 是一个完全开源的项目,是一款为 iOS 和 Android 开发者提供的自动化构建工具,它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来,实现完全自动化的工作流。

GitHub 地址

###二、Fastlane 安装

// 查看 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

##三、初始化 Fastlane 配置

  • 安装蒲公英的 Fastlane 插件,终端输入以下命令安装 蒲公英 插件
fastlane add_plugin pgyer
  • 初始化配置,终端cd 到你项目工程的根目录(xcodeproj 的同级目录),输入以下命令
fastlane init

初始化过程中会让你输入苹果开发者账号的账号和密码,这个信息会存储在钥匙串中,后续使用无需再输入密码。

初始化过程中还会检测当前项目的 App Identifier 是否已经在 Apple Developer 中,还会检测当前 App 是否已经在 iTunes Connect 中,如果都满足的话,过程应该是比较顺利的。

初始化完成之后会在你项目工程的目录下生成一个 fastlane 文件夹,里面是 Fastlane 的一些配置文件。其中 Appfile 里面存放了 App 的基本信息包括 App_Identifier 、AppID 、Team_ID 等。Fastfile 是最重要的一个文件,在这个文件里面可以编写和定制我们打包脚本的一个文件,所有自定义的功能都写在这里

使用编辑器打开 Fastlane 文件,将所有内容删除替换为以下内容。

fastlane_version "2.101.1"

default_platform :ios

platform :ios do

  desc "以 development 方式打包并上传到蒲公英"
  lane :test_beta do

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

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

  end

  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 标注出来了,按照说明更改即可,更改完成后保存文件。

###四、使用Fastlane一键打包

  • 打开终端,cd 到你项目工程的根目录(xcodeproj 的同级目录)。 输入以下命令,即可开始自动打包并上传到测试包到蒲公英 。
fastlane test_beta
  • 输入以下命令,即可开始自动打包并上传到 iTunes Connect 。
fastlane release

打包的 .ipa 包和 dSYM 文件,以及生成的 Provisioning Profiles 都在工程目录下的 archive 文件夹内,看上面的输出地址就知道了。

最后出现一个 successfully 🎉 就表示成功了,有错误终端也会有提示,按照提示继续修改配置就行了。

参考

Fastlane官方教程

Fastlane带来的全自动化发布