Mac ~ fastlane安装使用说明

MAC2007 2020-04-20

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

end

custom_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。

相关推荐