一、初始化Fastlane
1.首先,打开终端窗口,cd 到项目目录。进入项目文件夹之后,输入下列命令
fastlane init
# 注意:如果你看到一个 “permission denied” 错误,你可能要在命令前加上 sudo。
几分钟之后,fastlane 会通过询问下列问题(应该是英文,我帮你翻译了),引导你完成设置过程:
请输入 App Identifier (com.krausefx.app):
请输入一个唯一的 app ID。请记住这个 ID,因为后面你还会用到它! 你的 Apple ID (fastlane@krausefx.com):
请输入你的 Apple ID 是否创建 deliver 命令,即上传 app 屏幕截图、app 元数据和 app 更新到 App 商店或者苹果的 TestFlight?(y/n)
输入 n 是否创建 snapshot 命令,它会自动获取 app 在所有语言和设备类型上的屏幕截图?(y/n)
输入 y 是否使用 sigh 命令,它会维护和下载 app 的 provisioning profile?(y/n)
输入 y 可选项:app 的 scheme 名称:(如果不需要,直接回车)
安装完成之后,你会发现多了一个 fastlane 文件夹,里面内容如下:
其中:
Appfile, 用于存放 app ID 和你的 Apple ID。 Fastfile, 用于管理你所创建的 lane,lane 则会调用 action。
恭喜你!你现在可以使用 fastlane 了。
二、打包ipa
1.创建并编写脚本
vim build_using_gym.sh
2.复制如下代码到build_using_gym.sh文件中,修改项目名称后保存
#!/bin/bash
#计时
SECONDS=0
#假设脚本放置在与项目相同的路径下
project_path=$(pwd)
#取当前时间字符串添加到文件结尾
now=$(date+"%Y_%m_%d_%H_%M_%S")
#指定项目的scheme名称
scheme="项目名称"
#指定要打包的配置名
configuration="Adhoc"
#指定打包所使用的输出方式,目前支持app-store, package, ad-hoc, enterprise, development, 和developer-id,即xcodebuild的method参数
export_method='ad-hoc'
#指定项目地址
workspace_path="$project_path/项目名称.xcworkspace"
#指定输出路径
output_path="project_path/APP"
#指定输出归档文件地址
archive_path="$output_path/项目名称_${now}.xcarchive"
#指定输出ipa地址
ipa_path="$output_path/项目名称_${now}.ipa"
#指定输出ipa名称
ipa_name="项目名称_${now}.ipa"
#获取执行命令时的commit message
commit_msg="$1"
#输出设定的变量值
echo"===workspace path: ${workspace_path}==="
echo"===archive path: ${archive_path}==="
echo"===ipa path: ${ipa_path}==="
echo"===export method: ${export_method}==="
echo"===commit msg: $1==="
#先清空前一次build
gym--workspace ${workspace_path}--scheme ${scheme}--clean--configuration ${configuration}--archive_path ${archive_path}--export_method ${export_method}--output_directory ${output_path}--output_name ${ipa_name}
#上传到fir 如果不想上传就注释掉
fir publish ${ipa_path}-T fir_token-c"${commit_msg}"
#输出总用时
echo"===Finished. Total time: ${SECONDS}s==="
3.为脚本添加执行权限
chmod +x build_using_gym.sh
4.运行build_using_gym.sh脚本
./build_using_gym.sh
5.打包完成,success!
项目根路径下APP文件夹
三、生成证书和 Provisioning Profile
在任意文本编辑器(推荐使用Xcode)中打开 Fastfile 文件,将内容替换为:
# Minimum version of fastlane
fastlane_version"1.104.0" #注意要换成你的fastlane版本
default_platform :ios
platform :ios do
#1
desc"Creating a code signing certificate and provisioning profile"
#2
lane :provision do
#3
produce(
app_name: 'ENTER_A_UNIQUE_APP_NAME_HERE', #换成你的APP name
language: 'English', #可以换语音
app_version: '1.0', #APP版本
sku: '123abc' #sku换成你自己的
)
#4
cert
#5
sigh(force: true)
end
error do |lane, exception|
# This block is called,if there was an error running a specific lane.
end
end
注意几点:
将 ENTER_A_UNIQUE_APP_NAME_HERE 替换成一个唯一的 App 名字
用于描述这个 lane 的工作。一个 lane 是一个按顺序执行的工作流。 执行名为 provision 的 lane。 produce 用指定的 ID、name、语言和版本号创建一个可用于 iTunes Connect 和 Developer Portal 的 app。 cert 创建一个新的私钥和签名请求,下载、安装生成的证书并导入到钥匙串。 sigh 创建了一个 provisioning profile。force 参数为 true,则每次运行时都会创建新的 provisioning profile,这样就可以保证每次都使用正确的代码签名证书。
注意:sigh 默认创建的是 App Store 的发布 profile。如果你想创建 ad hoc profile,你需要使用 sigh(adhoc:true)。如果是开发 profile 则使用 sigh(development:true)。为简单起见,在本文中你只需要创建 distribution profile。
你现在创建了第一个 lane。保存文件,打开终端进入到项目文件夹,输入命令:
fastlane provision
大约一分钟左右,fastlane 会问你 iTunes Connect 密码,它会保存到你的 Mac 的钥匙串里。输入密码,如果执行成功,你的终端窗口会显示success(忘了截图了...)
注意:如果你看到错误,例如 “Creation of apps of this type is not available”, 则请登录你的 iTunes Connect,看一下是否有某些更新的协议需要你确认。
在进行下一步之前,你还需要在 Xcode 中进行某些修改。打开 XXXX.xcodeproj,选择 XXXX Target,切换到 General 页。将 bundle identifier 修改为初始化 fastlane 时输入的 App ID。
在 Build Settings > Code Signing > Provisioning Profile 设为 “ <new APP> AppStore”。然后在 Code Signing Identity 选择和这个 provisioning profile 相对应的 ID:
注意,code signing identity 应该和 provisioning profile 中的 identities 相匹配。这样,当 gym 编译 IPA 文件时会使用新创建的 provisioning profile。
四、登录iTunes Connect查看新建APP
登录进 iTunes Connect !你的 app 已经创建好了,nice!
只需要一条命令,你就在 iTunes Connect 和 Dev Portal 中创建了一个 app 和一个 provisioning profile。简直很爽嘛。
PS:你的开发者账号必须是付费的。或者加入了开发组,并且开通了iTunes Connect管理员权限才可以使用Fastlane。
那么初级使用篇就先介绍到这里了。待我再深入了解下,再更新Fastlane的更多用法。
Fastlane有非常多的功能,今后会尽量多的发掘出来,供大家使用~