持续集成关于FastlaneiOS开发高级

Fastlane安装和使用和注意事项

2018-03-21  本文已影响807人  LYPC_下里巴人

Fastlane安装和使用参考博客:http://www.jianshu.com/p/840943eff17b
http://www.cocoachina.com/ios/20170519/19317.html

xcode-select --install

ruby -v查看ruby版本,要求2.0及以上版本

ruby的镜像文件路径改为https://gems.ruby-china.org/

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

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

gem sources -l

安装:
sudo gem install fastlane -NV

配置fastlane:切换目录到包含xxx.xcodeproj的项目目录下输入
fastlane init
输出:

[15:21:56]: What would you like to use fastlane for?
1. 📸  Automate screenshots
2. 👩‍✈️  Automate beta distribution to TestFlight
3. 🚀  Automate App Store distribution
4. 🛠  Manual setup - manually setup your project to automate your tasks
?  

这四个选项的意思是

1. 自动截屏。这个功能能帮我们自动截取APP中的截图,并添加手机边框(如果需要的话),我们这里不选择这个选项,因为我们的项目已经有图片了,不需要这里截屏。
2. 自动发布beta版本用于TestFlight,如果大家有对TestFlight不了解的,可以参考王巍写的这篇文章
3. 自动的App Store发布包。我们的目标是要提交审核到APP Store,按道理应该选这个,但这里我们先不选,因为选择了以后会需要输入用户名密码,以及下载meta信息,需要花费一定时间,这些数据我们可以后期进行配置。
4. 手动设置。

选择第四个后一路回车即可(等待时间略长),结束后会看到生成了fastlane目录,该目录包含Appfile和Fastfile;

此时不关终端,过一会儿提示回车,看提示回车几次之后结束;

[15:37:00]: Continue by pressing Enter ⏎

[15:37:05]: ------------------------------
[15:37:05]: --- Where to go from here? ---
[15:37:05]: ------------------------------
[15:37:05]: 📸  Learn more about how to automatically generate localized App Store screenshots:
[15:37:05]:         https://docs.fastlane.tools/getting-started/ios/screenshots/
[15:37:05]: 👩‍✈️  Learn more about distribution to beta testing services:
[15:37:05]:         https://docs.fastlane.tools/getting-started/ios/beta-deployment/
[15:37:05]: 🚀  Learn more about how to automate the App Store release process:
[15:37:05]:         https://docs.fastlane.tools/getting-started/ios/appstore-deployment/
[15:37:05]: 👩‍⚕️  Lern more about how to setup code signing with fastlane
[15:37:05]:         https://docs.fastlane.tools/codesigning/getting-started/
[15:37:05]: 
[15:37:05]: To try your new fastlane setup, just enter and run
[15:37:05]: $ fastlane custom_lane
LYPC:dingdingbao 4 LYPC$ 

然后(二选一,可以使用命令bundle exec fastlane custom_lane代替fastlane custom_lane,这样会执行的更快):fastlane custom_lane
bundle exec fastlane custom_lane
输出:

[15:40:15]: ------------------------------
[15:40:15]: --- Step: default_platform ---
[15:40:15]: ------------------------------
[15:40:15]: Driving the lane 'ios custom_lane' 🚀

+------+------------------+-------------+
|           fastlane summary            |
+------+------------------+-------------+
| Step | Action           | Time (in s) |
+------+------------------+-------------+
| 1    | default_platform | 0           |
+------+------------------+-------------+

[15:40:15]: fastlane.tools finished successfully 🎉  这句表示执行成功
LYPC:dingdingbao 4 LYPC$ 

打开Fastfile文件:打包是最主要的一步fastlane中有专门用于编译、打包的命令gym,我们加到lane :custom_lane do后看看会不会有问题
export_method:可选的值有:app-store、ad-hoc、development、enterprise

根据提示来输入Apple ID(开发者账号 、密码也会让输入)及app_identifier(就是项目的bundle id)等信息
这期间我使用的是企业版(299$)的账号 登录不成功 不知道原因 难道企业版不能使用fastlane吗 换了一个99$账号 可以了.

出现下面的提示 没有问题你就输入 y:

Please confirm the above values (y/n)

然后去看路径下多出来的fastlane文件:

Appfile用来存放app_identifier,apple_id和team_id:
有多个的时候 可以for_lane这样添加多个;

app_identifier "com.aaa.aaa"
apple_id "aaa@aaa.com"
team_id "AAAAAAAAAA"
 
for_lane :inhouse do
  app_identifier "com.bbb.bbb"
  apple_id "bbb@bbb.com"
  team_id "AAAAAAAAAA"
end

Fastfile管理你所创建的 lane

* scan 自动化测试工具,很好的封装了 Unit Test
* sigh 针对于 iOS 项目开发证书和 Provision file 的下载工具
* match 同步团队每个人的证书和 Provision file 的超赞工具
* gym 针对于 iOS 编译打包生成 ipa 文件
* deliver 用于上传应用的二进制代码,应用截屏和元数据到 App Store
* snapshot 可以自动化iOS应用在每个设备上的本地化截屏过程

这个是查到的比较全的带解释的:

# 指定 fastlane 最小版本
fastlane_version "2.20.0"

# 指定当前平台,可以设置为 ios 、android、mac
default_platform :ios

platform :ios do

# 在执行每一个 lane 之前都先执行这个代码
  before_all do
  end

# 定义一个创建测试包的 lane
# 我们调用的命令就是调用 fastlane 的 lane
  lane :buildDebugApp do |op|
      # 根据输入的版本设置项目 version number (我们初始化 fastlane 的时候是在 .xcworkspace 目录下, 而我们的项目中 ,.xcworkspace 和 .xcodeproj 不在同一级目录,这里的“increment_version_number”需要检测 .xcodeproj 项目文件,所以需要指定该文件的目录)
    increment_version_number({xcodeproj: './HomeMate2_Trunk/HomeMate.xcodeproj', version_number: op[:version]})

    # 根据输入的版本设置项目 build number (同上,也是需要指定 .xcodeproj 的目录)
    increment_build_number({xcodeproj: './HomeMate2_Trunk/HomeMate.xcodeproj', build_number: op[:version]})

    # 最重要的打包命令
    gym(
              export_method: 'ad-hoc',        # 打包的方式,可设置为 appstore(默认),enterprise
                     scheme: "HomeMate",    # 指定需要打那个 scheme 的包
                  workspace: "HMWorkSpac.xcworkspace",    # 指定打包的项目文件
                output_name: "HomeMate.ipa",      # 打包输出名称
                     silent: true,    # 隐藏不必要信息
                      clean: true,    # 打包前是否 clean 项目
              configuration: "Debug",    # 配置为 debug 版本
              buildlog_path: "./fastlanelog",    # 日志输出目录
       codesigning_identity: "iPhone Developer: Hailiang He (xxxxxxxxxx)",       # 代码签名证书
           output_directory: "/Users/xxx/Desktop"     # ipa输出目录
     )
  end

  # 在执行每一个 lane 之后执行该功能
  after_all do |lane|
  end

  # 在执行每一个 lane 出错的时候执行该功能
  error do |lane, exception|
  end

end

————————分割线———————————
这个是我自己编辑好打包也成功的,贴出参考:

#需要的fastlane的最小版本,在每次执行之后会检查是否有新版本,如果有会在最后末尾追加新版本提醒
fastlane_version "2.30.1"
default_platform :ios
platform :ios do
  before_all do
  end
  lane :beta do |options|
  cocoapods
  build_app(export_method: "ad-hoc")
  pgyer(api_key: "3335fc51738d0e016e876f877dab041a", user_key: "69b1831d78c147766e643e8d4a006bb3")
  end

  after_all do |lane|
    # slack(
    #   message: "Successfully deployed new App Update."
    # )
  end

  error do |lane, exception|
    # slack(
    #   message: exception.message,
    #   success: false
    # )
  end
end

编辑好以上内容,打开终端执行:
fastlane buildDebugApp version:2.2.0
或者fastlane buildDebugApp
这个过程会需要一些时间, 如果是直接传到iTunes connect上 这个也会把版本号校验出来,提示你确定版本号的正确否。

执行结束后我们在当前目录下将会看到[ProductName].ipa文件。

报错:
[!] Add 'gem "cocoapods"' to your Gemfile and restart fastlane
修改Gemfild文件 里面的 gem 'fastlane' 为 gem "cocoapods"

报错: method `to_plist' not defined in Array
分别执行以下命令:rvm @global do gem uninstall fastlane
rvm all do gem uninstall fastlane
gem uninstall fastlane
gem install fastlane

然后在执行打包(成功则万事大吉)依旧报错的话:[08:50:55]: RubyGems is not listed as your Gem source
[08:50:55]: You can run gem sources to see all your sources
[08:50:55]: Please run the following command to fix this:
[08:50:55]: $ gem sources --add https://rubygems.org
更改gem源:gem sources查看当前是啥
修改:gem sources --add https://rubygems.org然后gem sources查看确认一下是否修改成功

重新执行打包:fastlane  buildDebugApp
成功后输出:
[09:07:26]: Upload success. Visit this URL to see: https://www.pgyer.com/6DFV

+------+---------------------+-------------+
|             fastlane summary             |
+------+---------------------+-------------+
| Step | Action              | Time (in s) |
+------+---------------------+-------------+
| 1    | Verifying fastlane  | 0           |
|      | version             |             |
| 2    | default_platform    | 0           |
| 3    | cocoapods           | 6           |
| 4    | build_app           | 187         |
| 5    | pgyer               | 17          |
+------+---------------------+-------------+

[09:07:26]: fastlane.tools finished successfully 🎉

#######################################################################
# fastlane 2.86.2 is available. You are on 2.86.1.
# You should use the latest version.
# Please update using `sudo gem install fastlane`.
#######################################################################

2.86.2 Fixes get_version_number to auto-select target when there is only one
* Fixes get_version_number to auto-select target when there is only one (#12121) via Josh Holtz

Please update using `sudo gem install fastlane`
LYPC:StarCar LYPC$ 
附上一个友情链接:
中间会遇到的情况 升级配置:
使用RVM也就是Ruby Version Manager,Ruby版本管理器来升级ruby,RVM包含了Ruby的版本管理和Gem库管理(gemset)
安装RVM: curl -L get.rvm.io | bash -s stable

source ~/.bashrc

source ~/.bash_profile

rvm -v

使用RVM升级Ruby
ruby -v

列出已知ruby的版本,会出现很多平台不同的ruby的版本, 找到自己需要的版本
rvm list known

rvm install 2.1.10

查询:rvm list
卸载:rvm remove 2.0.0


设置默认版本: rvm use 2.1.10 --default

ruby -v   看看版本有没有变化PS:首先说明一下,在这一步,需要按回车键,连续按几次,当然如果你没装xcode,需要先去装xcode,不然会报错,接下来愉快的使用ruby吧
上一篇下一篇

猜你喜欢

热点阅读