Fastlane入(踩)门(坑)篇--fastlane配置与打包

前言

本篇文章针对Fastlane的安装进行详细的介绍，关于fastlane的介绍什么的不多说，直接看官网https://fastlane.tools/即可，本文记录的是完整的配置过程，至于配置过程中踩得坑，在另外我一篇中介绍，下面开始吧！

一、安装前准备

我的环境：macOS Mojave 10.14.4 (18E227)

使用Fastlane的要求：

1.OS X 10.9 (Mavericks) 以上
2.Ruby 2.0 以上
3.Xcode 7.3.1以上
4.拥有一个付费的苹果开发者账号

一、安装

1、安装xcode命令行工具

终端中输入以下命令：xcode-select --install。如果没有安装，会弹出对话框，点击安装。如果提示xcode-select: error: command line tools are already installed, use "Software Update" to install updates表示已经安装

xcode命令行工具.png

2、配置环境

可以使用sudo gem install fastlane -NV或者brew cask install fastlane进行安装，我们这里使用gem进行安装

1、查看当前gem源：gem sources

#如果没有修改过gem源，那么应该是默认的gem源https://rubygems.org/，如果修改过淘宝的镜像，那么显示https://ruby.taobao.org/，如果是rubychina的话，显示https://gems.ruby-china.org
注意：gems.ruby-china.org目前不可用，要换成.com后缀的，如下：https://gems.ruby-china.com

gem源不可用报错.png

3、安装Fastlane

sudo gem install fastlane --verbose

如果报错ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/commander或者ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /usr/bin directory.错误

报错展示.png

那么执行sudo gem install -n /usr/local/bin fastlane

等待安装完成...

安装完毕后查看版本号：fastlane -v或者fastlane --version（2019.5.6 我的版本号是fastlane 2.122.0）

查看版本号.png

cd到你项目文件夹下，执行 fastlane init命令。

此时可能会出现Unable to locate Xcode. Please make sure to have Xcode installed on your machine报错提示
解决方案：打开xcode--偏好设置（快捷键：command+，）--Location--Command Line Tools设置上就好了
成功以后会提示你输入Apple ID 和密码（开启双重验证的，还要输入验证码） 如图：

图片.png

如果你是第一次上传app的话，会有这么个提示：

图片.png

y/n后面输入 y就会给你自动去ITC里面创建一个出来

完成之后，项目文件夹里边会生成一个fastlane文件夹

图片.png

4、安装插件(我以上传fir.im为例)

fastlane add_plugin versioning
fastlane add_plugin firim

期间可能需要按y确认

插件.png

5、打包配置

打开Fastlane文件夹中的Fastfile文件，编辑实例如下：

platform :ios do
desc "archive ipa"
lane :archive do
#打包的ipa存放路径
outputDir = "~/Desktop/ipa"
#打包的ipa名称
outputName = "XXX"
gym(
scheme: "XXX", #改为你项目的scheme
#workspace: "XXX.xcworkspace", #如果项目使用CocoaPods需要加上
configuration: "Release",
output_directory: outputDir,
output_name: outputName,
include_bitcode: false,
include_symbols: true,
codesigning_identity: ENV["CODESIGNING_IDENTITY_TO_FIRIM"],
silent: true,
export_options: {
method: "ad-hoc", #根据具体情况定
thinning: ""
}
)
firim(firim_api_token: "XXXXXXXXXXXXXXXXXXXXX") #上传到firim
end

其中需要修改的为：
1、scheme修改为你项目自己的名称
2、如果你项目中使用了cocoapods，需要加上workspace
3.注册firim账号（过程略）,复制firim的token，替换进来
添加好的情况如图：

fastfile配置.png

6、打包

执行命令

fastlane archive

上图中，lane: archive do中的archive就是你要执行的名称，可以随意更改，但是要保持一致

打包上传成功展示

图片.png