使用 fir 和 fastlane 實現 iOS 持續集成

fir

fir.im 是一個免費的應用內測平臺,可上傳測試包到 fir 上,然后測試人員就可以下載安裝應用測試了。fir 提供了一個命令行工具
fir-cli,可編譯 iOS/Android 應用,并上傳應用到 fir 平臺上。

安裝 fir-cli

$ gem install fir-cli

獲取 fir 賬號的 token,執行 fir login,當使用 fir login 登錄了之后, 后續命令都不需要加上 -T 參數, 會默認使用當前用戶的 token 進行相關操作。

$ fir login XXX_YOUR_API_TOKEN_XXX

fir build_ipa 編譯打包 ipa 文件:

schema="testFir"
fir build_ipa ~/Developer/$schema -o ~/Developer/build -w -C Release -S "$schema"

參數說明:-w 是 --workspace 的簡寫,表示編譯 *.xcworkspace, 沒有帶這個參數則編譯 xcodeproj 文件。 -C Release, 以 Release 方式打包,若 Debug 則是打調試包。 -S: 編譯用 CocoaPods 做依賴管理的 .ipa 包。

上傳包命令:

fir publish -c "first version log" ${schema}*.ipa

-c 后帶 log。該命令將上傳上一步生成的 ipa 包。默認的包名是 schema-版本號-build-build 號,如 testFir-2.5.3-build-576.ipa。把這幾行代碼保存成一個 shell 腳本,然后運行這個腳本就可以自動編譯打包并上傳應用到 fir 上,一步到位!

Fastlane

Fastlane 是一個 ruby 腳本集合成的工具套件,旨在實現iOS應用發布流程的自動化。Fastlane 包括了向 App Store 提交新應用或更新已有應用所需要的常用任務。

  • gym 編譯打包生成 ipa 文件
  • deliver 用于上傳應用的二進制代碼,應用截屏和元數據到 App Store
  • sigh 可以生成并下載開發者的 App Store 配置文件
  • snapshot 可以自動化iOS應用在每個設備上的本地化截屏過程

使用 gem 安裝 fastlane

 sudo gem install fastlane

確保 Xcode 命令行工具已安裝:

xcode-select --install

進入工程目錄,初始化 fastlane 配置,運行命令

fastlane init

如圖

fastlane init

在“Your Apple ID" 這一步輸入蘋果開發者賬號,fastlane 會自動獲取工程文件名,目錄等其他數據。這一步“Please confirm the above values”,確認信息,沒問題則輸入 y。然后,fastlane 會進行一系列的初始化操作,包括下載 App Store 上的元數據和截屏文件。等待初始化完成之后,工程目錄下就多了一個 fastlane目錄:

$ cd fastlane && ls
Appfile            Fastfile           metadata           report.xml
Deliverfile        README.md          screenshots

metadata 和 screenshots 是目錄,metadata 下會存放元數據文件,包括關鍵詞,版本更新日志等信息。screenshots 下是 App Store 上的截屏圖片。

Appfile 記錄應用的 bundle ID、Apple ID、Team ID,這個文件不用修改。
Fastfile 是執行腳本,有幾個默認的選項,可直接使用。

打包并上傳應用到 Apple TestFlight,運行命令:

$ fastlane beta

打包并上傳應用到 App Store,執行命令

$ fastlane appstore 

默認的腳本會上傳元數據、應用截屏圖片到 App Store,但我們可能只想傳包。我們還需要設置版本號和編譯號,這個時候就得修改 Fastfile。

首先在 Fastfile 文件開頭添加一個函數,prepare_version設置版本號。

default_platform :ios

scheme = "xiaoxinyong"

def prepare_version(options)
    increment_version_number(
        version_number: options[:version]
    )

    increment_build_number(
        build_number: options[:build]
    )
end

編譯生成 ipa 文件,并上傳至 App Store 的部分代碼修改如下:

  desc "Deploy a new version to the App Store"
  lane :appstore do |options|
    # match(type: "appstore")
    # snapshot
    
    prepare_version(options)
    
    full_version = options[:version] + '_' + options[:build]

    gym(scheme: "#{scheme}", 
      workspace: "#{scheme}.xcworkspace",
      silent: true,
      clean: true, 
      output_directory: "./build", 
      output_name: "#{scheme}_#{full_version}.ipa" ,
      configuration: "Release") # 編譯打包 ipa 文件
      
    deliver(force: true, 
      skip_screenshots:true, 
      skip_metadata: true)    # 不上傳截屏文件和元數據。
    
    # frameit
  end

gym 是編譯打包工具,可設置的參數:

scheme "Example"  # 工程名

clean true  # 編譯前執行 clean,可減少 ipa 文件大小 

output_directory "./build"    # 打包后的 ipa 文件存放的目錄
output_name "MyApp"           # ipa 文件名
configuration: "Release"      # 打包方式,Release 或者 Debug
gym 編譯包

需要注意的是,用 gym 打包的 ipa 文件會比直接用 Xcode 導出 ipa 文件大,但實際上傳到 App Store 上的文件大小和 Xcode 的差不多。所以如果發現 ipa 文件大了許多,不用在意。

修改完之后,打包并上傳應用到 App Store 的命令如下:

$ fastlane appstore version:2.5.4 build:200

如果我們想讓 build number 自動生成,而不是每次都手動輸入,使用increment_build_number即可,但我在執行的時候,總會報錯,于是改用其他方式,shell 腳本如下:

#!/bin/sh

#
# usage:
# > sh build_appstore.sh 2.5.4
#

SCHEMA="your schema"
PROJECT_PATH="/Users/your username/Developer/$SCHEMA"
BUILD_PATH="$PROJECT_PATH/build"
echo $PROJECT_PATH
# echo $BUILD_PATH

function useExample {
    echo "\nUse Example: sh build_appstore.sh 2.5.4\n"
    exit 1
}

[ -z "$1" ] && echo '請輸入版本號' && useExample
    
PRODUCT_SETTINGS_PATH="$PROJECT_PATH/$SCHEMA/Info.plist"

OLD_NUMBER=`/usr/libexec/PlistBuddy -c "Print CFBundleVersion" "$PRODUCT_SETTINGS_PATH"`
 
# If the build number key doesn't exist in the plist, we'll add it by setting its initial value to 1.
if [ $? -ne 0 ]; then
  STARTING_NUMBER=1
  OLD_NUMBER=1
  echo "No build number present. Starting from ${STARTING_NUMBER}."
  `/usr/libexec/PlistBuddy -c "Add CFBundleVersion string $STARTING_NUMBER" "$PRODUCT_SETTINGS_PATH"`
 # exit 0
fi

NEW_NUMBER=$((OLD_NUMBER+=1))
`/usr/libexec/PlistBuddy -c "Set CFBundleVersion $NEW_NUMBER" "$PRODUCT_SETTINGS_PATH"`
[ $? -ne 0 ] && echo "error for increment build number" && exit 1

buildNumber=$NEW_NUMBER # 2000
versionNumber=$1 # 2.5.4
laneName=appstore
echo "build: $buildNumber, version: $versionNumber, lane: $laneName"
fastlane $laneName version:$versionNumber build:$buildNumber

之后要上傳新版本到 App Store,運行如下命令即可:

$ sh build_appstore.sh 2.5.4

有了這幾個腳本,編譯發包只需一條命令,是不是很簡單!

參考鏈接:
使用fastlane實現iOS持續集成
Automating Version and Build Numbers Using agvtool

Automatically Incrementing Version and Build Numbers

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,001評論 6 537
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,786評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,986評論 0 381
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,204評論 1 315
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,964評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,354評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,410評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,554評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,106評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,918評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,093評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,648評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,342評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,755評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,009評論 1 289
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,839評論 3 395
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,107評論 2 375

推薦閱讀更多精彩內容