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 = "xxx@xxx.xxx"

#苹果开发者帐号密码
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 = "xxx@xxx.com"
#苹果开发者帐号密码
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

同时,我的项目中的 AppfileDeliverfileFastfile 配置文件修改如下:

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

推荐阅读更多精彩内容