一、安装xcode命令行工具(command line tools )
xcode-select --install
如果没有安装,会弹出对话框,点击安装。如果提示 xcode-select: error: command line tools are already installed, use "Software Update" to install updates 表示已经安装
二、安装Fastlane
sudo gem install fastlane -NV
或是brew cask install fastlane
我这里使用gem安装的
安装完了执行fastlane --version,确认下是否安装完成和当前使用的版本号。
三、安装pgy和fir插件,以便打包完成自动上传
fastlane add_plugin pgyer
fastlane add_plugin firim
四、初始化Fastlane
fastlane init
出现如下提示:
这里会弹出四个选项,问你想要用Fastlane做什么? 之前的老版本是不用选择的。选几都行,后续我们自行根据需求完善就可以,这里我选的是3
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.自动截图
2. ✈✈️自动将Beta分发到TestFlight
3.自动化App Store分发
4.手动设置-手动设置项目以自动执行任务
五、修改Fastfile,全局文件AppFile,多环境文件env
1.配置Fastfile
因为我们是多target的项目,需要写多个gym
default_platform(:ios)
platform :ios do
desc "Push a new release build to the App Store"
lane :release do
build_app(workspace: "Matafy.xcworkspace", scheme: "Matafy")
# upload_to_app_store
end
desc "打包到pgy"
lane :MatafyDev do |options|
sigh(adhoc:true) #如果要使用ad-hoc打包, 则需打开此项配置
gym(
clean:true, #打包前clean项目
# export_method: "ad-hoc", #导出方式 # app-store, ad-hoc, package, enterprise, development, developer-id
export_method: ENV['METHOD'],
# scheme:"MatafyDev", #scheme
scheme: ENV['SCHEME_NAME'],
configuration: "Release",#环境
output_directory:"./app",#ipa的存放目录
output_name:"Matafy Dev",#get_build_number()#输出ipa的文件名为当前的build号
)
#使用自动证书管理
enable_automatic_code_signing(path: "Matafy.xcodeproj")
#蒲公英的配置 替换为自己的api_key和user_key
pgyer(api_key: "xxxxxxxx", user_key: "xxxxxxxxx",update_description: options[:desc])
end
desc "打包到fir"
lane :Matafy do |options|
sigh(adhoc:true) #如果要使用ad-hoc打包, 则需打开此项配置
gym(
clean:true, #打包前clean项目
# export_method: "ad-hoc", #导出方式 # app-store, ad-hoc, package, enterprise, development, developer-id
export_method: ENV['METHOD'],
# scheme:"MatafyDev", #scheme
scheme: ENV['SCHEME_NAME'],
configuration: "Release",#环境
output_directory:"./app",#ipa的存放目录
output_name:"Matafy",#get_build_number()#输出ipa的文件名为当前的build号
)
#使用自动证书管理
enable_automatic_code_signing(path: "Matafy.xcodeproj")
#firim的配置 firim :8e6b56500b0fc122c9ce9007117a6055
firim(firim_api_token: "xxxxxxxxxx") #上传到firim
end
end
2.配置Appfile(存放着 AppleID 或者 BundleID 等一些fastlane需要用到的信息。基本上我们不需要改动这个文件的内容。)
app_identifier ENV['APP_IDENTIFIER']
apple_id ENV['APPLE_ID']
team_id ENV['TEAM_ID']
itc_team_id("xxxxxx") # App Store Connect Team ID
app_identifier "net.sunapps.1" # The bundle identifier of your app
apple_id "[email protected]" # Your Apple email address
# 如果账号里面有多个team,可以指定所有的team
# team_name "Felix Krause"
# team_id "Q2CBPJ58CA"
# 指定 App Store Connect 使用的team
# itc_team_name "Company Name"
# itc_team_id "18742801"
3.每个target建一个.env.target文件
APPLE_ID = "开发者账号"
FASTLANE_PASSWORD = "开发者密码"
TEAM_ID = "团队ID"
APP_IDENTIFIER ="Bundle Identifier"
SCHEME_NAME ="scheme名称"
METHOD = "ad-hoc" #"打包方式,可选enterprise、app-store等"
注意要在manage scheme中把targets的shared选项勾上,不然还是默认打的第一个target
六、运行fastlane
# 打测试包到pgy
fastlane MatafyDev Desc:dev4.0.2打包 --env MatafyDev
# 打正式包到fir
fastlane Matafy Desc:4.0.1 --env Matafy
上面命令意义为,fastlane 用matafyDev的gym运行,Desc为发布的描述(可为空), --env matafyDev 表示使用的是matafyDev这个环境变量来打包
补充:添加忽略文件:
#fastlane
# fastlane specific
**/fastlane/report.xml
# deliver temporary files
**/fastlane/Preview.html
# snapshot generated screenshots
**/fastlane/screenshots
# scan temporary files
**/fastlane/test_output
/app
/*.mobileprovision