开篇
每次新版本开始提交测试上传fir.im托管平台,或者提交AppStore的时候,都免不了一套打包操作, 时间短还好说,时间一长好伤心,还不能走开,还要进行一下操作,真麻烦,心好累啊!
所以,整理出了一个可以自动打包ipa文件,并且能够自动上传到fir.im的shell脚本。 自动打包时间去愉快的喝杯咖啡吧。。。 😝 😝 😝
准备
- 了解知识
官方文档 Workspace、Project、Scheme、Target 了解
Xcode打包原理: 点击 build
或 Command + R
实际执行 xcodebuild
命令 ; 编译好后, 生成 ipa 包 实际执行的 xcrun
命令。
自动打包脚本使用的 是 xcodebuild
的 archive
和 -exportArchive
,然而最新需要使用 -exportOptionsPlist
选项,而不再使用-exportFromat
; 使用 xcodebuild -help
命令可查看 -exportOptionsPlist
选项具体描述。
xcodebuild archive
可以 成 个 .archive
文件:
/* project_name 项目名 scheme_name 项目的scheme
build_configuration 工程配置 export_archive_path 导出路径 */
// Cocopods管理的.xcworkspace项目
xcodebuild archive -workspace ${project_name}.xcworkspace \
-scheme ${scheme_name} \
-configuration ${build_configuration} \
-archivePath ${export_archive_path}
// 用Xcode默认创建的.xcodeproj
xcodebuild archive -project ${project_name}.xcodeproj \
-scheme ${scheme_name} \
-configuration ${build_configuration} \
-archivePath ${export_archive_path}
通过这个 .archive
件导出 个 .ipa
文件:
xcodebuild -exportArchive \
-archivePath ${export_archive_path} \
-exportPath ${export_ipa_path} \
-exportOptionsPlist ${ExportOptionsPlistPath}
- 安装相应工具
安装 OSX command line tools
xcode-select --intall
安装 fir-cli
gem install fir-cli
fir-cli 命令帮助 https://github.com/FIRHQ/fir-cli
安装后可以先执行登陆操作,登陆后在后续操作中可以不用重复添加token了(token需要到fir个人账号中获得)
终端执行以下命令:
$ fir login xxxxxxxxxxxxxx // fri token
出现以下说明登陆成功
发布ipa到fir.im,需要提前准备好ipa文件
$ fir publish xxxxx.ipa // ipa路径
shell脚本使用
将
AutoPackageScript
整个文件夹拖入到项目主目录,打开AutoPackageScript.sh
文件修改自定义部分相关参数:scheme_name
is_workspace
is_uploadfir
fir_token
-
打开终端,
cd
到AutoPackageScript
文件夹,输入sh AutoPackageScript.sh
命令,或者 执行sudo xxx/xxx/xxx/AutoPackageScript/AutoPackageScript.sh
脚本文件的路径如果是要上传到蒲公英托管平台,可将上传至fir.im平台的脚本代码进行修改,执行
curl -F "file=@/tmp/example.ipa" -F "uKey=xxx" -F "_api_key=xxx" https://qiniu-storage.pgyer.com/apiv1/app/upload
请根据开发者自己的账号,将其中的 uKey 和 _api_key 的值替换为相应的值。 具体API请参考 https://www.pgyer.com/doc/api#uploadApp
脚本源码
将脚本中的 xxxx 换成实际需要的变量即可。
#-------------项目自定义部分(自定义好下列参数后再执行该脚本)
# (注意: 因为shell定义变量时,=号两边不能留空格,若scheme_name与info_plist_name有空格,脚本运行会失败)
# 计时
SECONDS=0
# 是否编译工作空间 (例:若是用Cocopods管理的.xcworkspace项目,赋值true;用Xcode默认创建的.xcodeproj,赋值false)
is_workspace="false"
# 指定项目的scheme名称
scheme_name="xxxxxxx"
# 工程中Target对应的配置plist文件名称, Xcode默认的配置文件为Info.plist
info_plist_name="Info"
# 指定要打包编译的方式 : Release,Debug
build_configuration="Release"
# 是否上传分发平台(fir)
is_uploadfir="false"
# firToken
fir_token="xxxxxxxxxxxxxxxxxx"
upload_token=$fir_token
# 蒲公英上传
# 执行 curl -F "file=@/tmp/example.ipa" -F "uKey=xxx" -F "_api_key=xxx" https://qiniu-storage.pgyer.com/apiv1/app/upload 请根据开发者自己的账号,将其中的 uKey 和 _api_key 的值替换为相应的值。
# ----------------自动打包部分(无特殊情况不用修改)#
# 导出ipa所需要的plist文件路径 (默认为AdHocExportOptionsPlist.plist)
ExportOptionsPlistPath="./AutoPackageScript/AdHocExportOptionsPlist.plist"
# 返回上一级目录,进入项目工程目录
cd ..
# 获取项目名称
project_name=`find . -name *.xcodeproj | awk -F "[/.]" '{print $(NF-1)}'`
# 获取版本号,内部版本号,bundleID
info_plist_path="$project_name/$info_plist_name.plist"
bundle_version=`/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" $info_plist_path`
bundle_build_version=`/usr/libexec/PlistBuddy -c "Print CFBundleIdentifier" $info_plist_path`
bundle_identifier=`/usr/libexec/PlistBuddy -c "Print CFBundleVersion" $info_plist_path`
# 时间
DATE=`date '+%Y-%m-%d-%H-%m-%S'`
# 指定输出ipa路径
export_path=~/Desktop/"$scheme_name-$DATE"
# 指定输出归档文件地址
export_archive_path="$export_path/$scheme_name.xcarchive"
# 指定输出ipa地址
export_ipa_path="$export_path"
# 指定输出ipa名称
ipa_name="$scheme_name-v$bundle_version"
# AdHoc,AppStore,Enterprise三种打包方式的区别: http://blog.csdn.net/lwjok2007/article/details/46379945
echo "------------------------------------------------------"
echo "\033[36;1m请选择打包方式(输入序号,按回车即可) \033[0m"
echo "\033[33;1m1. AdHoc \033[0m"
echo "\033[33;1m2. AppStore \033[0m"
echo "\033[33;1m3. Enterprise \033[0m"
echo "\033[33;1m4. Development \033[0m"
# 读取用户输入并存到变量里
read parameter
sleep 0.5
method="$parameter"
# 判读用户是否有输入
if [ -n "$method" ]
then
if [ "$method" = "1" ] ; then
ExportOptionsPlistPath="./AutoPackageScript/AdHocExportOptionsPlist.plist"
elif [ "$method" = "2" ] ; then
ExportOptionsPlistPath="./AutoPackageScript/AppStoreExportOptionsPlist.plist"
elif [ "$method" = "3" ] ; then
ExportOptionsPlistPath="./AutoPackageScript/EnterpriseExportOptionsPlist.plist"
elif [ "$method" = "4" ] ; then
ExportOptionsPlistPath="./AutoPackageScript/DevelopmentExportOptionsPlist.plist"
else
echo "输入的参数无效!!!"
exit 1
fi
fi
echo "------------------------------------------------------"
echo "\033[32m是否上传分发平台(fir,输入序号,按回车即可) \033[0m"
echo "\033[33;1m1. 不上传 (默认) \033[0m"
echo "\033[33;1m2. 上传 \033[0m"
read para
sleep 0.5
if [ -n "$para" ]
then
if [ "$para" = "1" ]
then
is_uploadfir="false"
elif [ "$para" = "2" ]
then
is_uploadfir="true"
else
echo "参数无效...."
exit 1
fi
else
is_uploadfir="false"
fi
echo "------------------------------------------------------"
echo "\033[32m开始构建项目 \033[0m"
# 指定输出文件目录不存在则创建
if [ -d "$export_path" ] ; then
echo $export_path
else
mkdir -pv $export_path
fi
# 判断编译的项目类型是workspace还是project
if $is_workspace ; then
# 编译前清理工程
xcodebuild clean -workspace ${project_name}.xcworkspace \
-scheme ${scheme_name} \
-configuration ${build_configuration}
xcodebuild archive -workspace ${project_name}.xcworkspace \
-scheme ${scheme_name} \
-configuration ${build_configuration} \
-archivePath ${export_archive_path}
else
# 编译前清理工程
xcodebuild clean -project ${project_name}.xcodeproj \
-scheme ${scheme_name} \
-configuration ${build_configuration}
xcodebuild archive -project ${project_name}.xcodeproj \
-scheme ${scheme_name} \
-configuration ${build_configuration} \
-archivePath ${export_archive_path}
fi
# 检查是否构建成功
# xcarchive 实际是一个文件夹不是一个文件所以使用 -d 判断
if [ -d "$export_archive_path" ] ; then
echo "\033[32;1m项目构建成功 \033[0m"
else
echo "\033[31;1m项目构建失败 \033[0m"
exit 1
fi
echo "------------------------------------------------------"
echo "\033[32m开始导出ipa文件 \033[0m"
xcodebuild -exportArchive \
-archivePath ${export_archive_path} \
-exportPath ${export_ipa_path} \
-exportOptionsPlist ${ExportOptionsPlistPath}
# 修改ipa文件名称
mv $export_ipa_path/$scheme_name.ipa $export_ipa_path/$ipa_name.ipa
# 检查文件是否存在
if [ -f "$export_ipa_path/$ipa_name.ipa" ] ; then
echo "\033[32;1m导出 ${ipa_name}.ipa 包成功 \033[0m"
open $export_path
else
echo "\033[31;1m导出 ${ipa_name}.ipa 包失败 \033[0m"
exit 1
fi
# 输出打包总用时
echo "\033[36;1m使用AutoPackageScript打包总用时: ${SECONDS}s \033[0m"
#上传分发平台
if $is_uploadfir ; then
fir login -T $upload_token # fir.im token
fir publish $export_ipa_path/$ipa_name.ipa
fi
exit 0
附上github地址:https://github.com/ismilesky/AutoPackageScript.git
问题解决
在配置过程中,难免会遇到一些问题,没办法只能各种Goole, 这里统计一些可能出现的问题和一些解决方案,这样,大家又能少走些弯路啦!
- fir-cli安装问题
在安装的过程中报错:
ERROR: Could not find a valid gem 'fir-cli' (>= 0), here is why:
Unable to download data from https://rubygems.org/
- Errno::ECONNRESET: Connection reset by peer
- SSL_connect (https://rubygems.org/latest_specs.4.8.gz)
- Unable to download data from http://ruby.taobao.org/
- bad response Not Found 404 (http://ruby.taobao.org/latest_specs.4.8.gz)
这是ruby源的问题,估计是以前的ruby源不能使用了,在这里将其删除,并换成新的 https://ruby.taobao.org/即可:
gem sources --remove http://rubygems.org/
gem sources --add https://ruby.taobao.org/
查看当前的ruby源:
gem sources -l
*** CURRENT SOURCES ***
https://ruby.taobao.org
// 请确保只有 ruby.taobao.org, 如果有其他的源, 请 remove 掉
然后再次执行安装 fir-cli 的命令过程中又出错,提示:
Fetching: thor-0.19.1.gem (100%)
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the
/Library/Ruby/Gems/2.0.0 directory.
将安装命令换成:
sudo gem install fir-cli
如果遇到其他安装问题,来这里找解决方案 https://github.com/FIRHQ/fir-cli/blob/master/doc/install.md
- fir-cli
publish
命令出错问题
使用fir-cli
插件上传ipa到fir.im托管平台,可能会出现下面错误:
ERROR -- : SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed
SSL证书报错,在这里可以找到解决方案 https://github.com/FIRHQ/fir-cli/issues/122