ios实现fastlane自动化打包

  终于抽出时间来学习自动化打包了,app在测试阶段一天总会经历好几次的打包,每次打包真是身心疲惫,刚打完的包说不定就被测试妹子反应还要微调什么地方,我就真的有气没法出,打一次包怎么也得浪费十几分钟,还不能改动自己的项目,一个上午或者下午发现很快就过去了,真的很是憋屈。下面就讲述自己的项目用自动化打包的详细过程。

  一、安装前的准备工作

  1. 首先确认是否安装了ruby,终端查看下ruby版本, 要求大于2.0.0
$ ruby -v

  2.确认是否安装了Xcode命令行工具    

$ xcode-select --install

      1)如果出现

  

  表示已经安装成功

  2)如果出现

    

  就点击安装就行了。。。

  二、正式安装

  安装fastlane

$ gem install fastlane -NV

  可能会遇到下面的错误提示

ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.

  既然没有权限,那就按照下面的方式尝试

$ sudo gem install fastlane -NV

  接下来还是报错,显示

ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /usr/bin directory.

     之后尝试用下面的方法就好了,是用 homebrew 再装一个 ruby, 这样 local 归 local, system 归 system. 反正也不大.

$ sudo gem install -n /usr/local/bin fastlane

  三、项目配置

  1、为项目配置 fastlane

$ cd 项目目录
$ fastlane init

   初始化的过程中会出现下面的选项:

  

  第一个选项的意思是:自动截屏。这个功能能帮我们自动截取APP中的截图,并添加手机边框(如果需要的话)
  第二个选项的意思是:自动发布beta版本用于TestFlight
  第三个选项的意思是:自动发布到AppStore
  第四个选项的意思是:手动设置

  我在这里选的是第四个(大家可根据自己需要选择),截图如上,紧接着一直点击enter键。

  

  出现上面的就表明成功了。

  中间可能会让输入苹果开发者账号和密码,安装成功之后之后会在你项目工程的目录下生成一个fastlane文件夹,里面有Fastlane的配置文件,一个是Appfile文件,一个是Fastfile文件(如果要上传AppStore的话还有Deliverfile文件)。

  • Appfile保存苹果开发者的相关信息、项目的相关信息等。
  • Fastfile是运行脚本。

  类似下面

  

  四、打包上传

  1、上传到蒲公英

  1)创建好faselane文件之后,安装蒲公英插件  

//在项目目录下执行
$ fastlane add_plugin pgyer

   中途遇到下面情况,选择y

  

  出现下面的提示即成功了

  

  2)修改Fastfile 内容

  打开自动生成的Fastfile文件

$ vim ./fastlane/Fastfile

  我们可以看到

   

  将对应的地方更改如下,有两种方式build_app或者gym,任选其一即可

  i、build_app方式

default_platform(:ios)

platform :ios do
  desc "Description of what the lane does"
  lane :TestImgPgyer do #lane冒号后面一定要紧跟名字,不能有空格
    # add actions here: https://docs.fastlane.tools/actions
build_app(export_method: "development")
  pgyer(api_key: "1b49e52f7ca2e286999ebdfa10f53c85", user_key: "1eaff70f6ff3b919b0f6c43fc1ec9378")
  end
end
  ii、gym方式
  自定义lane实现更多功能,这里我们使用gym(iOS和Android应用程序自动化测试版部署和发布的最简单方法),gym和上面的build_app功能一样,是他的别名。
default_platform(:ios)

platform :ios do
  desc "上传蒲公英1" 
  lane :TestImgPgyer do #TestImgPgyer 为lane 名称,只要和后面的lane保持一致即可,我们执行时就是执行这个方法
 scheme_name = "TestImg" 

  #导出路径  我们可以桌面创建IPA_Info(没有的话会自动创建) 文件夹来集中管理生成的ipa等文件
  output_directory = "/Users/xywy/Desktop/IPA_Info"

  #导出名称 
  output_name = "#{scheme_name}_#{Time.now.strftime('Pgyer%Y%m%d%H%M%S')}.ipa"
 
 gym(
    export_method: "development", #这里填写导出方式 ad-hoc、enterprise、app-store  
   #Xcode 9 默认不允许访问钥匙串的内容,必须要设置此项才可以
    export_xcargs: "-allowProvisioningUpdates", 
    scheme: scheme_name,# target的名字
    clean: true, # 在构建前先clean
    output_directory: output_directory, #ipa输出目录
    output_name: output_name#ipa名字
) 
  # 上传蒲公英,update_description为版本更新描述。
  pgyer(api_key: "1b49e52f7ca2e286999ebdfa10f53c85", user_key: "1eaff70f6ff3b919b0f6c43fc1ec9378", update_description: "haha") 
  end
end
  注意:
  以上的 api_key 和 user_key,点击蒲公英自己账号头像下的 “API 信息”页中可以找到,并替换到以上相应的位置。
  在 Xcode 8.3 和 Xcode 8.3 以后的版本中,对于 build_app 的 export_method 的值,需要根据开发者的打包类型进行设置,可选的值有:app-store、ad-hoc、development、enterprise。一定要确保你选择环境的对应的项目证书已配置正确,否则会报错误。对于 Xcode 8.3 以下的版本,则不需要设置 export_method。

  3)打包并自动上传 App 到蒲公英

//在项目目录下执行
$ fastlane TestImgPgyer #和前面lane后面的名称保持一致

   2、上传到fir.im

  1)类似上传到蒲公英,需要安装fir插件

$ fastlane add_plugin firim
$ fastlane add_plugin versioning

  出现下面的提示即成功了

    

  自动上传到fir还需执行如下命令:

$ gem install fir-cli

  如果报下面的权限错误

  

  改用

$ sudo gem install -n /usr/local/bin fir-cli --no-ri --no-rdoc

   提示下面信息,则成功了

  

2)修改Fastfile 内容。

$ vim ./fastlane/Fastfile

   下面只附上对应gym方式的内容

default_platform(:ios)

platform :ios do
 desc "上传fir” 
  lane :TestImgFir do #TestImgFir 为lane 名称,只要和后面的lane保持一致即可,我们执行时就是执行这个方法
 scheme_name = "TestImg" 

  #导出路径  我们可以桌面创建IPA_Info(没有的话会自动创建) 文件夹来集中管理生成的ipa等文件
  output_directory = "/Users/xywy/Desktop/IPA_Info"

  #导出名称 
  output_name = "#{scheme_name}_#{Time.now.strftime('fir_im%Y%m%d%H%M%S')}.ipa"
 
 gym(
    export_method: "development", #这里填写导出方式 ad-hoc、enterprise、app-store  
   #Xcode 9 默认不允许访问钥匙串的内容,必须要设置此项才可以
    export_xcargs: "-allowProvisioningUpdates", 
    scheme: scheme_name,# target的名字
    clean: true, # 在构建前先clean
    output_directory: output_directory, #ipa输出目录
    output_name: output_name#ipa名字
) 
  # 上传蒲公英
  firim(firim_api_token: "fffea58a4baed4d2b1fc2179d2f32119") 
 end
end

   注意:

  以上的firim_api_token可以在fir.im上,点击账号处的“API token”查看或者生成

  3)打包并自动上传 App 到蒲公英

//在项目目录下执行
$ fastlane TestImgFir #和前面lane后面的名称保持一致

   至此,自动化打包安装过程结束!!!  

补充:如果项目后续开发中能正常打包成功,但是提示需要更新的信息

则查看当前fastlane版本号

$ fastlane --version

 然后更新到提示的最新版本号

$ sudo gem install -n /usr/local/bin/ fastlane --version 2.114.0 #比如2.114.0就是最新版本号

 常见错误

  1. FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT

在遇到这个错误之后,在命令窗口运行下面代码来更新timeout时间:

#更新timeout
export FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT=120

  2.rvm install 2.7报错下面信息:

Error running 'requirements_osx_brew_update_system ruby-2.7.0-preview1',

please read /Users/zhuge/.rvm/log/1582609084_ruby-2.7.0-preview1/update_system.log

Requirements installation failed with status: 1.

解决方案:

步骤一:

$ rvm get master

步骤二:

首先验证下当前rvm和ruby版本

 然后再执行关键的一行命令,安装需要的ruby版本

$ rvm install 2.7

或者

$ rvm install 2.7 --verbose

两者的区别是下面的一行命令能展示安装的进度

可以看出ruby安装成功了!!!

参考自:

https://www.jianshu.com/p/5119c115ec90

https://mp.weixin.qq.com/s/mRLfF8T8JoIFbr5TiJDzpw

https://www.jianshu.com/p/6c0d583981ea

 

posted @ 2019-01-16 10:01  菁欣  阅读(1159)  评论(0编辑  收藏  举报