fastlane工具 之 build_app和upload_to_app_store

序言

fastlane是一款自动打包工具,他有一些核心的工具,比如说打包用的build_app(别名:gym),上传App Store用的deliver等等。
关于工具的使用和里面有的配置项,我们可以通过官网的文档,里面有针对各种工具配置项的介绍,也可以通过mac上的终端输入命令:

//XXX是工具名
fastlane action XXX

终端将会展示XXX工具的所有配置项

好了,那我们这边主要先介绍两个工具,也是在自动打包发布中最主要的两个工具gymdeliver

gym(别名:build_app或者build_ios_app)

Key Description Default
workspace workspace文件路径
project project文件路径
scheme 指定工程的scheme,确认这个scheme是勾选了shared的
clean 在构建前是否要clean false
output_directory ipa文件应该存储在其中的目录 .
output_name 生成ipa文件的名字
configuration 构建app时使用的配置。默认为“发布” *
silent 在构建时隐藏终端不必要输出的信息 false
codesigning_identity 代码签名用的名字,它应该与名称完全匹配,例如'iPhone Distribution: SunApps GmbH'
skip_package_ipa 是否应该跳过打包ipa false
include_symbols 生成的ipa文件是否包含symbols,这个文件是内存标记文件,用来定位错误信息的,有了这个安装包大小会变大
include_bitcode 生成的ipa文件是否包含bitcode,在本身项目中也可以配置,我的项目设置为NO
export_method 用于导出archive的方法。有效值是:appstore, ad-hoc, package, enterprise, development, developer-id
export_options 指定导出选项plist的路径。使用“xcodebuild -help”来打印完整的可用选项集(应该是用来配置“xcodebuild -help”能打印出来的命令,具体怎么做和作用不明)
export_xcargs 将额外的参数传递给打包阶段的xcodebuild。一定要引用设置名称和值,例如OTHER_LDFLAGS="-ObjC -lstdc++" (我用到了export_xcargs: "-allowProvisioningUpdates"来解决一个EXPORT FAILED问题)
skip_build_archive 从构建好的archive导出ipa。使用archive_path作为源
skip_archive 构建后,不要archive
build_path archive应该存储的目录。
archive_path 创建archive的路径。
derived_data_path 构建产品和一些元数据的目录将会消失(我在想是不是指定目录后当项目构建完自动清除这个目录中的元数据
result_bundle Xcode结果包的位置(不知道干什么用的)
buildlog_path 存储构建日志的目录 *
sdk 应该用于构建应用程序的SDK
toolchain 应该用于构建应用程序的工具链(例如com.apple.dt.toolchain.Swift_2_3, org.swift.30p620160816a)
destination 使用自定义的目的地来构建这个应用程序
export_team_id 有时您需要在导出ipa文件时指定一个团队id(Optional
xcargs 将额外的参数传递给构建阶段的xcodebuild。一定要引用设置名称和值,例如OTHER_LDFLAGS="-ObjC -lstdc++"
xcconfig 使用一个额外的XCCONFIG文件来构建你的应用程序(不懂
suppress_xcode_output 抑制xcodebuild输出到stdout。输出信息在buildlog_path中仍然保存
disable_xcpretty 禁用生成输出的xcpretty格式
xcpretty_test_format 使用测试(RSpec样式)格式来构建输出
xcpretty_formatter 使用的自定义xcpretty格式化程序
xcpretty_report_junit 是否在这个提供的路径上有xcpretty创建一个junit样式的XML报告
xcpretty_report_html 是否在这个提供的路径上创建了一个简单的HTML报告
xcpretty_report_json 是否在这个提供的路径上有xcpretty创建一个JSON编译数据库
analyze_build_time 静态分析项目构建时间并将输出存储在'culprits.txt' 中
xcpretty_utf 在报告构建时,xcpretty是否使用unicode编码
skip_profile_detection 不要试图从xcodeproj构建配置文件映射。应该使用匹配或手动提供的映射(不懂,看上去不是很重要 false

* = 默认值依赖于用户的系统

deliver(别名:appstore或者upload_to_app_store)

Key Description Default
username Apple ID的用户名 *
app_identifier 应用程序的包标识符 *
app 你想要使用/修改的应用程序的ID
edit_live 修改实时元数据,此选项禁用ipa上传和截图上传 false
ipa ipa文件路径 *
pkg pkg文件路径 *
platform 使用的平台(optional) ios
metadata_path 包含metadata文件夹的路径,metadata中保存的appstore中你应用的具体内容介绍(如标题、描述)
screenshots_path 包含屏幕快照文件夹的路径
skip_binary_upload 跳过上传ipa或pkg到iTunes Connect false
use_live_version 使用实时版本而不是编辑版本 false
skip_screenshots 不上传屏幕快照 false
app_version 应该编辑或创建的版本
skip_metadata 不要上传元数据(如标题、描述)。这仍然会上传屏幕快照 false
skip_app_version_update 不要更新app提交的版本 false
force 跳过HTML报告文件验证。 false
submit_for_review 在上传所有内容后提交新版本进行审核 false
reject_if_possible 拒绝先前提交的处于所有可能的状态构建 false
automatic_release 一旦应用程序审核通过,该应用会自动发布App Store false
auto_release_date 审核通过后自动发布App Store的以毫秒为单位的日期
phased_release 启用iTC的分阶段发布功能(不懂 false
price_tier 应用程序的价格层级别
build_number 如果设置给定的构建号(已经上传到iTC)将被使用代替当前构建号
app_rating_config_path 应用程序配置的路径
submission_information 提交的额外资料(例如:第三方内容)
team_id 如果你在多个团队,你的iTunes Connect团队的ID *
team_name 如果你在多个团队中,你的iTunes Connect团队的名字 *
dev_portal_team_id 如果您在多个团队中,您的开发人员门户团队的短ID。不同于您的iTC团队ID! *
dev_portal_team_name 如果您在多个团队中,您的开发人员门户团队的名称 *
itc_provider 提供者的短名称,用iTMSTransporter标识您的团队。来获得提供者的短名称,去运行Xcode.app/Contents/Applications/Application\ Loader.app/Contents/itms/bin/iTMSTransporter -m provider -u 'USERNAME' -p 'PASSWORD' -account_type itunes_connect -v。供应商的短名称应该列在第二列
overwrite_screenshots 在上传新截图之前,先清除所有之前上传的截图 false
run_precheck_before_submit 在提交应用程序审核之前运行precheck true
precheck_default_rule_level 默认的规则级别,除非有其他配置 :warn
app_icon Metadata(元数据):应用程序图标的路径。
apple_watch_app_icon Metadata(元数据):苹果手表应用程序图标的路径。
copyright Metadata(元数据):版权公告
primary_category Metadata(元数据):主要类别的英文名称(如商业、书籍)
secondary_category Metadata(元数据):次级类别的英文名称(如商业、书籍)
primary_first_sub_category Metadata(元数据):主要的第一个子类别的英文名(如教育、字谜)
primary_second_sub_category Metadata(元数据):主要的二级类别的英文名(如教育、字谜)
secondary_first_sub_category Metadata(元数据): 次级类别第一个子类别的英文名称(如教育、字谜)
secondary_second_sub_category Metadata(元数据):次级的第二子类别的英文名称(如教育、字谜)
trade_representative_contact_information Metadata(元数据):包含商务代表的联系信息的hash(不懂
app_review_information Metadata(元数据):包含审核信息的hash
description Metadata(元数据):应用程序描述
name Metadata(元数据): 应用程序名字
subtitle Metadata(元数据): 应用程序副标题
keywords Metadata(元数据):一组关键字
promotional_text Metadata(元数据): 一段促销文字
release_notes Metadata(元数据): 本版本的版本说明
privacy_url Metadata(元数据):隐私的url
support_url Metadata(元数据): 支持的url
marketing_url Metadata(元数据): 营销url
languages Metadata(元数据):应用中使用的语言种类
ignore_language_directory_validation Metadata(元数据): 应用程序名字 false
subtitle Metadata(元数据): 应用程序副标题 true

* = 默认值依赖于用户的系统
有很多不懂的地方,毕竟我没有都用过,要是知道的朋友可以在底下告知下,谢谢各位朋友了

你可能感兴趣的:(fastlane工具 之 build_app和upload_to_app_store)