iOS持续集成：Fastlane 实现多 Target 自动化打包发布

1.前言

本篇文章主要讲解了 Fastlane 如何实现多 Target 自动化打包发布，以及如何配置 Appfile、Deliverfile 和 Fastfile 等配置文件，发布和构建版本号自增，修改更新内容，自动上传苹果商店和自动提交审核等内容，希望能够为您的工作或学习带来有价值的信息。

2.简介

Fastlane 是一套使用Ruby写的自动化工具集，用于iOS和Android的自动化打包、发布等工作，可以节省大量的时间。

3.安装

Fastlane安装及简单使用，请参考另一篇文章：iOS持续集成：Fastlane + 蒲公英 自动打包发布

4.配置

4.1 打开终端，进入你的工程目录，然后执行 fastlane init：

屏幕快照 2017-09-04 下午4.00.20.png

执行过程中，需要输入对应的苹果开发账号。接下来，出现确认提示，确认无误输入y：

屏幕快照 2017-09-05 下午5.40.02.png

4.2 Fastlane 初始化完成后，工程目录下会自动生成 fastlane 文件夹，如下所示：

屏幕快照 2017-09-04 下午4.32.11.png

• metadata： 目录：存放 App 元数据，包括 App 简介，Icon，Copyright 等；
• screenshots： 目录：顾名思义，存放 App store 中的截图；
• Appfile：用于指定 app_identifier, apple_id, team_id；
• Deliverfile：用于指定跟 App 版本发布相关的信息，除了 apple_identifier 外，还包括 submit_for_review, automatic_release 等可配置项，基本覆盖 iTunes Connect 里面的所有选项
• Fastfile：用于编写逻辑脚本，使用 ruby 语言，例如首先执行 cocoapods 更新第三方依赖库，然后执行 pem 更新相关证书，接着通过 gym 来编译并打包 ipa 文件，最后通过 deliver 发布到 iTunes Connect 中，并提交审核。

4.3 配置文件

因为 Fastlane 默认只有一个 target ，单个 target 配置可参考 iOS持续集成：Fastlane + 蒲公英 自动打包发布 中关于 .env 文件的配置。对于多个 target 可以通过配置多个 .env 文件。

具体操作如下：
打开终端，进入工程目录下，分别创建两个 .env 文件。下面是我的项目中创建的两个 .env 文件： .env.SunfoBank 和 .env.SunfoBankPlus ，截图如下：

屏幕快照 2017-09-05 下午4.23.44.png

文件内容如下：

.env.SunfoBank

#APP唯一标识符
APP_IDENTIFIER = "xxx.xxx"

#发布版本号
APP_VERSION_RELEASE = "3.4.0"

#新版本修改记录
RELEASE_NOTES = "1) 升级测试第一行\n2) 升级测试第二行"

#蒲公英 更新描述
PGY_UPDATE_DESCRIPTION = "fastlane自动打包上传测试"

#自动提交审核
SUBMIT_FOR_REVIEW = false

#审核通过后立刻发布
AUTOMATIC_RELEASE = false

#苹果开发者账号
APPLE_ID = "[email protected]"

#苹果开发者帐号密码
FASTLANE_PASSWORD = "xxxxxx"

#套装ID
TEAM_ID = "90xxxxxx02"

#应用名称
SCHEME_NAME = "SunfoBank"

#APP元数据及截图存放路径
METADATA_PATH = "./metadata/SunfoBank"
SCREENSHOTS_PATH = "./screenshots/SunfoBank"

#APP元数据及截图下载时，直接覆盖原有数据，不询问
DELIVER_FORCE_OVERWRITE = true

.env.SunfoBankPlus

#APP唯一标识符
APP_IDENTIFIER = "xxx.xxx.xxx"

#发布版本号
APP_VERSION_RELEASE = "3.4.0"

#新版本修改记录
RELEASE_NOTES = "1) 升级测试第一行\n2) 升级测试第二行"

#蒲公英 更新描述
PGY_UPDATE_DESCRIPTION = "fastlane自动打包上传测试"

#自动提交审核
SUBMIT_FOR_REVIEW = false

#审核通过后立刻发布
AUTOMATIC_RELEASE = false

#苹果开发者账号
APPLE_ID = "[email protected]"
#苹果开发者帐号密码
FASTLANE_PASSWORD = "xxxxxx"

#套装ID
TEAM_ID = "11xxxxxx06"

#应用名称
SCHEME_NAME = "SunfoBankCopy"

#APP元数据及截图存放路径
METADATA_PATH = "./metadata/SunfoBankCopy"
SCREENSHOTS_PATH = "./screenshots/SunfoBankCopy"

#APP元数据及截图下载时，直接覆盖原有数据，不询问
DELIVER_FORCE_OVERWRITE = true

截图如下：

屏幕快照_2017-09-05_下午3_42_22.png

同时，我的项目中的 Appfile、Deliverfile 和 Fastfile 配置文件修改如下：

Appfile

app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app

apple_id ENV['APPLE_ID'] # Your Apple email address

team_id ENV['TEAM_ID'] # Developer Portal Team ID

Deliverfile

app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app
username ENV['APPLE_ID'] # your Apple ID user

# 元数据的路径
metadata_path ENV['METADATA_PATH']
screenshots_path ENV['SCREENSHOTS_PATH']

 #App store 中待发布的 App 版本，若每个 target 的版本号不同，可以通过.env 文件来分别定义
 app_version ENV['APP_VERSION_RELEASE']

 #下载 metadata 及 screenshots 时直接覆盖，不询问
 force true

 #不覆盖 iTunes Connect原有截图
 skip_screenshots true
    
 #自动提交审核
 submit_for_review ENV['SUBMIT_FOR_REVIEW']
  
 #审核通过后立刻发布
 automatic_release ENV['AUTOMATIC_RELEASE']

 #新版本修改记录
 release_notes({        
    "zh-Hans" => ENV['RELEASE_NOTES']
 })

#App 加密算法使用情况及广告相关配置
submission_information({
    #Export Compliance
    export_compliance_available_on_french_store: "false",
    export_compliance_contains_proprietary_cryptography: "false",
    export_compliance_contains_third_party_cryptography: "false",
    export_compliance_is_exempt: "false",
    export_compliance_uses_encryption: "false",
    export_compliance_app_type: nil,
    export_compliance_encryption_updated: "false",
    export_compliance_compliance_required: "false",
    export_compliance_platform: "ios",

    content_rights_contains_third_party_content: "false",
    content_rights_has_rights: "false",

    #Advertising Identifier
    add_id_info_limits_tracking: "false",
    add_id_info_serves_ads: "false",
    add_id_info_tracks_action: "false",
    add_id_info_tracks_install: "false",
    add_id_info_uses_idfa: "false"
});

Fastfile

#---------- begin -----------

def update_build_number()

    currentTime = Time.new.strftime("%Y%m%d")
    build = get_build_number()
    if build.include?"#{currentTime}."
      # => 为当天版本 计算迭代版本号
      lastStr = build[build.length-2..build.length-1]
      lastNum = lastStr.to_i
      lastNum = lastNum + 1
      lastStr = lastNum.to_s
      if lastNum < 10
        lastStr = lastStr.insert(0,"0")
      end
        build = "#{currentTime}.#{lastStr}"
      else
        # => 非当天版本 build 号重置
        build = "#{currentTime}.01"
    end
    puts("*************| 更新build #{build} |*************")
    # => 更改项目 build 号
    increment_build_number(
      build_number: "#{build}"
    )

end

def prepare_version(options)

    # 正式版本号
    increment_version_number(
        version_number: options[:version]
    )

    # 构建版本号
    update_build_number()
 end

 def get_update_description()

     return "版本号:\n\b\b#{ENV['APP_VERSION_RELEASE']} \n更新描述:\n\b\b#{ENV['RELEASE_NOTES']}"
   
 end

#---------- end -------------

#---------- begin -----------

fastlane_version "2.54.3"

default_platform :ios

platform :ios do

  before_all do
    # ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."
    cocoapods
  end

  desc "1).优先版 发布到 蒲公英"
  lane :beta_main_pgy do
    sh "fastlane beta_pgy --env SunfoBank"
  end

  desc "2).马甲版 发布到 蒲公英"
  lane :beta_plus_pgy do
    sh "fastlane beta_pgy --env SunfoBankPlus"
  end

  desc "3).优先版 发布到 苹果商店"
  lane :release_mian_apple do
    sh "fastlane release_apple --env SunfoBank"
  end

  desc "4).马甲版 发布到 苹果商店"
  lane :release_plus_apple do
    sh "fastlane release_apple --env SunfoBankPlus"
  end

  desc "5).优先版 和 马甲版 同时 发布到 蒲公英"
  lane :beta_all_pgy do
    sh "fastlane beta_pgy --env SunfoBank"
    sh "fastlane beta_pgy --env SunfoBankPlus"
  end

  desc "6).优先版 和 马甲版 同时 发布到 苹果TestFlight"
  lane :beta_all_apple do
    sh "fastlane beta_apple --env SunfoBank"
    sh "fastlane beta_apple --env SunfoBankPlus"
  end

  desc "7).优先版 和 马甲版 同时 发布到 苹果商店"
  lane :release_all_apple do
    sh "fastlane release_apple --env SunfoBank"
    sh "fastlane release_apple --env SunfoBankPlus"
  end

  desc "发布 指定版本 到 蒲公英"
  lane :beta_pgy do
    # 更新版本号
    increment_version_number_in_plist(target: ENV['SCHEME_NAME'], version_number: ENV['APP_VERSION_RELEASE'])
    
    gym(scheme: ENV['SCHEME_NAME'], 
      export_method: "ad-hoc",
      silent: true,  # 隐藏没有必要的信息
      clean: true  # 在构建前先clean
        )
    pgyer(api_key: "d066f633dc2d970eb230dba7823ff022", 
      user_key: "4477d913a078c11df32be931523619dc", 
      update_description: get_update_description(), 
      password: "123456", 
      install_type: "2")
  end

  desc "发布 指定版本 到 苹果TestFlight"
  lane :beta_apple do

    # 更新版本号
    increment_version_number_in_plist(target: ENV['SCHEME_NAME'], version_number: ENV['APP_VERSION_RELEASE'])
    
    gym(scheme: ENV['SCHEME_NAME'],
      silent: true,  # 隐藏没有必要的信息
      clean: true  # 在构建前先clean
      )
    pilot
  end

  desc "发布 指定版本 到 苹果商店"
  lane :release_apple do

    # 更新版本号
    increment_version_number_in_plist(target: ENV['SCHEME_NAME'], 
      version_number: ENV['APP_VERSION_RELEASE'])
    
    gym(scheme: ENV['SCHEME_NAME'], 
      silent: true,  # 隐藏没有必要的信息
      clean: true  # 在构建前先clean
      )
    deliver
  end

#---------- end -------------

  # You can define as many lanes as you want

  after_all do |lane|
    # This block is called, only if the executed lane was successful

    # slack(
    #   message: "Successfully deployed new App Update."
    # )
  end

  error do |lane, exception|
    # slack(
    #   message: exception.message,
    #   success: false
    # )
  end
end

截图如下：

屏幕快照 2017-09-05 下午3.42.33.png

5.执行

这里以打包上传蒲公英为例，如果没有安装蒲公英插件，可以参考这篇文章：iOS持续集成：Fastlane + 蒲公英 自动打包发布，如果以上环境配置成功，我们可以执行以下命令：

bundle exec fastlane ios

然后顺利的话，将会出现类似如下的选择提示，截图图如下：

屏幕快照 2017-09-04 下午6.27.57.png

我们可以通过选择不同的序号并输入，来打包上传到不同的平台，此时，我们选择序号为5，同时将两个target版本打包上传到蒲公英平台。

稍等几分钟，如果出现类似下面的信息，就说明打包上传蒲公英成功了，是不是很方便！！！

屏幕快照 2017-09-04 下午6.27.57.png

通过终端输出的日志文件，我们同时可以看到编译、打包和上传的全过程，代码中出现的警告信息，也可以作为优化时的参考。到这里Fastlane 自动打包上传就完成了。

6.其他

参考链接
使用fastlane实现iOS持续集成
Fastlane自动化构建工具(完整解决测试和发布流程)

常见问题
https://stackoverflow.com/questions/23801899/bundlergemnotfound-could-not-find-rake-10-3-2-in-any-of-the-sources/26231894