100、fastlane iOS搭建 - BMWB/Fastlane_Swift GitHub Wiki

一、环境配置

1.安装rbenv

rbenv的源代码托管在github，在终端中，从github上将rbenv源码克隆到本地，然后设置$ PATH。

git clone git://github.com/sstephenson/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc

注意zsh用户是〜/ .zshrc

2.安装ruby-build

git clone git://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build

3.安装Ruby

查看可用的ruby版本

rbenv install --list

这里从列表中选择2.4.2进行安装：

rbenv install 2.4.2

等待一会儿，安装完毕后可以查看已经安装的所有Ruby版本：

rbenv versions

4.选择一个Ruby版本

rbenv中的Ruby版本有三个不同的作用域：全局（global），本地（local），当前终端（shell）。

查找版本的优先级是当前终端>本地>全局。

4.1设置全局版本

全局版本是在没有找到“当前终端”或“本地”作用域的设置时执行通过以下命令设置：

rbenv global 2.1.2

4.2设置本地版本

“本地”作用域是针对各个项目的，通过项目文件夹中的.rbenv-version这个文件进行管理，需要将相应的Ruby版本号写入这个文件。所以一般设置这个选项就可以了，这个过程可以通过以下命令执行：

rbenv local 2.1.2

4.3设置当前终端版本

“当前终端”作用域的优先级最高通过以下命令设置：

rbenv shell 2.1.2

4.4使用系统Ruby

如果要使用系统原有的Ruby，则通过系统指定：

rbenv global system

设置完毕后可以通过以下命令进行验证：

which ruby  # ~/.rbenv/shims/ruby 

rbenv version # 2.1.2 (set by ~/.rbenv/version)

5.安装Gem

使用rbenv后，gem还是按照原有的方式进行安装、升级，只是gem的安装路径是在~/.rbenv 文件夹中当前Ruby版本文件夹下。而且安装带有可执行文件的gem后，需要执行一个特别的命令，告诉rbenv更新相应的映射关系，这个命令在安装新版本的Ruby后也需要执行

rbenv rehash

安装rails

gem install bundler rails

检查安装后的软件版本

ruby -v gem -v rake -V rails -v

告诉Rubygems安装软件包的时候不安装文档

echo "gem: --no-ri --no-rdoc" > ~/.gemrc

安装后在.zshrc中添加

export PATH="$HOME/.rbenv/shims:$PATH">

查看gem源

gem sources

删除默认的gem源

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

增加taobao作为gem源

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

查看当前的gem源

gem sources

CURRENT SOURCES

http://ruby.taobao.org

清空源缓存

gem sources -c

更新源缓存

gem sources -u

6.配置bundler

安装gem后bundler是自带文件你可以运行

gem list 查看版本

删除/Users/wtj/.bundle/config，或者更改config中的BUNDLE_PATH路径,要不然会生成一堆项目目录下文件

BUNDLE_PATH: "vendor/bundle"
BUNDLE_DISABLE_SHARED_GEMS: "true"

项目中的Gemfile文件可通过如下命令生产，也可以自己创建填写内容

bundle init 生成Gemfile文件
bundle install --path /Users/wtj/Public/vendor/bundle 指定路径

bundler配置文件:

项目特定配置文件, 放在项目根目录下的.bundle/config文件中. 全局的配置文件, 放在 ~/.bundle/config文件中.

比如你在当前项目运行bundle install --without production, 后面的参数"--withou production"会自动被保存到项目根目录的.bundle/config文件中. 下一次运行bundle install会自动为你加上参数.

7.安装xcode-select --install

8.安装fastalne

sudo gem install fastlane --verbose

fastlane是一套自动化打包的工具集，用 Ruby 写的，用于 iOS 和 Android 的自动化打包和发布等工作。

fastlane包含了我们日常编码之后要上线时候进行操作的所有命令。

deliver：上传屏幕截图、二进制程序数据和应用程序到AppStore
snapshot：自动截取你的程序在每个设备上的图片
frameit：应用截屏外添加设备框架
pem：可以自动化地生成和更新应用推送通知描述文件
sigh：生成下载开发商店的配置文件
produce：利用命令行在iTunes Connect创建一个新的iOS app
cert：自动创建iOS证书
pilot：最好的在终端管理测试和建立的文件
boarding：很容易的方式邀请beta测试
gym：建立新的发布的版本，打包
match：使用git同步你成员间的开发者证书和文件配置
scan：在iOS和Mac app上执行测试用例

整个发布过程可以用fastlane描述成下面这样

lane :appstore do
increment_build_number
cocoapods
xctool
snapshot
sigh
deliver
frameit
sh "./customScript.sh"

    slack
en

二、fastlane脚本编写

fastlane文件夹下在新建一个Fastfile

# Customise this file, documentation can be found here:
# https://github.com/fastlane/fastlane/tree/master/fastlane/docs
# All available actions: https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Actions.md
# can also be listed using the `fastlane actions` command

# Change the syntax highlighting to Ruby
# All lines starting with a # are ignored when running `fastlane`

# If you want to automatically update fastlane if a new version is available:
# update_fastlane

# This is the minimum version number required.
# Update this, if you use features of a newer version
fastlane_version "1.110.0"

default_platform :ios

platform :ios do
    before_all do
    ENV["SLACK_URL"] = "https://hooks.slack.com/services/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" # Webhook URL created in Slack
    end

# 编译测试版本
desc "Jenkins"
lane :jenkins do |options|
    branch = 'master'

    ensure_git_branch(branch: branch)
    ensure_git_status_clean
    git_pull
    #increment_build_number
    # commit_version_bumpi
    # push_to_git_remote(remote:'origin', local_branch: branch, remote_branch: branch)
    # add_badge(shield: "v#{get_version_number}-#{get_build_number}-orange", no_badge: true)
    
    ipaFileName = “ test.ipa”;#”DailyBuild_v#{get_version_number}.#{get_build_number}.ipa";
    gym(
        workspace: './test.xcworkspace',
        scheme: 'test',
        clean: true,
        output_directory: ENV['SP_OUTPUT_DIRECTORY'],
        output_name: ipaFileName,
        configuration: 'Release',
        include_symbols: 'true',
        include_bitcode: 'false',
        archive_path: ENV['SP_ARCHIVE_PATH'],
        export_method: 'ad-hoc',
        codesigning_identity: 'XXXX(123456)',
        xcargs: "PROVISIONING_PROFILE_SPECIFIER='ad-hoc' DEVELOPMENT_TEAM='123456'",
        export_options: {
        provisioningProfiles: {"com.XXXX.XXXX" => "ad-hoc"},
        method:'ad-hoc',
        signingStyle:'manual'
        }
       )

    pgyer(
        api_key: "", 
        user_key: "",
        ipa: "#{ENV['SP_OUTPUT_DIRECTORY']}#{ipaFileName}")
    end

end

安装Plugin

到目前为止，大约有30个Plugin发布到了RubyGems下，我们可以通过如下命令来查找：

fastlane search_plugins [query]>

详情可以看这里 AvailablePlugins

假设我们的项目中需要使用一个名叫version_from_last_tag，用于获取git的最近一个tag，那么我们在终端的项目目录下执行：

fastlane add_plugin version_from_last_tag

添加完成后，项目中会多出一个Gemfile，Gemfile.lock，fastlane/Pluginfile三个文件，其中这个Pluginfile实际上就是一个Gemfile，里面包含对于Plugin的引用，格式如下：

# Autogenerated by fastlane
#
# Ensure this file is checked in to source control!

gem 'fastlane-plugin-version_from_last_tag'
gem 'fastlane-plugin-badge'
gem 'fastlane-plugin-pgyer'

而Pluginfile本身又被Gemfile引用，所以又印证上上文中的那句话：对Plugin的管理其实就是对RubyGem的管理。

此后的Plugin是实际用法和使用Action是一致的，所以就不在此赘述了。