使用fastlane实现iOS自动化打包上传fir.im和testflight

前言

日复一日重复打包工作,是在浪费宝贵的时间

自动化打包工具应运而生,是我们解放双手的利器

fastlane官方文档

github地址

安装fastlane

安装最新的Xcode命令行工具

✅可以Developer Apple上手动下载对应的Command Line Tools 安装

fastlane官方推荐的xcode-select --install安装时最后结果是安装不了该软件

安装 fastlane

通过gem安装,放到/usr/local/bin下面

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

其他的安装方法:(扩展,可跳过)

![Xnip2019-10-09_14-40-37.jpg](https://upload-images.jianshu.io/upload_images/1432381-304f32263aa05ac0.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

以上:
方法1:是通过 Homebrew 软件包管理器来进行安装,
方法2:就是我们最熟悉的方式,下载安装包来进行安装,
方法3:是通过 RubyGems 来进行,RubyGems 是一个方便的 Ruby 程序包管理器,可以将一个 Ruby 应用程序打包到一个 Gem 里,作为一个安装单元。 一个 Gem 就是一个封装起来的应用程序或代码库

配置环境变量(可跳过)

任意目录如果可以执行fastlane,说明你的环境变量已经配置好,此处就无需配置

添加用户环境变量

vim ~/.bash_profile

添加如下内容

export PATH=/usr/local/bin:$PATH

保存退出,使用 source ~/.bash_profile 来使配置立即生效

现在在项目根目录下可以使用fastlane

fastlane使用

在项目根目录下初始化

fastlane init

  • 四个选项

    What would you like to use fastlane for?
    
    1.Automate screenshots
    2.Automate beta distribution to TestFlight
    3.Automate App Store distribution
    4.Manual setup - manually setup your project to automate your tasks
    

    中文解释如下:

    1 自动截屏。(帮助我们截取App的显示到appstore上的 截图)
    2 自动发布beta到TestFlight上,用于内测。
    3 自动打包发布到AppStore上。
    4 手动设置。
    

    上传fir此处选择的
    4

  • 初始化成功会生成如下目录

Xnip2019-10-09_14-40-37.jpg

配置相关文件

配置Gemfile

如果使用cocoapods要加上(注意带上当前安装的pod的版本号,否则会报错)

gem 'cocoapods', '~>1.8.3'

执行

bundle install

第一次运行 bundle install 时自动生成 Gemfile.lock 文件。以后每次运行 bundle install 时,如果 Gemfile 中的条目不变 bundle 就不会再次计算 gem 依赖版本号,直接根据 Gemfile.lock 检查和安装 gem。如果出现依赖冲突时可以通过 bundle update 更新 Gemfile.lock

配置Fastfile

default_platform(:ios)

platform :ios do
  
    before_all do
        # 如果你用 pod install
        cocoapods 
    end
  
    desc "打包上传ipa到fir.im"
    lane :fir do
    
    # 如果你没有申请adhoc证书,sigh会自动帮你申请,并且添加到Xcode里
    #   sigh(adhoc: true)
      
    # 以下两个action来自fastlane-plugin-versioning,
    # 第一个递增 Build,第二个设定Version。
    # 如果你有多个target,就必须指定target的值,否则它会直接找找到的第一个plist修改
    # 在这里我建议每一个打的包的Build都要不一样,这样crash了拿到日志,可以对应到ipa上
  
    increment_build_number_in_plist(
        target: 'TestDemo',
        build_number: '5'
    )
    increment_version_number_in_plist(
        target: 'TestDemo',
        version_number: '1.0'
    )
    # gym用来编译ipa
    gym(
        scheme: 'TestDemo',
        export_method: "ad-hoc", # 指定打包方式 ["app-store", "ad-hoc", "package", "enterprise", "development", "developer-id"]
        #teamID: "xxxxxx",  # developer.apple.com 上查看
        xcargs: "-allowProvisioningUpdates",
        output_directory: './firim',
        output_name: 'TestDemo.ipa'
    )
    # 上传ipa到fir.im服务器,在fir.im获取firim_api_token
    firim(firim_api_token: "xxxxxxxxxxxxx")  # token 在fir 上查看。
  end
  
  desc "打包上传testflight/app-store"
  lane :tf do

    increment_build_number_in_plist(
        target: 'TestDemo'
    )
    increment_version_number_in_plist(
        target: 'TestDemo',
        version_number: '1.0'
    )
    # gym用来编译ipa
    gym(
        scheme: 'TestDemo',
        export_method: "app-store", # 指定打包方式
        #teamID: "xxxxxx",  # developer.apple.com 上查看
        xcargs: "-allowProvisioningUpdates",
        output_directory: './testflight',
        output_name: 'TestDemo.ipa'
    )
    #upload_to_testflight
    appstore       # 上传你的App iTunes Connect
  end
end

关于build_number与version_number

1,version_number、build_number都没有设置,会自动获取项目的version和build版本号,并且都自动加1。例如,fastlane打包前后版本号变化:ver1.0.2(Build 11)-> ver1.0.3(Build 12);
2,version_number设置了、build_number没设置,会自动获取项目build版本号,build版本号+1;
3,version_number、build_number都设置了,那打包出来的版本号就是设置的版本号,不会自动+1;

添加两个插件

fastlane add_plugin versioning
fastlane add_plugin firim

执行打包

上传fir.im

fastlane fir

fir为Fastfile文件中lane :fir do处设置的名字,可以为别的名字

执行打包成功如下图所示:


Xnip2019-10-10_15-01-27.jpg
  • 根目录下firim文件夹下可看到ipa文件
Xnip2019-10-10_15-22-43.jpg

[图片上传中...(Xnip2019-10-10_15-01-59.jpg-bd69bf-1571314511771-0)]

  • fir.im应用列表,多了刚上传的项目
Xnip2019-10-10_15-01-59.jpg

上传testFlight

fastlane tf

问题

  1. Could not find action, lane or variable 'increment_build_number_in_plist'...
Xnip2019-10-10_21-04-25.jpg
  • 解决:

    fastlane add_plugin versioning

参考:https://github.com/SiarheiFedartsou/fastlane-plugin-versioning/issues/20

参考

  1. fastlane 自动打包到 fir.im 的踩坑之路
  2. fastlane ios快读入门文档
  3. fastlane使用说明书
  4. fastlane 在mac上配置iOS自动化上架
  5. iOS 自动打包 - fastlane (一)
  6. 和重复劳动说再见-使用fastlane进行iOS打包
  7. macOS/Linux 环境变量设置