一、前言
fastlane.png每次打包上传总是要耗费我们一些时间,并且都是些没有技术含量的重复性工作,如果能实现自动打包,我们岂不是可以节省很多时间做其他的事情,心里美滋滋,那么今天我们就来做一做这件事情,实现一个命令完成打包上传工作。
学习完本文,您还可以继续阅读 iOS Fastlane 自动化打包进阶
二、Fastlane 简介
Fastlane是一款为 iOS 和 Android 开发者提供的自动化构建工具,它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来,实现完全自动化的工作流,如果使用得当,可以显著的提高开发者的开发效率。
三、环境搭建
请参考:官方安装指南
- 1、检查ruby版本 要求大于2.0.0
$ ruby -v
- 2、检查 Xcode CLT 是否安装
$ xcode-select --install
- 3、安装fastlane
$ gem install fastlane -NV
安装成功后就可以为项目配置fastlane 了
四、项目配置
- 1、为项目配置 fastlane
$ cd 项目目录
$ fastlane init
初始化时,会出现4个选项:
Automate screenshots(自动化截图)
Automate beta distribution to TestFlight(TestFlight)
Automate App Store distribution (AppStore发布版本)
Manual setup - manually setup your project to automate your tasks(自定义)
直接输入1、2、3、4 选择你想创建的类型
中间会让输入苹果开发者账号和密码,之后会在你项目工程的目录下生成一个fastlane文件夹,里面有Fastlane的配置文件,一个是Appfile文件,一个是Fastfile文件(如果要上传AppStore的话还有Deliverfile文件)。
- Appfile保存苹果开发者的相关信息、项目的相关信息等。
-
Fastfile是运行脚本。
init
生成的文件信息
执行结束后产生的文件
五、上传蒲公英
参考:蒲公英官方文档
- 1、创建好faselane文件之后,安装蒲公英插件
//在项目目录下执行
$ fastlane add_plugin pgyer
- 2、修改Fastfile 内容
打开自动生成的Fastfile 我们可以看到
# This file contains the fastlane.tools configuration
# You can find the documentation at https://docs.fastlane.tools
#
# For a list of all available actions, check out
#
# https://docs.fastlane.tools/actions
#
# For a list of all available plugins, check out
#
# https://docs.fastlane.tools/plugins/available-plugins
#
# Uncomment the line if you want fastlane to automatically update itself
# update_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
end
end
将对应的地方更改如下
lane :beta do
build_app(export_method: "ad-hoc")
pgyer(api_key: "7f15xxxxxxxxxxxxxxxxxx141", user_key: "4a5bcxxxxxxxxxxxxxxx3a9e")
end
注意:
以上的 api_key 和 user_key,在蒲公英自己账号下的 应用管理 - App概述 - 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 beta
执行结果
等待一段时间后上传蒲公英成功,大功告成!!!
六、 自定义lane,实现更多功能✨
这里推荐Sublime 选择ruby语言进行编辑,并且掌握一些简单的ruby语法为好,这里我们使用
gym
(iOS和Android应用程序自动化测试版部署和发布的最简单方法),gym和上面的build_app功能一样,是他的别名。
关于gym一些Parameters的介绍请参考gym
default_platform(:ios)
platform :ios do
desc "上传蒲公英"
lane :beta do #beta 为lane 名称,我们执行时就是执行这个方法
scheme_name = "TestDemo1"
#导出路径 我们可以桌面创建IPA_Info(没有的话会自动创建) 文件夹来集中管理生成的ipa等文件
output_directory = "/Users/xxx/Desktop/IPA_Info"
#导出名称
output_name = "#{scheme_name}_#{Time.now.strftime('%Y%m%d%H%M%S')}.ipa"
gym(
export_method: "ad-hoc", #这里填写导出方式 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名字
)
# 上传蒲公英
pgyer(api_key: "e4xxxxxxxd2863db4136227b2f3ba4", user_key: "5e50ae3a91xxxxxxx0bc62f1baa5f", update_description: "#{option[:desc]}")
end
end
// 在项目根目录执行
$ fastlane topgyer
祝你成功,更多获取lane可跳转。
gym部分参数
学习完本文,您还可以继续阅读 iOS Fastlane 自动化打包进阶
网友评论