iOS 自动化发布 Fastlane 本地构建 IPA 并分发

时间  2019-11-21
标签 ios 自动化 发布 fastlane 本地 构建 ipa 分发 栏目 iOS 繁體版
原文   原文链接

此篇文章相关代码已经上传至 GitHub，相关代码请移步 build_ios_appios

iOS 自动化发布测试包到 fir.im，以及自动打包上传 AppStore 并提交审核...

公司项目都是在 Jenkins 上部署的，打包分发一键完成，可有时候 Jenkins 出问题，这就很差玩了，要排查问题仍是挺费劲的，各类问题(公司产品线比较多，各个产品使用的 Xcode 版本不一致，有的是自动签名，有的须要 profile，打包成功但上传失败)，总之，最后的结果都是failure。git

尽管测试已经掌握打包秘籍，再也不须要麻烦开发，但鉴于这种失败failure状况下，测试人员，跑过来仍是会打扰开发的，还有就是另外一种状况，开发人员已经解决了这个（多个）问题以后，想当即让测试验证，这个时候，就须要在终端terminal敲上一段代码./fastlane/build_app.sh，喝口水，去趟卫生间，搞定~github

废话很少说~shell

环境配置

官网安装 有两种方式 gem，brewswift

首先必须确认已经安装xcode命令行工具，若是没有，使用如下命令xcode

xcode-select --installruby

接下来，就是安装*fastlane*，使用下面的命令bash

[sudo] gem install fastlane -NVapp

或者使用homebrew，我的推荐使用iphone

brew cask install fastlane

设置 fastlane，体验自动化打包上传 App Store

在你的工程目录下，切记必定是和 *.xcodeproj 同级目录下， ruby 使用 fastlane init swift 使用 fastlane init swift

接下来会让你选择须要的功能模板

1. 📸  Automate screenshots 自动截屏
2. 👩‍✈️  Automate beta distribution to TestFlight 自动分发beta至TestFlight
3. 🚀  Automate App Store distribution 自动上传IPA到App Store
4. 🛠  Manual setup - manually setup your project to automate your tasks 不使用模板，本身去写自动打包脚本
复制代码

笔者先使用第三个模板 ，接下来也是选择，就直接最后结果吧，完成后，以下面的文件结构

直接使用命令fastlane release，接下来会自动打包，若是项目工程配置没有问题，就成功了

ok~ 使用模板固然不能知足个人需求的

本文的重点

  • 对 Xcode 项目，编写一个脚本实现自动打包 ipa 文件
  • 上传到 fir.im，以供测试人员下载安装
  • 上传 itunesconnect 提交审核

1. 准备工做

前面咱们xcode-select和fastlane这两个工具都已经安装完成，接下来还须要安装 fir-cli

gem install fir-cli

安装完成后，咱们开始编写脚本，这里须要注意的是，本脚本是基于fastlane、fir-cli，来完成任务的

fastlane 自己自带打包ipa、上传App Store提交审核、上传 fir-cli这个主要是将fastlane打包的测试ipa，上传到fir.im供测试下载安装

2. 脚本编写

这个 fastlane 文件夹是在执行 fastlane init 后自动生成的，做者在此基础上进行修改，其中 build_app.sh、republish.sh、appstore.env、common.env、dev.env 这几个文件是笔者本身添加的

└── fastlane
    ├── Appfile           // Appfile用来存放app_identifier，apple_id和team_id
    ├── Deliverfile       // 配置应用在 ITC 中的各类信息,和 ICC 中的数据是一一对应的
    ├── Fastfile          // fastlane 所执行的任务lane文件（核心）
    ├── Gymfile           // fastlane 编译打包ipa的配置文件
    ├── README.md
    ├── appstore.env      // 上传至App Store的环境配置文件
    ├── build_app.sh      // 脚本执行命令 ./build_app.sh
    ├── common.env        // 通用环境配置文件
    ├── dev.env           // 编译测试版本ipa的环境配置文件
    ├── ipa_build         // ipa输出文件夹（自动生成）
            └──// 编译好的ipa文件
    ├── metadata          // 执行fastlane deliver init 后自动从itunseconnet上获取
            └──// 提交App Store审核的一些元数据信息，包含应用在 ITC 中的各类信息
    ├── report.xml
    ├── republish.sh      // 针对于build_app.sh上传fir.im失败状况，再次上传ipa至fir.im
    └── screenshots       // 执行fastlane deliver init 后自动从itunseconnet上获取
            └──// 提交App Store审核的app宣传截图数据
复制代码

下面咱们来讲说这几个文件里面的内容 代码已经上传至 GitHub，若是使用请移步 build_ios_app，若是觉着对你帮助，那就顺手给个 star 吧😄

Appfile

Appfile 用来存放 app_identifier，apple_id 和 team_id，这个文件按照你的 app 信息配置很久没问题

app_identifier "com.xxx.xxx" # app的bundle identifier
apple_id "xxx@xxx.com" # 你的Apple ID
 
itc_team_id "XXXXXXXXXX" # iTunes Connect Team ID
team_id "XXXXXXXXXX" # Team ID
···
复制代码

Fastfile

配置管理 lane 任务

#默认使用平台是 ios，也就是说文件能够定义多个平台
default_platform(:ios)

platform :ios do
	before_all do
		# 设置代码签名：自动
		enable_automatic_code_signing
		# 跟新构建版本号
		increment_build_number(
			build_number: ENV["build_number"]
		)
	end

	desc "build a test App "
	lane :beta do
		 # 调用 gym 打测试包
		 gym(
		 	configuration:"Debug",
		 	export_method:"development"
		 )
	end

	desc "build a release App "
	lane :release do

	 # 调用 gym 打发布包
	 gym(
	 	configuration:"Release",
	 	export_method:"app-store"
	 	)

	 # 上传至 iTunes Connect
	 deliver(
        #注意：submit_for_review这个true是提交审核，false不提交
	 	# skip_binary_upload: true,
	 	submit_for_review: true,
	 	)
	end
	
	after_all do |lane|
	end

	error do |lane, exception|
	end
end
复制代码

Gymfile

Gymfile 配置打包 ipa 信息，详细更多参数列表参照 gym/parameters

scheme("xxx")
sdk("iphoneos")  
output_name("xxx.ipa") 
output_directory("./fastlane/ipa_build")
clean(true) 
include_bitcode(false) 
include_symbols(true) 
export_xcargs("allowProvisioningUpdates") 
复制代码

Deliver

Deliverfile 配置上传 ITC 信息，上传下载元数据信息，上传二进制 ipa 以及提交审核，详细更多参照 deliver/parameters

Deliver能够彻底管理与iTC的交互。其中包括：

上传和下载多语言截图 上传和下载多语言元数据 上传二进制文件

PS：

  • 若是Deliverfile文件，screenshots和metadata目录没被建立，能够运行deliver init来建立；
  • 若是你不想修改metadata某些项的信息，直接把对应的文件删除便可，或者删除整个目录，将须要修改的内容放在Deliverfile；
  • 若是不想更改截图，能够把整个截图目录删除；
  • 若是Deliverfile内配置了screenshots和metadata相关信息，则会忽略掉screenshots和metadata目录下对应的信息；
  • 全部这些表单项也能够在Deliverfile中指定，Deliverfile中指定的项优先级比文件高
# 若是选择提交审核，请认真对照如下参数选项，根据自家App实际状况配置，若是配置错误，将不能提交成功
submission_information({
export_compliance_available_on_french_store: false,
export_compliance_contains_proprietary_cryptography: false,
export_compliance_contains_third_party_cryptography: false,
export_compliance_is_exempt: false,
export_compliance_uses_encryption: false,
export_compliance_app_type: nil,
export_compliance_encryption_updated: false,
export_compliance_compliance_required: false,
export_compliance_platform: "ios",
content_rights_contains_third_party_content: false,
content_rights_has_rights: false,
add_id_info_limits_tracking: true,
add_id_info_serves_ads: true,
add_id_info_tracks_action: false,
add_id_info_tracks_install: false,
add_id_info_uses_idfa: true
});
复制代码

shell脚本

  • build_app.sh 自动化构建分发的命令执行文件
  • republish.sh 上传fir.im失败状况，再次上传ipa至fir.im命令
  • common.env 脚本通用环境变量配置文件
  • appstore.env 上传至App Store的环境配置文件
  • dev.env 编译测试版本ipa的环境配置文件

build_app.sh

#!/bin/bash 
### 参数传递
## $1 : beta=开发测试包, release=App Store 发版
## 若是未指定参数，缺省为开发测试包

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

## 环境初始化
if [ -z $1 ]; then
	AppENV="beta"
else
	AppENV=$1
fi

## 进入当前.sh所在目录
cd `dirname $0`

# 导入.env文件
if [ $AppENV == "beta" ]; then
	source ./common.env
	# source ./dev.env
else
	source ./common.env
	# source ./appstore.env
fi

# 删除以前的IPA
rm -r ${app_ipa_file}

# 打包APP
build_app() { 
	echo "+-------------------+-------------------+"
	echo " building... <${AppENV}> ipa"
	echo "+-------------------+-------------------+"
	echo " build number | ${build_number}"
	echo " ipa file | ${app_ipa_file}"
	echo "+-------------------+-------------------+"

	fastlane ${AppENV}
}

# 上传到fir.im
publish_to_firim(){ 
	echo "+---------------------+------------------+"
	echo " 上传测试包到 fir.im"
	echo "+---------------------+------------------+"
	echo " ipa file | ${app_ipa_file}"
	echo "+---------------------+------------------+"

	fir login $firim_token
	# fir publish $app_ipa_file --changelog=${git_changelog_file} --short=${firim_short} --qrcode
	fir publish $app_ipa_file  --short=${firim_short} --qrcode
}

if [ $AppENV == "beta" ]; then
	build_app
	publish_to_firim
	open $app_ipa_qrfile
else
	build_app
fi
复制代码

build_app.sh

#!/bin/bash 
### fir.im 上传失败后 执行

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

## 进入当前.sh所在目录
cd `dirname $0`

# 导入.env文件
source ./common.env
source ./dev.env

echo "+---------------------+------------------+"
echo " 从新上传测试包到 fir.im"
echo "+---------------------+------------------+"
echo " ipa file | ${app_ipa_file}"
echo "+---------------------+------------------+"

fir login $firim_token
fir publish $app_ipa_file  --short=${firim_short} --qrcode
复制代码

common.env

### 通用环境变量
### 能够根据项目实际状况进行修改

# Git 修订记录日志文件
git_changelog_file="./change_log.txt"

# 以日期+时间做为构建版本号，最终格式为: 月份日期小时分钟，所有均为两位数字，如 12 月 18 日 17:30 打包，则会是 12181730。
export build_number=`date +%m%d%H%M`

# 测试包托管平台的 TOKEN，为 fir.im 
firim_token="xxxx" 

# firim 专用的短网址中的短码
# 设置此短码将帮助更好的记测试包二维码网址
firim_short="firim_short"

# 打出的 IPA 包文件保存路径
app_ipa_file="ipa_build/xxx.ipa"
# 打出的 IPA 包二维码路径
app_ipa_qrfile="ipa_build/fir-xxx.png"
复制代码

appstore.env

### 特定环境变量
### 能够根据项目实际状况进行修改

# Provisioning Profile 文件名称
# 若是开发者账户里有多个项目，则须要指定。
# 开发者账户里仅有一个项目，则能够为空，sigh 会自动匹配。
app_profilename=""

# 指定是否为开发/测试 Provisioning Profile
# 若是打包发布到 App Store，则须要为空。
app_profiledev=""
复制代码

dev.env

### 特定环境变量
### 能够根据项目实际状况进行修改

# Provisioning Profile 文件名称
# 若是开发者账户里有多个项目，则须要指定。
# 开发者账户里仅有一个项目，则能够为空，sigh 会自动匹配。
app_profilename="xxx_development"

# 指定是否为开发/测试 Provisioning Profile
# 若是打包发布到 App Store，则须要为空。
app_profiledev="--development"
复制代码

以上是全部的代码，使用也是很简单，下载 代码，将fastlane文件拖入工程根目录下，根据本身实际状况，配置好相关信息，而后在 根目录 下终端上执行命令：

构建分发测试包

./fastlane/build_app.sh

若是第一次上传fir.im失败，尝试如下命令

./fastlane/republish.sh

打包上传AppStore

./fastlane/republish.sh release

以上是本次分享的全部内容，若是有疑问，请在下面留言，看到后，我会第一时间回复，若是文章中有不正确的地方，请指出来，我会及时更正~

代码已经上传至GitHub，若是使用请移步build_ios_app，若是觉着对你帮助，那就顺手给个star吧😄

Refer

最后：谢谢你愿意花费时间来阅读此篇文章~，但愿会对你有所帮助！

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程