【iOS】Fastlane一键打包上传到TestFlight、蒲公英

已于 2023-10-10 14:02:18 修改
阅读量1.9k 收藏 1
点赞数 3
分类专栏： 工具/环境 文章标签： ios
于 2023-10-09 14:10:35 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/moon_yzm/article/details/133694401
版权

Fastlane一键打包上传到TestFlight、蒲公英

前言

  • 废话不多说，能知道fastlane的，代表您已经对fastlane的用处有了初步了解，并且想使用在自己项目中，本文只适用于iOS项目的fastlane配置（Android端未验证），直接开始配置。

一、准备

  • Ruby环境，CocoaPods环境， 蒲公英官网
  • 打正式包上传testflight过程中需要输入密码，对于开启了双重认证的账户需要去 ，申请专属密码app专属密码申请
  • iOS开发必须要知道的基础开发环境配置，终端执行pod env
    在这里插入图片描述
  • 登录蒲公英，获取api_key，复制备用
    在这里插入图片描述

二、探索

一、Fastlane配置

1、Fastlane安装

  • 终端执行以下命令以安装Fastlane
    需要配置的安装：
sudo gem install fastlane
  • 快速安装：
sudo gem install fastlane -NV

执行完成后出现以下字样即为安装成功
在这里插入图片描述

2、Fastlane更新

以下两种终端更新Fastlane方式，使用一种即可：

  • 方式一：
bundle update fastlane
  • 方式二：
fastlane update_fastlane

3、Fastlane卸载

  • 终端执行以下命令来卸载Fastlane
sudo gem unstall fastlane

4、查看Fastlane版本

  • 执行以下命令查看Fastlane版本，以验证
fastlane --version

在这里插入图片描述

5、查看Fastlane位置

which fastlane

6、Fastlane初始化

  • 终端cd到项目工程根目录下，执行以下命令，来初始化fastlane
fastlane init
  • 项目工程里会创建出fastlane文件夹、Gemfile和Gemfile.lock
    在这里插入图片描述
  • 在fastlane init过程中有些需要输入开发者账号密码，后续可通过以下命令重新登录账号。
fastlane cert create

二、Fastlane安装蒲公英插件

  • 终端执行以下命令来安装蒲公英插件
fastlane add_plugin pgyer
  • 执行过程中出现以下内容，是为了在Gemfile文件里面写入Pluginfile内容，输入y按回车
Plugin 'fastlane-plugin-pgyer' was added to './fastlane/Pluginfile'
[10:08:29]: It looks like fastlane plugins are not yet set up for this project.
[10:08:29]: fastlane will modify your existing Gemfile at path 'Gemfile'
[10:08:29]: This change is necessary for fastlane plugins to work
[10:08:29]: Should fastlane modify the Gemfile at path 'Gemfile' for you? (y/n)
  • 出现以下内容即为安装蒲公英插件成功
    在这里插入图片描述

三、Fastlane文件编辑

1、Gemfile文件

一般安装好蒲公英插件和fastlane初始化后会默认生成

source "https://rubygems.org"

gem "fastlane"

gem "cocoapods"

plugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile')
eval_gemfile(plugins_path) if File.exist?(plugins_path)

2、Appfile文件

一般安装好蒲公英插件和fastlane初始化后会默认生成，可以按需求修改，个人的Apple ID方便接收AppStore上传及审核信息

app_identifier("com.xxx.xxx") #app的bundleID 
apple_id("xxx@xxx.com") #个人的Apple ID,邮箱

itc_team_id("xxxxxx") #App Store的团队ID App Store Connect Team ID
team_id("xxxxxx") #团队ID Developer Portal Team ID
branch ENV['xxxxxx'] #分支
# For more information about the Appfile, see:
#     https://docs.fastlane.tools/advanced/#appfile

3、Fastfile文件

Fastfile文件为核心配置文件，需要编辑打包流程到信息，每一个功能块由 ==lane: xxx do ==开头 end 结尾

1、递增build号

定义一个递增build号的函数，添加到Fastfile中

def updateProjectBuildNumber

currentTime = Time.new.strftime("%Y%m%d")
build = get_build_number()
if build.include?"#{currentTime}."
	# => 为当天版本 计算迭代版本号
	lastStr = build[build.length-2..build.length-1]
	lastNum = lastStr.to_i
	lastNum = lastNum + 1
	lastStr = lastNum.to_s
	if lastNum < 10
		lastStr = lastStr.insert(0,"0")
	end
	build = "#{currentTime}.#{lastStr}"
else
	# => 非当天版本 build 号重置
	build = "#{currentTime}.01"
end
puts("*************| 更新build #{build} |*************")
# => 更改项目 build 号
increment_build_number(
build_number: "#{build}"
)
end
2、任务配置
  • 以下为任务配置信息仅供参考（请切换为属于你的专属信息）：
#fastlane版本号
fastlane_version "2.216.0"
#打包平台
default_platform :ios

#指定项目的scheme名称 ---- 修改
scheme="xxx"
#蒲公英api_key和user_key ---- 修改
api_key="xxx"
user_key="xxx"

# 任务脚本
platform :ios do
  desc "以 development 方式打包并上传到蒲公英"
  lane :test_beta do
    puts "以 development 方式打包"
    gym(
      # 指定打包所使用的输出方式 (可选: app-store, package, ad-hoc, enterprise, development)
      export_method: "development",
      # 指定项目的 scheme 名称
      scheme: "xxx",
      # 指定输出的文件夹地址
      output_directory: "./archive/test_beta/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
    )
    puts "上传 ipa 包到蒲公英"
    pgyer(
      # 蒲公英 API KEY
      api_key: "xxx",
      # 蒲公英 USER KEY
      user_key: "xxx"
    )
  end
  desc "以 ad-hoc 方式打包并上传到蒲公英"
  lane :beta do
    puts "自动生成 Provisioning Profiles 文件"
    sigh(
      # 指定输出的文件夹地址
      output_path: "./archive/sign",
      # 是否为 AdHoc 证书（设为 false 或不写默认为 AppStore 证书）
      adhoc: true
    )
    puts "以 ad-hoc 方式打包"
    gym(
      # 指定打包所使用的输出方式 (可选: app-store, package, ad-hoc, enterprise, development)
      export_method: "ad-hoc",
      # 指定项目的 scheme 名称
      scheme: "xxx",
      # 指定输出的文件夹地址
      output_directory: "./archive/beta/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
      # 指定打包方式 (可选: Release, Debug)
      configuration: "Release"
    )
    puts "上传 ipa 包到蒲公英"
    pgyer(
      # 蒲公英 API KEY
      api_key: "xxx",
      # 蒲公英 USER KEY
      user_key: "xxx"
    )
  end
  desc "以 app-store 方式打包并上传到 iTunes Connect"
  lane :release do
    puts "自动生成 Provisioning Profiles 文件"
    sigh(
      # 指定输出的文件夹地址
      output_path: "./archive/sign"
    )
    puts "以 app-store 方式打包"
    gym(
      # 指定打包所使用的输出方式 (可选: app-store, package, ad-hoc, enterprise, development)
      export_method: "app-store",
      # 指定项目的 scheme 名称
      scheme: "xxx",
      # 指定输出的文件夹地址
      output_directory: "./archive/release/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
      # 指定打包方式 (可选: Release, Debug)
      configuration: "Release"
    )
    puts "上传 ipa 包到 iTunes Connect"
    deliver(
      # 跳过截图上传
      skip_screenshots: true,
      # 跳过元数据上传
      skip_metadata: true,
      # 跳过审核直接上传
      force: true
    )
  end
end

以上配置完成就可以在本地终端进行打包了，

  • export_method是在Fastlane工具中使用的命令，指定导出iOS应用存档的方法，以及可用的配置文件和签名证书。
    以下是几种导出存档方法：
    • app-store：提交到应用商店的存档
    • development：用于开发目的的存档
    • ad-hoc：用于分发给有权限的设备或用户的存档
    • enterprise：公司内部网络分发的存档
  • configuration构建方式：分Release和Debug
  • scheme：
    在这里插入图片描述
  • output_directory：输出文件夹地址
  • desc、puts：信息描述

打开终端进入到项目fastlane文件夹上一级，输入以下命令即可打一个以 development 方式打包并上传到蒲公英的包。

fastlane test_beta

4、Pluginfile文件

一般安装好蒲公英插件后会默认生成

# Autogenerated by fastlane
#
# Ensure this file is checked in to source control!

gem 'fastlane-plugin-pgyer'

四、项目工程配置Fastlane

1、递增版本号配置
  • 修改Build Settings中的Versioning配置，Current Project Version随便填一个，Versioning System选择Apple Generic
    在这里插入图片描述
2、修改info.plist File路径

把项目工程中所有的info.plist文件的路径中带有SRCROOT的路径全部改成相对路径，要不然会报错。

在这里插入图片描述

五、Fastlane执行

做 fastlane 命令的时候都是在项目的根目录下进行的，打开终端进入到项目fastlane文件夹上一级。

  • 1，获取到所有的 lane
fastlane lanes

2、账号权限

  • 1，Adding a Credential(添加凭证)
    //输入命令：
fastlane fastlane-credentials add --username felix@krausefx.com

//会自动要求输入密码：App-Specific Passwords
Password: *********(这里就是要输入刚刚生成的App-Specific Passwords)

如果手动输入错误：请执行以下命令：删除账号，再重复添加凭证，完成添加

  • 2，Removing a Credential(移除凭证)
fastlane fastlane-credentials remove --username felix@krausefx.com

//password has been deleted.

三、总结

工具的使用没有什么技术含量，想研究fastlane代码可参考github

四、常见问题归纳

  • 1，账号权限问题，重复一下上面账号权限模块，移除凭证，添加凭证的命令步骤
[!] Error uploading ipa file:
 [Application Loader Error Output]: Error uploading '/var/folders/sp/_4jyc68d0hvbm70nm50ljvvw0000gp/T/3a982536-cad1-483e-8b64-5c74740a168f.ipa'.
[Application Loader Error Output]: Unable to upload archive. Failed to get authorization for username 'xxx@126.com' and password. (
[Application Loader Error Output]: The call to the altool completed with a non-zero exit status: 1. This indicates a failure.
☆MOON
关注
专栏目录
使用fastlane框架全自动化打包IOS
09-19 745
作为公司的iOS程序员，少不了在发布应用的时候各种等待。标准的手动发布流程是：编译->打包上传->填写应用更新数据->等待iTunesConnect编译->选择版本发布，整个过程大概需要30分钟左右。关键是这个过程就像windows装系统一样，虽然手工参与的不多，但是要一直守在电脑前等着。程序员这么懒，一定会想办法让他自动化的。后来发现特别懒的Felix Krause写的Fastlane，Fastlane可以非常快速简单的搭建一个自动化发布服务，并且支持Android，iOS，MacOS。
Jenkins+Fastlane iOS自动化打包上传到蒲公英和App Store完整版
william66688的博客
05-26 2147
采用 Jenkins+Fastlane 实现 iOS自动化打包上传到蒲公英和AppStore，并且企业微信机器人通知下载地址
iOS使用fastlane一键打包审核
iOS_开发
03-10 507
点击上方“iOS开发”，选择“置顶公众号”关键时刻，第一时间送达！毋庸置疑，Jenkins对我们打包的帮助还是很大的——被测试的同学追着要IPA包的日子终于一去不复返了。但作为追求效率的开发我们仅仅满足于此就可以了吗，想想我们iOS开发遇到的其他诸多类似的问题吧团队成员一不小心Revoke了证书导致所有的开发小伙伴需要重新下载证书，每次提交App Store审核需要重复【修改证书】- 【打包】-【
Fastlane 使用教程
最新发布
gitblog_01109的博客
08-13 468
Fastlane 使用教程 fastlane???? The easiest way to automate building and releasing your iOS and Android apps项目地址:https://gitcode.com/gh_mirrors/fa/fastlane 项目介绍 Fastlane 是一个开源平台，旨在简化 Android 和 iOS 应用的部署流程。它通...
iOS使用Fastlane自动打包上传到蒲公英
liuxinzhongliubin的博客
04-03 1123
当你看到安卓同事通过gradle进行自动打包的时候是不是非常羡慕。别着急iOS也有一键打包的工具，这里强烈推荐fastlane。Fastlane 是一个用于自动化构建、测试和部署移动应用的工具集，它提供了一系列丰富的命令行工具和库，可以帮助开发人员简化和加速 iOS 和 Android 应用的开发流程。fastlane一键打包真的好用，运行命令后我们就可以做别的啦，不用像手动打包一样要一步步操作。并且android端也可以用fastlane。fastlane的强大也远不止打包，其他功能大家可以自己去探索。
iOS Fastlane一键自动化打包
weixin_38201792的博客
04-25 455
缺点:● 多次的环境配置选择,容易出错● 等待后需要二次手动上传,较为麻烦● ipa包容易有传错的可能。
iOS-Fastlane从0到1配置自动打包
u010707262的博客
02-28 896
项目进入测试阶段，频繁的打包发布会耗费团队很多的时间，急需搭建一个自动化打包发布的平台，将我们从繁琐的打包发布流程中解放出来。 经调研，Fastlane可以实现一行命令实现打包工作，不需要时时等待操作下一步，节省打包的时间去做其他的事。 Fastlan安装步骤 fastlane前置准备工作： ① 安装xcode，且安装了Xcode命令行工具； allison@bogon Desktop % xco...
ios-fastlane ---自动打包.zip
07-11
详细的操作流程Git网址： https://github.com/daniulaolu/Fastlane--Packaging
iOS fastlane自动化打包上传至蒲公英
xu_yu_jie的博客
01-30 631
前言 Fastlane 是一款为 iOS 和 Android 开发者提供的自动化构建工具，它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来，实现完全自动化的工作流，如果使用得当，可以显著的提高开发者的开发效率。 前置条件 安装fastlane之前，我们得安装ruby，因为fastlane使用ruby语言写的， 安装ruby前，我们要先安装...
fastlane build 版本号自增
CSDN博客
05-26 1192
前言 有时候一天需要打好几个包，为了区分，我这里实现一个递增 build 号的功能。 1. 配置Xcode 项目工程 修改 Build Settings 中的 Versioning 配置 ，Versioning System 选择 Apple Generic。 2. 编辑 Fastfile 文件 2.1 定义一个递增 build 号的函数，添加到 Fastfile 中 build 自增函数 def updateProjectBuildNumber currentTime = Time.new.strft
Ruby-fastlane快车道Fastfile脚本gym文件编写套用自动打包ipa上传蒲公英AppStore
08-15
本篇文章将深入探讨如何利用`fastlane`中的`Fastfile`脚本和`gym`命令来实现自动打包IPA文件，并将其上传至蒲公英或App Store。 首先，我们来理解`Fastfile`。`Fastfile`是`fastlane`的核心，它是一个Ruby脚本，...
使用Fastlane对iOS项目持续集成（自动打包）
iOS_开发
07-09 589
点击上方“iOS开发”，选择“置顶公众号”关键时刻，第一时间送达！前言作为一名iOS app开发者，在我的工作过程中，基本遵循如下的一个流程：分析需求、UI设计——&gt...
iOS 使用 Fastlane 在 Github 上部署 CI/CD 自动化打包并发布到 Testflight。
u014507917的博客
06-05 997
P12文件相关证书UUID在 GitHub 中启用 workflows 并在 settings 中配置相关密钥。到此准备工作已完成。
fastlane自动打包--详细介绍
weixin_33895695的博客
03-27 389
fastlane--Packaging 自动化打包，通过fastlane自动发布 Fastlane安装不在这里详细罗列，参照一下链接流程 https://www.jianshu.com/p/0a113f754c09 操作步骤 1.检查Fastlane是否正确安装。输入以下命令： fastlane --version 复制代码可以看到Fastlane版本信息，我的是fastlane 2.84...
通过fastlane打包上传到appstore
Dayer的博客
12-21 1498
通过fastlane打包上传到appstore
IOS神器-fastlane工具实战-IOS自动化接入应用
constant_rain的博客
08-13 1208
fastlane 是什么 一套使用Ruby写的自动化工具集，旨在简化Android和iOS的部署过程，自动化你的工作流。它可以简化一些乏味、单调、重复的工作，像截图、代码签名以及发布App fastlane 可以干什么 gym：是fastlane提供的打包工具。 snapshot： 生成多个设备的截图文件 frameit ：对截图加一层物理边框 increment_build_number：自增build number 然后与之对应的get_build_number。Version number同理。 ce
iOS fastlane 自动打包，上传蒲公英
CSDN博客
05-25 1477
前言 本篇将会带领大家从零开始搭建自动化打包系统，步骤详细，本人踩过的坑已填平，只要耐心看完，你也能搞定！！！ 网上看到的自动化方案大概有三种： Jinkens shell 脚本 fastlane 对比了一下，Jinkens 需要去注册，下载软件，而且有图形界面，但是我没搞成功 shell 脚本，这个是可行的，是可以接受的，理由同上 最后本人这边选择了，fastlane，选择它，有以下原因： 1、fastlane 是开源的，无界面，安装比较简单、方便 2、最最主要的事我测试成功通过了 3、上面两个的话，后
iOS Fastlane
God383045的博客
03-03 262
问题 天天打包，即便面对的是肤白貌美小姐姐，终有安装识别别烦我的苦恼以及事到一半打个包的郁闷， 咋整？ Fastlane吧！ 思路 1.xcode-select安装，确定安装了最新版本 xcode-select --install 2.安装fastlane, 单独安装，去掉sudo; 使用系统自带的ruby，需要sudo权限 sudo gem install fastlane 3.项目根目录，初始化fastlane fastlane init // 命令行 // 执行效果 [13:54:52..
fastlane实现自动化打包
岑志军的个人博客
04-26 788
正常产品开发完成之后，我们都需要给测试人员打包，又是测试包，又是生产包的，打一次包需要浪费十几分钟的时间，甚至有时候，你刚打完包，产品过来告诉你某个地方需要微调一下（麻蛋，这个时候是不是想弄死他），但是没办法，只好改完bug，继续打包，就这样可能一上午或者一下午就这样浪费了，所以有一个能够自动化打包的工具不仅能够为我们节省大量的时间，还可以让我们能够装逼。。。。。（这是重点） 其实自动化...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

☆MOON

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值