Mac ~ fastlane安装使用说明
fastlane安装使用说明
- 环境检测
因为fastlane是ruby书写的，所以需要检测当前ruby的版本, 需要保证ruby的版本在2.0以上，在终端输入以下命令：
$: ruby -v (# or `ruby --version`)
如果ruby低于2.0.需要进行以下步骤：
$:rvm remove versionNumber (#versionNumber是通过上述命令得出的当前Mac的ruby版本号）
$:rvm list known （#列出已知可用的ruby版本号）
$:rvm install versionNumber (#versionNumber是需要安装的ruby版本号)
- fastlane配置
需要安装Xcode，命令行安装需要执行终端输入：
xcode-select --install
继续安装fastlane,有两种方式，第一种通过RubyGems安装：
sudo gem install fastlane -NV
第二种通过HomeBrew:
brew cask install fastlane
- set up Environment variables(配置环境参数)
显示mac系统的隐藏文件,点按cmd + shift + . 三个按钮，显示user级别下的隐藏文件，找到 .bash_profile进行编辑。
<1> 可以通过拖动此文件到快捷栏上的Xcode图标上会自己打开，也可以通过终端vi .bash_profile来进行编辑。编辑方式在此文件中添加以下配置
export LC_ALL=en_US.UTF-8 export LANG=en_US.UTF-8
<2>: 对于电脑是没有.bash_profile文件（，这种情况需要手动创建bash_profile文件，终端cd到macUser（用户名）文件下（或者直接打开或者command+T另开一个终端界面），逐步输入以下命令：
$: touch .bash_profile $:vi .bash_profile (#也可使用open .bash_profile)
打开bash_profile后，添加<1>中的命令。
- 使用Gemfile
其实这步不用，管网给出的文档说，Gemfile是通过需要手动终端输入命令生成的，但是fastlane init之后显示是直接连带生成，其中给出了两句代码如下：
source "[https://rubygems.org](https://rubygems.org/)" gem "fastlane"
项目中使用自动化打.ipa包
1，对于fastlane配置好之后，可以开始对工程目录进行使用。
cd到对应的项目工程下，继续终端输入：
fastlane init
会看到生成至少包含fastfile和Appfile的fastlane文件和Gemfile文件。 其中会出现4个选项，1-2-3会涉及到需要登录账号和密码操作.
Appfile: 用来存储一些公共信息，比如app_identifier、apple_id、team_id、itc_team_id等。
fastfile: 用来定义所有的lane任务。
Gemfile: 管理fastlane的工具，类似pod.lock。
2, 对fastlane进行任务定义coding。
默认是iOS平台，输入命令可以修改。
默认的生成的fastlane模板是：
default_platform(:ios)
platform :ios do
desc "Description of what the lane does"
lane :custom_lane do
# add actions here: [https://docs.fastlane.tools/actions](https://docs.fastlane.tools/actions)
end
endcustom_lane即如函数名一样，终端输入fastlane custom_lane即可执行此lane当前最小定义域内do{...}end中的行为。
<1>: 定义lane。
>>>get_certificates #获取证书
>>>get_provisioning_profile #获取描述文件
>>>sigh(adhoc:false)
>>>build_app(workspace: "Sakura.xcworkspace", scheme: "Sakura") //假如你使用了cocoapod
>>>upload_to_app_store(skip_metadata: true, skip_screenshots: true) //上传到appStore
>>>changelog = prompt(
text: "Changelog: ",///提交change的日志信息
multi_line_end_keyword: "END",///当想结束本次信息输入时，输入END点按Enter键即可
)
>>>upload_to_testflight(changelog: changelog) //上传到testflight进行测试
eg: upload_to_testflight(changelog: "Add rocket emoji")
eg: upload_to_testflight(skip_waiting_for_build_processing: true)
skip the "Waiting for processing" of the binary
While this will speed up your build, it will not distribute
the binary to your tests, nor set a changelog
通过以下命令，可以实现在p12授权的情况下，进行自动打.ipa包，这里以Sakura为例
>>>build_app(
workspace: "Sakura.xcworkspace", #使用了cocoapod就需要有workspace了
scheme: "Sakura", #工程下要打包的项目,如果一个工程有多个项目则用[项目1,项目2]
configuration: "Release", # Debug or Release
clean: true, #清空上次打包信息
export_method:"enterprise", # app-store, ad-hoc, package, enterprise, development, developer-id
output_directory: ‘./build‘, #指定ipa最后输出的目录
output_name: "Sakura.ipa",
//export_xcargs: "-allowProvisioningUpdates",
export_options: {
provisioningProfiles: {
"当前scheme对应的target工程的bundle id" => "当前scheme所对应的profile描述文件",
}
}
)
>>>enable_automatic_code_signing(path: "Sakura.xcworkspace") //开启自动签名fastlane添加插件
1，搜索插件，可以通过以下命令(默认是在当前工程目录下，以firim(与蒲公英并列的主流分发平台之一) 为例)：
$:fastlane search_plugins fir
实际的要安装的插件是firim，因此搜索的结果会展示多个包含多个fir的插件名，当看到firim的时候，可以锚定即是它（fir.im）。
2，添加插件
$:fastlane add_plugin firim 在这一步，会出现以下错误：
An error occurred while installing unf_ext (0.0.7.6), and Bundler cannot continue. Make sure that `gem install unf_ext -v ‘0.0.7.6‘` succeeds before bundling.
把Gemfile文件的source注释即可。
3，在fastlane中添加插件命令
上传ipa到fir.im服务器，在fir.im获取firim_api_token
firim(firim_api_token: ‘123456fdedftyuioopa9988hnai9‘)
如果是上传到蒲公英，需要再蒲公英获取api_key和userKey（登录成功，点击Api信息）
pgyer(api_key: "2bd73d92030", user_key: "f0c61905ed")
查询更多参数
当已知的某个ruby命令中参数不能够功能时，可以使用
fastlane action **** //such as ‘upload_to_testflight‘, to get a list of all available options fastlane action upload_to_testflight
"当前scheme所对应的profile描述文件名"指当前工程在打包的时候非自动配置时需要选择的此profile文件。
一个项目在发布时，bundleid对应的Provisioning Profiles会存在多个，有效即可。
当选择Automatically manage signing的时候，需要cd到~/Library/Mobile Device/profile文件夹中找对应有效的描述文件。
如果一个工程中存在多个target会有多个Provisioning Profiles同时存在。则需要在fastlane文件定义环境变量或手动切换进行选择Provisioning Profiles。