前言
在项目提测的时候,Bug是不可避免的,往往这时候需要频繁的打包上传分发。如果使用传统的手动打包技术(ps:无技术含量可言),需要开发人员操作电脑按流程一步一步来缺一不可,非常浪费开发人员的时间,但如果给项目配置了自动打包,终端里一行命令一敲,便可省下传统打包的时间来学习想学的技术。
本文使用 Fastlane + 蒲公英 实现项目一键打包上传。
Fastlane介绍
Fastlane是一套使用Ruby写的自动化工具集,用于iOS和Android的自动化打包、发布等工作,可以节省大量的时间。
Fastlane安装
- 检查Ruby版本,需要2.0及以上版本。在终端输入以下命令确认:
ruby -v
如未安装请参考 ruby安装教程
检查ruby源是否切换到国内
gem sources
如已切换会结果如下
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
切换ruby源方法
gem sources --remove https://rubygems.org/
//等有反应之后再敲入以下命令
gem sources -a https://gems.ruby-china.org/
//验证是否替换成功可以执行
gem sources -l
- 检查Xcode命令行工具是否安装。在终端输入以下命令:
xcode-select --install
如果没有安装,根据提示安装。如已安装,结果如下:
xcode-select: error: command line tools are already installed, use "Software Update" to install updates
- 安装Fastlane
sudo gem install fastlane --verbose
输入密码之后,如果弹出如下错误:
ERROR: While executing gem ... (Gem::Requirement::BadRequirementError)
Illformed requirement ["erbose"]
再执行:
sudo gem install -n /usr/local/bin fastlane
终端中出现如下提示说明安装完成
Done installing documentation for slack-notifier, atomos, xcodeproj, rouge, xcpretty, terminal-notifier, unicode-display_width, terminal-table, plist, public_suffix, addressable, multipart-post, word_wrap, tty-screen, tty-cursor, tty-spinner, babosa, highline, commander-fastlane, excon, unf_ext, unf, domain_name, http-cookie, faraday, faraday-cookie_jar, fastimage, gh_inspector, mini_magick, multi_json, multi_xml, rubyzip, security, xcpretty-travis-formatter, dotenv, bundler, faraday_middleware, uber, declarative, declarative-option, representable, retriable, mime-types-data, mime-types, little-plugger, logging, jwt, memoist, os, signet, googleauth, httpclient, google-api-client, fastlane after 242 seconds
54 gems installed
- 蒲公英的Fastlane插件安装
cd到自己项目的根目录(即 跟 .xcodeproj 文件同一级目录),再执行:
fastlane add_plugin pgyer
根据提示操作,直到出现
// 安装成功
Successfully installed plugins
- 配置Fastlane
5.1. 初始化 Fastlane
打开终端,进入你的项目工程的根目录,输入以下命令:
fastlane init
中间会让你输入苹果开发者账号的账号和密码,之后会在你项目工程的目录下生成一个fastlane文件夹,里面有Fastlane的配置文件,一个是Appfile文件,一个是Fastfile文件(如果要上传AppStore的话还有Deliverfile文件)。Appfile保存苹果开发者的相关信息、项目的相关信息等。Fastfile是运行脚本。
5.2. 有时候一天需要打好几个包,为了区分,我们这里实现一个递增build号的功能。
(1)修改项目工程配置
修改Build Settings中的Versioning配置,Current Project Version随便填一个,Versioning System选择Apple Generic。
(2)在Fastfile中定义一个递增build号的函数,完整的Fastfile文件如下
# 定义fastlane版本号
fastlane_version “2.46.1”
# 定义打包平台
default_platform :ios
def updateProjectBuildNumber
currentTime = Time.new.strftime("%Y%m%d")
build = get_build_number()
if build.include?"#{currentTime}."
# => 为当天版本 计算迭代版本号
lastStr = build[build.length-2..build.length-1]
lastNum = lastStr.to_i
lastNum = lastNum + 1
lastStr = lastNum.to_s
if lastNum < 10
lastStr = lastStr.insert(0,"0")
end
build = "#{currentTime}.#{lastStr}"
else
# => 非当天版本 build 号重置
build = "#{currentTime}.01"
end
puts("*************| 更新build #{build} |*************")
# => 更改项目 build 号
increment_build_number(
build_number: "#{build}"
)
end
#指定项目的scheme名称
scheme=“TestCI”
#蒲公英api_key和user_key
api_key=“”
user_key=“”
# 任务脚本
platform :ios do
lane :development_build do|options|
branch = options[:branch]
puts “开始打development ipa”
updateProjectBuildNumber #更改项目build号
# 开始打包
gym(
#输出的ipa名称
output_name:”#{scheme}_#{get_build_number()}”,
# 是否清空以前的编译信息 true:是
clean:true,
# 指定打包方式,Release 或者 Debug
configuration:"Release",
# 指定打包所使用的输出方式,目前支持app-store, package, ad-hoc, enterprise, development
export_method:"development",
# 指定输出文件夹
output_directory:"./fastlane/build",
)
puts "开始上传蒲公英"
# 开始上传蒲公英
pgyer(api_key: “#{api_key}”, user_key: “#{user_key}”)
end
end
注意:蒲公英的 api_key 和 user_key,开发者在自己账号下的 账号设置-API信息 中可以找到。打其它类型的包的方法与development类似,可自定义一个新的lane实现。
最后,只需要在终端中输入:
fastlane development_build
便能实现一键打包上传蒲公英啦。