前言
在项目测试阶段,频繁的打包发布会耗费团队很多的时间。搭建一个自动化打包发布的平台,可以将我们从那些繁琐的打包发布流程中解放出来。
本文采用的方案是:Jenkins + Fastlane + GitLab + 蒲公英。
Fastlane安装
Fastlane是一套使用Ruby写的自动化工具集,用于iOS和Android的自动化打包、发布等工作,可以节省大量的时间。
安装过程如下:
1.检查Ruby版本,需要2.0及以上版本。在终端输入以下命令确认:
ruby -v
需要注意的是需要将gem的source改为[https://gems.ruby-china.org/]
(https://link.jianshu.com?t=https://gems.ruby-china.org/)。
如何检查?在终端输入以下命令:
gem sources
首先移除掉rubygems.org
gem sources --remove https://rubygems.org/
更换源
gem sources -a http://gems.ruby-china.org/
结果应为:
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
检查Xcode命令行工具是否安装。在终端输入以下命令:
xcode-select --install
如果没有安装会进行安装。如果已经安装了则会提示:
xcode-select: error: command line tools are already installed, use "Software Update" to install updates
接下来安装Fastlane
sudo gem install fastlane --verbose
如果出现以下错误:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/rougify
则输入以下命令:sudo gem install -n /usr/local/bin fastlane
因为系统自带的ruby权限不够,或者你可以选择用vim管理ruby
如果fastlane加载缓慢,请尝试运行
gem clean up
检查Fastlane是否正确安装。输入以下命令:
fastlane --version
fastlane installation at path:
/Library/Ruby/Gems/2.3.0/gems/fastlane-2.127.1/bin/fastlane
-----------------------------
[✔] 🚀
fastlane 2.127.1
我的版本是2.127.1
Fastlane配置
项目初始化
fastlane init
出现如下信息:
[✔] 🚀
[✔] Looking for iOS and Android projects in current directory...
[14:43:39]: Created new folder './fastlane'.
[14:43:39]: Detected an iOS/macOS project in the current directory: 'tztMobileApp_zxsc.xcworkspace'
[14:43:39]: -----------------------------
[14:43:39]: --- Welcome to fastlane 🚀 ---
[14:43:39]: -----------------------------
[14:43:39]: fastlane can help you with all kinds of automation for your mobile app
[14:43:39]: We recommend automating one task first, and then gradually automating more over time
[14:43:39]: 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个对其进行手动配置后进入:
[14:45:41]: ------------------------------------------------------------
[14:45:41]: --- Setting up fastlane so you can manually configure it ---
[14:45:41]: ------------------------------------------------------------
[14:45:41]: Installing dependencies for you...
[14:45:41]: $ bundle update
等待时间较长,安装成功如下:
[14:54:51]: To try your new fastlane setup, just enter and run
[14:54:51]: $ fastlane custom_lane
其他命令:
fastlane actions: 列出所有可用fastlane活动
fastlane action [action_name]: 显示一个更详细的活动描述
fastlane lanes: 列出所有可用lanes (有描述)
fastlane list: 列出所有可用lanes (没有描述)
fastlane new_action: 在fastlane创建一个活动(集成)
对fastlane 文件的认识:
现在对Appfile,Fastfile,Gemfile,Deliverfile文件说明如下:
Appfile: 存储有关开发者账号相关信息
Fastfile: 核心文件,用于命令行调用和处理具体的流程,lane相对于一个action方法或函数
Gemfile 类似于cocopods 的Podfile文件
.env 配置环境变量(在fastlane init进行初始化后并不会自动生成,如果需要可以自己创建
Deliverfile: deliver工具的配置文件,上传截图苹果和后台一些app信息 (默认不生成,需要sudo gem install deliver安装)然后在fastlane 目录下执行deliver init 即可)
要注意的点:
build_app命令等同于gym(别名)
deliver 命令相当于upload_to_app_store(别名)
蒲公英的Fastlane插件安装
找到项根目目录
cd /Users/lailin/Desktop/iOS
输入以下命令:
fastlane add_plugin pgyer
出现如图
[14:58:50]: Get started using a Gemfile for fastlane https://docs.fastlane.tools/getting-started/ios/setup/#use-a-gemfile
[14:59:51]: Seems like the plugin is not available on RubyGems, what do you want to do?
1. Git URL
2. Local Path
3. RubyGems.org ('fastlane-plugin-pgyer' seems to not be available there)
4. Other Gem Server
我们选择 3
出现
Plugin 'fastlane-plugin-pgyer' was added to './fastlane/Pluginfile'
[15:13:20]: It looks like fastlane plugins are not yet set up for this project.
[15:13:20]: fastlane will modify your existing Gemfile at path '/Users/ztqft/Downloads/code/lailin/Gemfile'
[15:13:20]: This change is necessary for fastlane plugins to work
[15:13:20]: Should fastlane modify the Gemfile at path
'/Users/ztqft/Downloads/code/lailin/Gemfile' for you? (y/n)
输入y按回车,等待。。。好一会
出现
plugin dependencies...
Successfully installed plugins
安装成功了
===============分隔符=======放大招=================
实现自动打包的完整Fastfile如下:
# This file contains the fastlane.tools configuration
# 定义fastlane版本号,换成你自己的fastlane版本号
fastlane_version "2.127.1"
# 定义打包平台
default_platform :ios
currentTime = Time.new.strftime("%Y%m%d%s")
#指定项目的scheme名称
scheme="tztMobileApp_zxsc"
#蒲公英api_key和user_key 换成你的
api_key="xed1c60d470c75d71ffffacdb3071db42"
user_key="x15f5e0516b3e9d5bf107c8b218e11938"
configuration="Debug"
platform :ios do #打包平台
desc "开发证书包——个人证书" #打包描述
lane :test_pgy do #打包方法
puts "开始打包development ipa"
# 开始打包
gym(
scheme: "#{scheme}", #项目名称
output_directory: "/Users/ztqft/Desktop", # 打包后的 ipa 文件存放的目录
configuration:"#{configuration}",
output_name: "#{scheme}_#{configuration}_#{currentTime}" # ipa文件名
)
puts "开始上传蒲公英"
# 开始上传蒲公英
pgyer(api_key: "#{api_key}", user_key: "#{user_key}")
end
end
在终端输入
注意:fastlane test_pgy
此处是打包的lane的名称一致才能调用 相当于一个action
fastlane test_pgy
便会进行自动打包并上传蒲公英了。
执行结果
QQ20190718-183209@2x.png
附上一个gif 6023080-c048df1f95dc4b7a.gif
接下来搞jekins安装(等待更新中。。。。。。)
(先参考这个链接) http://www.cocoachina.com/articles/17281
网友评论