本篇将会带领小伙伴们,从零开始搭建自动化打包系统,步骤详细,本人踩过的坑已填平,只要耐心看完,相信你们一定有所收获的!!!
网上看到的自动化方案大概有三种:
Jinkens
fastlane(翻译过来:快车道)
shell脚本
对比了一下,Jinkens需要去注册,下载软件,而且有图形界面,这个有点不符合个人的理解,既然是要自动化,应该是无界面才会逼格比较高,pass;
shell脚本,这个是可行的,是可以接受的,
最后本人这边选择了,fastlane
,选择它,有以下原因:
- fastlane是开源的,无界面,安装比较方便
- Flutter官方文档,关于持续交付,自动化打包方案,有推荐了fastlane。既然Flutter团队都推荐这个,然后加上本人,刚好又是Flutter的重度使用者,所以选它,就没有错了!
安装fastlane
第一步:环境安装
安装fastlane,有多种途径,本人这边用Homebrew
来安装它,因为本人用的是MAC ,相信用过MAC的同学都会知道,一般MAC里面是会安装好了Homebrew这个第三方包管理软件
brew cask install fastlane
第二步:配置环境参数
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
同时点按cmd + shift + . 三个按钮,显示user级别下的隐藏文件,找到 .bash_profile进行编辑,完成后保存一下,重启一下终端,让其生效。
第三步:验证一下fastlane
打开Terminal 终端,
fastlane --version
如果能看到类似下面的结果,那么恭喜你,fastlane安装成功
项目中使用fastlane
第一步:进入iOS工程目录
打开Terminal cd 到iOS工程目录,如下图
第二步:初始化fastlane
fastlane init
终端里面让您选择,本人这边是选择了4;
然后就会看到生成fastlane
文件夹,并且里面有文件,如下:
然后,一路按几下,回车
第三步:编辑Fastfile
脚本文件
生成默认的文件,用文本打开如下:
暂时修改一下,(下面的脚本,如果复制过去,提示语法错误,一定要把里面的每一行,前后空格去掉,这些空格是肉眼看不到的
,一定要把里面的每一行,前后空格去掉,这些空格是肉眼看不到的
,一定要把里面的每一行,前后空格去掉,这些空格是肉眼看不到的
)
# This file contains the fastlane.tools configuration
# You can find the documentation at https://docs.fastlane.tools
#
# For a list of all available actions, check out
#
# https://docs.fastlane.tools/actions
#
# For a list of all available plugins, check out
#
# https://docs.fastlane.tools/plugins/available-plugins
#
# Uncomment the line if you want fastlane to automatically update itself
# update_fastlane
default_platform(:ios)
platform :ios do
desc "Description of what the lane does"
lane :smartowon do
# add actions here: https://docs.fastlane.tools/actions
gym(
# 每次打包之前clean一下
clean: true,
output_directory: './fastlane/release',
output_name: 'smartowon.ipa',
scheme: "Runner",
configuration: 'Release',
include_bitcode: false,
include_symbols: true,
export_method: 'app-store',
export_xcargs: '-allowProvisioningUpdates'
)
# mac上的通知弹窗,通知打包完毕
notification(app_icon: './fastlane/icon.png', title: 'manager', subtitle: '打包成功,已导出安装包', message: '准备发布中……')
# 配置上传到App Store connect的api_key
# 通过这种设置可以绕过二次认证等验证操作,实现一键打包上传
api_key = app_store_connect_api_key(
# 通过苹果申请的key id,申请同时会生成issuer_id和一个授p8权文件,就是以下参数,文件只能下载一次,注意保存,申请方式https://appleid.apple.com/account/manage中的专用密钥
key_id: 'J52H42C2FU',
issuer_id: '69a6de8d-d9d7-47e3-e053-5b8c7c11a4d1',
# 授权文件路径
key_filepath: './fastlane/AuthKey_J52H42C2FU.p8',
duration: 1200,
in_house: false
)
# 上传到testflight
upload_to_testflight(
# 上边设置的授权信息
api_key: api_key,
skip_waiting_for_build_processing: true,
# 打包好要上传的文件
ipa: './fastlane/release/smartowon.ipa',
skip_submission: true
)
# 通知上传成功
notification(app_icon:"icon.png",title:"LoanManager",subtitle: "IPA上传成功", message: "自动打包完成!")
end
end
第四步:修改里面的参数
clean: true,#每次打包之前clean一下
output_directory: './fastlane/release', # 打包出ipa文件路径,后边上传的时候也会用到
output_name: 'yourName.ipa',# 打包的名称,换成自己的
scheme: "yourproscheme",# 项目的scheme,换成自己的(
后面有详细介绍
)
configuration: 'Release',# 默认Release,Release or Debug
include_bitcode: true,# 是否包含bitcode
include_symbols: true,# 是否包含symbols
export_method: 'app-store',# 打包导出方式,包含app-store, validation, ad-hoc, package, enterprise, development, developer-id and mac-application
export_xcargs: '-allowProvisioningUpdates',# 这个设置是为了设置xcode自动配置证书和配置文件,当然也可以手动配置,可以参考文档
key_id: 'your key_id',# 通过苹果申请的key id,申请同时会生成issuer_id和一个授p8权文件,就是以下参数,文件只能下载一次,注意保存,申请方式https://appleid.apple.com/account/manage中的专用密钥(
后面有详细介绍
)
issuer_id: 'your issuer id',
key_filepath: './fastlane/AuthKey_yours.p8', # 授权文件路径(
后面有详细介绍
)
第五步:详细介绍其中的几个参数
-
scheme,很多可能不知道这个地方,应该填什么,那就如下图操作,就能找到scheme了
打开iOS工程,点击如下图的箭头地方,点击“Edit Scheme”
如下图的位置, 文本就是scheme
- key_id issuer_id ,这两个参数,需要登录https://appstoreconnect.apple.com/login,去生成
点击添加后,按提示框输入信息,生成成功,刷新一下浏览器
,就可以下载 API密钥 文件,如下图
这样key_id
,issuer_id
就有了,同时key_filepath
,要填写的文件也有了。
- key_filepath
点击下载,把.p8文件,放到工程目录文件下的fastlane文件夹下,如下图
到此为止,需要详细介绍的参数,全部完成。然后就是把上面生成的参数,修改一下Fastfile脚本。
第六步:最终Fastfile脚本文件
第七步:运行脚本,进行自动化打包
打开Terminal cd 到iOS工程目录
fastlane XXX
这个XXX,就是Fastfile文件里面,lane:后面的文字,如下图
不出意外的话,就会自动执行起来,其中有几个关键步骤
同时,mac上会收到通知
🎉🎉🎉 最后,全部流程完成
结尾
今天的分享至此接近尾声喽,小伴们,觉得有点用的话,或者已经看到这里面来的请点赞加关注吧~~ 后续分享更多iOS原生技术相关文章。如果有疑问的话,欢迎在下方留言~ 新年好运!!!!
补充
使用一段时间后体验,总体感觉还是很爽的,只需要第一次配置一下fastlane文件,后面每次使用就是执行一次命令,fastlane XXX;就可以轻松打包,上传。
遇到错误Communication error.please use diagnostic mode to check connectivity.you need to have outbound access to tcp port 443.
,
这个问题一般是网络造成的,本人电脑用了梯子的,关闭梯子(翻墙工具)就好了。