1.安装Fastlane
三选一
sudo gem install fastlane
sudo gem install fastlane -NV
brew cask install fastlane
2.安装shenzhen
sudo gem install shenzhen
3.在xcodeproj文件同级目录下,执行
fastlane init
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. 手动设置。
这里我们选择4后一路回车即可,结束后会在工程文件目录中看到生成了fastlane文件,该目录包含Appfile和Fastfile;
4.设置Appfile文件内容:
Appfile用来存放app_identifier,apple_id和team_id:
有多个的时候 可以for_lane这样添加多个;
# app_identifier("[[APP_IDENTIFIER]]") # The bundle identifier of your app
# apple_id("[[APPLE_ID]]") # Your Apple email address
# For more information about the Appfile, see:
# https://docs.fastlane.tools/advanced/#appfile
app_identifier "com.****.****" # bundleId
apple_id "*******@outlook.com" # 苹果账号
team_id "*******" # 团队ID
for_lane :inhouse do
app_identifier "com.****.****" # bundleId
apple_id "*******@outlook.com" # 苹果账号
team_id "*******" # 团队ID
end
5.设置Fastfile文件内容:
Fastfile管理你所创建的 lane
上面这个是网上查到的解释,下面的一个是我自己给项目配的
# 指定 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.20.0"
# 指定当前平台,可以设置为 ios 、android、mac
default_platform(:ios)
platform :ios do
desc "Description of what the lane does"
lane :enterprise do #分号后面不能有空格
gym(
scheme:"enterprise",
#export_method:可选的值有:app-store、ad-hoc、development、enterprise
export_method:"enterprise", #打包的类型,我打的是企业包
output_directory:"/Users/***/Desktop", #打包出来的地址
output_name:"enterprise_***.ipa", #打包好的文件名
export_xcargs: "-allowProvisioningUpdates",
)
end
# lane :custom_lane do
# # add actions here: https://docs.fastlane.tools/actions
# export_method:development
# end
end
6.打包成ipa
保存之后在终端里面运行 三选一
fastlane enterprise
fastlane ios enterprise
fastlane enterprise version:2.2.0
就会开始打包了。
7.参考资料
iOS Fastlane自动化打包(1) 安装和打包IPA
Fastlane安装和使用和注意事项
使用fastlane实现iOS持续集成