自动化工具Fastlane: 安装, 打包,上传(testFli

2017-02-16 本文已影响1472人会武功的蚊子

什么是Fastlane?

官方自己的定义是这样的：

fastlane is a tool for iOS, Mac, and Android developers to automate tedious tasks like generating screenshots, dealing with provisioning profiles, and releasing your application.

从这里我们可以看出，fastlane针对的developers主要是 iOS, Mac, and Android。目的在于替代完成一切没有技术含量的、乏味的工作。简单列举了比如screenshot,provisioning profiles,deliver。

我们第一次接触fastlane或者之前从来没有使用过CLI工具的人，对于上边的概念描述只能知道他的功能，但是不知道fastlane到底是哪个类型的工具，怎么实现上边功能。关于这一点，我在阅读 Wang Hailong 的文章得到了很简练的答案，摘录如下

fastlane命令是一个流程控制的命令行工具(CLI)，通过内部集成action和第三方的action完成一系列控制流程。运行fastlane命令行工具，会读取当前目录或者./fastlane目录下的Fastfile配置文件。

在Fastfile中：

action => Fastlane中的每一条命令都是一个扩展(action)，上面提到的deliver，sigh之类的工具本身是CLI，但是在Fastlane中内嵌了对他们支持的action

lane => Fastlane中流程的合集，每一个动作即可以是action，也可以是其他的lane。语法和ruby中的rake非常像

一个简单的发布流程：

lane :deploy do

# 执行 pod instasll

cocoapods

# 执行 carthage bootstrap

carthage

# 增加build版本号

increment_build_number

# 编译代码

gym

# 发布到Apple Store

deliver(force: true)

end

安装

搞了半小天和在同事的帮助下终于安装上了，也把在安装时候遇到的一些问题分享给大家，看完下面相信大家，很快就会搞定的。

首先：

fastlane安装的方式有三种，分别是Homebrew、Installer Script，Rubygems。这里需要注意的是，不管选择哪种方式，你都要安装Ruby。

我使用的是rubygems

1.Ruby必须在2.0以上版本

2.macOS 10.9以上系统

3.Xcode 7.3.1 以上版本

4.拥有一个付费的苹果开发者账号

其他：#

安装Ruby/Rubygems,这里注意你在下来一个Ruby版本之后，之前的Ruby也是存在的，所以你需要通过rvm use XXXX --default指定你要使用哪一个Ruby版本，具体可以参考这篇文章《MAC机中安装RUBY环境》

配置环境

更新ruby版本，安装rvm

curl -L get.rvm.io | bash -s stable # 安装

rvm -v # 测试是否安装正常

rvm list known # 列出已知ruby版本

rvm install ruby-xxxxx # 安装一个最新ruby版本注：此处xxxxx为list中的最新版本号

如果报错的话

brew install openssl

reinstall|install ruby-xxxxx # 注意修改xxxxxx

以上所需的ruby环境基本配置好了

2.打开终端，选择ruby 源

#查看gem源

gem sources

# 删除默认的gem源

gem sources --remove https://ruby.taobao.org/

# 增加rubygems作为gem源

gem sources --a https://rubygems.org/

# 查看当前的gem源

gem sources

*** CURRENT SOURCES ***

https://rubygems.org/

# 清空源缓存

gem sources -c

# 更新源缓存

gem sources -u

安装Fastlane

1.安装xcode-select

xcode-select --install

# 如果 Xcode CLT 已经安装，则会报如下错误

# command line tools are already installed, use "Software Update" to install updates.

# 如果未安装，终端会开始安装 CLT

2.安装fastlane

sudo gem install fastlane --verbose

# 如果报错：ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/commander

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

# 等待着安装完毕....coffee or tea

# 安装结束后,查看版本（2016.9.26我的版本是1.104.0）

fastlane --version

# 实际上目前安装的fastlane并不是最新版本，还需要更新，怎么更新呢，看下面

# cd到项目文件夹

cd xxxxx

fastlane init

# 需要按照提示输入 AppID以及密码, 这个是你项目的开发者帐号，下边要输入项目的bundleIdentifier，然后出现了提示

########################################################################

# fastlane 1.104.0 is available. You are on 1.103.0.

# It is recommended to use the latest version.

# Update using 'sudo gem update fastlane'.

#######################################################################

# 更新最新版本

sudo gem install -n /usr/local/bin/ fastlane --version1.104.0

# 如果报错 Could not find a valid gem 'fastlane' (= 1.66.0) in any repository ，那么更换一个ruby源，详见步骤2

# 继续更新最新版本

sudo gem install -n /usr/local/bin/ fastlane --version1.104.0

# 1.104.0成功安装！

接着

确保Xcode Command Line Tools 安装了最新版

`xcode-select --install`

如果你单独安装过ruby(如果你能看得懂这句)，去掉sudo。如果使用系统自带的ruby，需要sudo权限

sudo gem install fastlane`

提示安装成功，恭喜你，你已经成功了一半。

初始化

cd 到项目目录中

fastlane init

# 注意：如果你看到一个 “permission denied” 错误，你可能要在命令前加上 sudo。

接着

请输入 App Identifier (com.krausefx.app):

请输入一个唯一的 app ID。请记住这个 ID，因为后面你还会用到它！你的 Apple ID (fastlane@krausefx.com):

请输入你的 Apple ID 是否创建 deliver 命令，即上传 app 屏幕截图、app 元数据和 app 更新到 App 商店或者苹果的 TestFlight？(y/n)

输入 n 是否创建 snapshot 命令，它会自动获取 app 在所有语言和设备类型上的屏幕截图？(y/n)

输入 y 是否使用 sigh 命令，它会维护和下载 app 的 provisioning profile？(y/n)

输入 y 可选项：app 的 scheme 名称：（如果不需要，直接回车）

在项目根目录下，初始化Fastlane：

fastlane init

提问了你的Apple ID，Team的问题之后，fastlane会自动检测当前目录下项目的App Name和App Identifier。如果检测的不对，选择n自行输入。

接下来会问你这个app是否需要在iTC和ADC中创建(上一步中如果选择y会自动检测是否需要创建)，fastlane会调用produce进行初始化，如果现在还不想创建，也可以之后再运行produce init进行这个流程。如果不执行produce的流程，deliver的流程也会被掠过，当然之后也可以deliver init运行完全一样的流程。

在执行deliver init的过程中，会同步iTC中的所有语言的元数据和截图，并按照目录结构组织好。目录结构应该类似下面：

fastlane

├── Appfile

├── Deliverfile

├── Fastfile

├── metadata

│ ├── copyright.txt

│ ├── en-US

│ │ ├── description.txt

│ │ ├── keywords.txt

│ │ ├── marketing_url.txt

│ │ ├── name.txt

│ │ ├── privacy_url.txt

│ │ ├── release_notes.txt

│ │ └── support_url.txt

│ ├── primary_category.txt

│ ├── primary_first_sub_category.txt

│ ├── primary_second_sub_category.txt

│ ├── secondary_category.txt

│ ├── secondary_first_sub_category.txt

│ ├── secondary_second_sub_category.txt

│ └── zh-Hans

│ ├── description.txt

│ ├── keywords.txt

│ ├── marketing_url.txt

│ ├── name.txt

│ ├── privacy_url.txt

│ ├── release_notes.txt

│ └── support_url.txt

└── screenshots

├── README.txt

├── en-US

│ ├── 一堆png图片

这里肯定会被创建的是Appfile和Fastfile。如果Deliverfile，screenshots和metadata目录没被创建，可以运行deliver init来创建。

1. Fastfile => 用来定义所有的lane任务Fastfile帮助

2. Appfile => 是用来存储一些公共信息的，比如app_identifier，apple_id，team_id，itc_team_id等。Appfile帮助

3. Deliverfile => deliver的配置文件Deliverfile帮助

PS:

1. 这里有个小问题，iTC和ADC中的Team ID是不一样的，在fastlane init中只会自动在Appfile里写入ADC的team_id，所以在这个过程中会不停的问你iTC的Team ID，所以在创建完Appfile后，手动在里面添加itc_team_id。

2. 这个问答对不同的项目可能有各种各样的分支。我已经用不同的项目试过很多次了，但是可能还不是全部，所以你还需要见招拆招。

3. 在这里可以安心的输入密码，所有的密码都加密保存在系统的Keychain里。

接着在项目目录中会生成fastlane文件夹

其中Fastfile，Appfile，Deliverfile这三个文件，功能如上介绍，如果不出问题的话，大家的这三个文件内容应该是和我一样的如下(可以选择sublime打开，然后把当前显示样式设置为Ruby)：

Fastfile:

fastlane_version "2.5.0"

default_platform :ios

platform :ios do

before_all do

# ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."

end

desc "Runs all the tests"

lane :test do

scan

end

desc "Submit a new Beta Build to Apple TestFlight"

desc "This will also make sure the profile is up to date"

lane :beta do

# match(type: "appstore") # more information: https://codesigning.guide

gym(scheme: "BlusinessAreaPlat") # Build your app - more options available

pilot

# sh "your_script.sh"

# You can also use other beta testing services here (run `fastlane actions`)

end

desc "Deploy a new version to the App Store"

lane :release do

# match(type: "appstore")

# snapshot

gym(scheme: "BlusinessAreaPlat") # Build your app - more options available

deliver(force: true)

# frameit

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

在Fastfile这个文件中，就是我们打包,发布到fir,testFlight，appstore等等操作的具体配置文件。

Appfile:

app_identifier "com.xxxx.xxxx" # The bundle identifier of your app

apple_id "xxxxx@xxxx.com" # Your Apple email address

team_id "XXXXXXXXX" # Developer Portal Team ID

Deliverfile:

app_identifier "com.xxxx.xxxx" # The bundle identifier of your app

username "xxxxx@xxxx.com" # your Apple ID user

关于Fastfile文件

对照我们上边fastlane init命令创建出来的默认是的Fastfile默认文件，我们一次解析文件中的「元素」所代表的含义

fastlane_version => 指定fastlane最小版本

default_platform => 指定当前平台，可选ios,android,mac

desc => 一个lane(英文翻译是：小巷，小路，我们这里可以理解为任务)的描述，一般说明这个lane是做什么的

lane : 任务的名字 do => 指定任务的名字，我们在执行这个任务的时候，调用命令的格式为 fastlane 任务的名字，比如fastlane release。在Fastfile文件中会有很多的lane，我们通俗的把理解为小任务，每个小任务都负责一个功能。然后我们调用不同的小任务，来实现打包、上传到development、上传到testFlight、上传到app store等功能。换句话来说，也就是，我们具体关于怎么打包、怎么上传的配置是放到对应的lane里边的

（lane......）end => lane到end标识之间的内容，声明了一个任务具体执行哪些操作，不指定哪些操作

这个模块是表示我们上传到app store的。

打包

这里再执行打包就很简单了，默认Fastfile中包含gym这一个功能模块的lane，都可以执行打包操作。在gym中指定output_directory一项来指定输出的.ipa文件的输出目录，如果不指定的话，只在项目根目录下。

执行lane命令：

fastlane lane的名字

比如 fast lane release 执行打包上传到appstore