開篇
每次新版本開始提交測試上傳fir.im托管平臺(tái)浮声,或者提交AppStore的時(shí)候虚婿,都免不了一套打包操作, 時(shí)間短還好說泳挥,時(shí)間一長好傷心然痊,還不能走開,還要進(jìn)行一下操作屉符,真麻煩剧浸,心好累啊矗钟!
所以唆香,整理出了一個(gè)可以自動(dòng)打包ipa文件,并且能夠自動(dòng)上傳到fir.im的shell腳本吨艇。 自動(dòng)打包時(shí)間去愉快的喝杯咖啡吧躬它。。东涡。 ?? ?? ??
準(zhǔn)備
- 了解知識(shí)
官方文檔 Workspace冯吓、Project、Scheme疮跑、Target 了解
Xcode打包原理: 點(diǎn)擊 build
或 Command + R
實(shí)際執(zhí)行 xcodebuild
命令 ; 編譯好后组贺, 生成 ipa 包 實(shí)際執(zhí)行的 xcrun
命令。
自動(dòng)打包腳本使用的 是 xcodebuild
的 archive
和 -exportArchive
,然而最新需要使用 -exportOptionsPlist
選項(xiàng),而不再使用-exportFromat
祖娘; 使用 xcodebuild -help
命令可查看 -exportOptionsPlist
選項(xiàng)具體描述失尖。
xcodebuild archive
可以 成 個(gè) .archive
文件:
/* project_name 項(xiàng)目名 scheme_name 項(xiàng)目的scheme
build_configuration 工程配置 export_archive_path 導(dǎo)出路徑 */
// Cocopods管理的.xcworkspace項(xiàng)目
xcodebuild archive -workspace ${project_name}.xcworkspace \
-scheme ${scheme_name} \
-configuration ${build_configuration} \
-archivePath ${export_archive_path}
// 用Xcode默認(rèn)創(chuàng)建的.xcodeproj
xcodebuild archive -project ${project_name}.xcodeproj \
-scheme ${scheme_name} \
-configuration ${build_configuration} \
-archivePath ${export_archive_path}
通過這個(gè) .archive
件導(dǎo)出 個(gè) .ipa
文件:
xcodebuild -exportArchive \
-archivePath ${export_archive_path} \
-exportPath ${export_ipa_path} \
-exportOptionsPlist ${ExportOptionsPlistPath}
- 安裝相應(yīng)工具
安裝 OSX command line tools
xcode-select --intall
安裝 fir-cli
gem install fir-cli
fir-cli 命令幫助 https://github.com/FIRHQ/fir-cli
安裝后可以先執(zhí)行登陸操作,登陸后在后續(xù)操作中可以不用重復(fù)添加token了(token需要到fir個(gè)人賬號(hào)中獲得)
終端執(zhí)行以下命令:
$ fir login xxxxxxxxxxxxxx // fri token
出現(xiàn)以下說明登陸成功
發(fā)布ipa到fir.im,需要提前準(zhǔn)備好ipa文件
$ fir publish xxxxx.ipa // ipa路徑
shell腳本使用
將
AutoPackageScript
整個(gè)文件夾拖入到項(xiàng)目主目錄掀潮,打開AutoPackageScript.sh
文件修改自定義部分相關(guān)參數(shù):scheme_name
is_workspace
is_uploadfir
fir_token
-
打開終端,
cd
到AutoPackageScript
文件夾菇夸,輸入sh AutoPackageScript.sh
命令,或者 執(zhí)行sudo xxx/xxx/xxx/AutoPackageScript/AutoPackageScript.sh
腳本文件的路徑如果是要上傳到蒲公英托管平臺(tái)胧辽,可將上傳至fir.im平臺(tái)的腳本代碼進(jìn)行修改峻仇,執(zhí)行
curl -F "file=@/tmp/example.ipa" -F "uKey=xxx" -F "_api_key=xxx" https://qiniu-storage.pgyer.com/apiv1/app/upload
請根據(jù)開發(fā)者自己的賬號(hào),將其中的 uKey 和 _api_key 的值替換為相應(yīng)的值邑商。 具體API請參考 https://www.pgyer.com/doc/api#uploadApp
腳本源碼
將腳本中的 xxxx 換成實(shí)際需要的變量即可恶迈。
#-------------項(xiàng)目自定義部分(自定義好下列參數(shù)后再執(zhí)行該腳本)
# (注意: 因?yàn)閟hell定義變量時(shí),=號(hào)兩邊不能留空格,若scheme_name與info_plist_name有空格,腳本運(yùn)行會(huì)失敗)
# 計(jì)時(shí)
SECONDS=0
# 是否編譯工作空間 (例:若是用Cocopods管理的.xcworkspace項(xiàng)目,賦值true;用Xcode默認(rèn)創(chuàng)建的.xcodeproj,賦值false)
is_workspace="false"
# 指定項(xiàng)目的scheme名稱
scheme_name="xxxxxxx"
# 工程中Target對應(yīng)的配置plist文件名稱, Xcode默認(rèn)的配置文件為Info.plist
info_plist_name="Info"
# 指定要打包編譯的方式 : Release,Debug
build_configuration="Release"
# 是否上傳分發(fā)平臺(tái)(fir)
is_uploadfir="false"
# firToken
fir_token="xxxxxxxxxxxxxxxxxx"
upload_token=$fir_token
# 蒲公英上傳
# 執(zhí)行 curl -F "file=@/tmp/example.ipa" -F "uKey=xxx" -F "_api_key=xxx" https://qiniu-storage.pgyer.com/apiv1/app/upload 請根據(jù)開發(fā)者自己的賬號(hào)涩金,將其中的 uKey 和 _api_key 的值替換為相應(yīng)的值。
# ----------------自動(dòng)打包部分(無特殊情況不用修改)#
# 導(dǎo)出ipa所需要的plist文件路徑 (默認(rèn)為AdHocExportOptionsPlist.plist)
ExportOptionsPlistPath="./AutoPackageScript/AdHocExportOptionsPlist.plist"
# 返回上一級(jí)目錄,進(jìn)入項(xiàng)目工程目錄
cd ..
# 獲取項(xiàng)目名稱
project_name=`find . -name *.xcodeproj | awk -F "[/.]" '{print $(NF-1)}'`
# 獲取版本號(hào),內(nèi)部版本號(hào),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`
# 時(shí)間
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三種打包方式的區(qū)別: http://blog.csdn.net/lwjok2007/article/details/46379945
echo "------------------------------------------------------"
echo "\033[36;1m請選擇打包方式(輸入序號(hào),按回車即可) \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 "輸入的參數(shù)無效!!!"
exit 1
fi
fi
echo "------------------------------------------------------"
echo "\033[32m是否上傳分發(fā)平臺(tái)(fir,輸入序號(hào),按回車即可) \033[0m"
echo "\033[33;1m1. 不上傳 (默認(rèn)) \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 "參數(shù)無效...."
exit 1
fi
else
is_uploadfir="false"
fi
echo "------------------------------------------------------"
echo "\033[32m開始構(gòu)建項(xiàng)目 \033[0m"
# 指定輸出文件目錄不存在則創(chuàng)建
if [ -d "$export_path" ] ; then
echo $export_path
else
mkdir -pv $export_path
fi
# 判斷編譯的項(xiàng)目類型是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
# 檢查是否構(gòu)建成功
# xcarchive 實(shí)際是一個(gè)文件夾不是一個(gè)文件所以使用 -d 判斷
if [ -d "$export_archive_path" ] ; then
echo "\033[32;1m項(xiàng)目構(gòu)建成功 \033[0m"
else
echo "\033[31;1m項(xiàng)目構(gòu)建失敗 \033[0m"
exit 1
fi
echo "------------------------------------------------------"
echo "\033[32m開始導(dǎo)出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導(dǎo)出 ${ipa_name}.ipa 包成功 \033[0m"
open $export_path
else
echo "\033[31;1m導(dǎo)出 ${ipa_name}.ipa 包失敗 \033[0m"
exit 1
fi
# 輸出打包總用時(shí)
echo "\033[36;1m使用AutoPackageScript打包總用時(shí): ${SECONDS}s \033[0m"
#上傳分發(fā)平臺(tái)
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
問題解決
在配置過程中暇仲,難免會(huì)遇到一些問題步做,沒辦法只能各種Goole, 這里統(tǒng)計(jì)一些可能出現(xiàn)的問題和一些解決方案奈附,這樣全度,大家又能少走些彎路啦!
- fir-cli安裝問題
在安裝的過程中報(bào)錯(cuò):
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源的問題斥滤,估計(jì)是以前的ruby源不能使用了将鸵,在這里將其刪除,并換成新的 https://ruby.taobao.org/即可:
gem sources --remove http://rubygems.org/
gem sources --add https://ruby.taobao.org/
查看當(dāng)前的ruby源:
gem sources -l
*** CURRENT SOURCES ***
https://ruby.taobao.org
// 請確保只有 ruby.taobao.org, 如果有其他的源, 請 remove 掉
然后再次執(zhí)行安裝 fir-cli 的命令過程中又出錯(cuò)佑颇,提示:
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
命令出錯(cuò)問題
使用fir-cli
插件上傳ipa到fir.im托管平臺(tái),可能會(huì)出現(xiàn)下面錯(cuò)誤:
ERROR -- : SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed
SSL證書報(bào)錯(cuò)挑胸,在這里可以找到解決方案 https://github.com/FIRHQ/fir-cli/issues/122