開篇
每次新版本開始提交測試上傳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