【iOS 開發(fā)】使用 Fastlane 自動化打包并發(fā)布 iOS 項目

Fastlane

Fastlane 是一個完全開源的項目,是一款為 iOSAndroid 開發(fā)者提供的自動化構建工具砾莱,它可以幫助開發(fā)者將 App 打包瑞筐、簽名、測試腊瑟、發(fā)布聚假、信息整理、提交 App Store 等工作完整的連接起來闰非,實現(xiàn)完全自動化的工作流膘格,如果使用得當,可以顯著的提高開發(fā)者的開發(fā)效率财松,這是 GitHub 地址官方文檔 瘪贱。


本文最終目的:

  • 終端輸入 fastlane beta 自動打包 ad-hoc 版本的 ipa 包并自動上傳到 蒲公英

  • 終端輸入 fastlane release 自動打包 app-store 版本的 ipa 包并自動上傳到 iTunes Connect 辆毡。

1. 安裝 Fastlane

  • 檢查 Ruby 版本菜秦,需要 2.0 及以上版本,并且需要將 gemsource 改為 https://gems.ruby-china.org/ 舶掖,在終端輸入以下命令喷户。
// 查看 Ruby 版本
ruby -v
// 查看 gem 的source
gem sources
  • 檢查 Xcode 命令行工具是否安裝,在終端輸入以下命令访锻,如果安裝過會有提示褪尝,如果沒裝過就會自動開始安裝。
xcode-select --install
  • 開始安裝 Fastlane 期犬,在終端輸入以下命令河哑。
sudo gem install fastlane --verbose
  • 如果安裝時出現(xiàn)錯誤無法安裝,就使用以下命令安裝龟虎。
sudo gem install -n /usr/local/bin fastlane
  • 安裝完成后可以輸入以下命令查看版本來驗證是否安裝成功璃谨。
fastlane --version

2. 安裝蒲公英的 Fastlane 插件

  • fastlane 安裝完成以后,在終端輸入以下命令安裝 蒲公英 插件鲤妥。
fastlane add_plugin pgyer
  • 最后出現(xiàn) Successfully installed plugins 表示安裝完成佳吞。
插件安裝
  • 安裝完成以后,會在系統(tǒng)根目錄生成 GemfileGemfile.lock 這兩個文件棉安,這兩個文件不要刪掉底扳,不然插件就得重裝了。
Gemfile

3. 修改項目配置

  • Xcode 打開你的項目贡耽,然后打開 Manage Schemes... 衷模。
Xcode
  • 然后將工程的 Scheme 后面的 Shared 給勾上鹊汛。
Xcode
  • 需要將這個改動上傳到 git 倉庫,不要忽略掉這個文件阱冶,提交的文件路徑信息如下刁憋,如果你改完沒有提示有需要改動的提交,那就看一下 .gitignore 里面是不是忽略掉了木蹬。
commit
  • 做這個改動的原因是至耻,后面可能會用到 Jenkins + Fastlane 做持續(xù)集成,如果沒有這個文件镊叁,Jenkins 使用 fastlane 編譯項目時會提示 No schemes found in Xcode project or workspace 有梆,所以最好先加上。

4. 初始化 Fastlane 配置

  • 打開終端意系,cd 到你項目工程的根目錄(xcodeproj 的同級目錄),輸入以下命令:
fastlane init
  • 初始化過程中會讓你輸入蘋果開發(fā)者賬號的賬號和密碼饺汹,這個信息會存儲在鑰匙串中蛔添,后續(xù)使用無需再輸入密碼。

  • 初始化過程中還會檢測當前項目的 App Identifier 是否已經在 Apple Developer 中兜辞,還會檢測當前 App 是否已經在 iTunes Connect 中迎瞧,如果都滿足的話,過程應該是比較順利的逸吵。

  • 初始化完成之后會在你項目工程的目錄下生成一個 fastlane 文件夾凶硅,里面是 Fastlane 的一些配置文件。其中 Appfile 里面存放了 App 的基本信息包括 App_Identifier 扫皱、AppID 足绅、Team_ID 等。Fastfile 是最重要的一個文件韩脑,在這個文件里面可以編寫和定制我們打包腳本的一個文件氢妈,所有自定義的功能都寫在這里。

5. 編輯 Fastlane 腳本文件

  • 首先找到工程目錄下 fastlane 文件夾下的 Fastlane 文件段多,如果想要了解其中內容的含義可以自己去官方文檔查一下首量,這里就不解釋了。

  • 使用編輯器打開 Fastlane 文件进苍,將所有內容刪除替換為以下內容加缘。

fastlane_version "xxx"

default_platform :ios

platform :ios do

  desc "以 ad-hoc 方式打包并上傳到蒲公英"
  lane :beta do

    puts "自動生成 Provisioning Profiles 文件"
    sigh(
      # 指定輸出的文件夾地址
      output_path: "./archive/sign",
      # 是否為 AdHoc 證書(設為 false 或不寫默認為 AppStore 證書)
      adhoc: true
    )

    puts "以 ad-hoc 方式打包"
    gym(
      # 指定打包所使用的輸出方式 (可選: app-store, package, ad-hoc, enterprise, development)
      export_method: "ad-hoc",
      # 指定項目的 scheme 名稱
      scheme: "xxx",
      # 指定輸出的文件夾地址
      output_directory: "./archive/beta/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
      # 指定打包方式 (可選: Release, Debug)
      configuration: "Release"
    )

    puts "上傳 ipa 包到蒲公英"
    pgyer(
      # 蒲公英 API KEY
      api_key: "xxx",
      # 蒲公英 USER KEY
      user_key: "xxx"
    )

  end

  desc "以 app-store 方式打包并上傳到 iTunes Connect"
  lane :release do

    puts "自動生成 Provisioning Profiles 文件"
    sigh(
      # 指定輸出的文件夾地址
      output_path: "./archive/sign"
    )

    puts "以 app-store 方式打包"
    gym(
      # 指定打包所使用的輸出方式 (可選: app-store, package, ad-hoc, enterprise, development)
      export_method: "app-store",
      # 指定項目的 scheme 名稱
      scheme: "xxx",
      # 指定輸出的文件夾地址
      output_directory: "./archive/release/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
      # 指定打包方式 (可選: Release, Debug)
      configuration: "Release"
    )

    puts "上傳 ipa 包到 iTunes Connect"
    deliver(
      # 跳過截圖上傳
      skip_screenshots: true,
      # 跳過元數(shù)據(jù)上傳
      skip_metadata: true,
      # 跳過審核直接上傳
      force: true
    )

  end

end
  • 需要更改的地方我已經用 xxx 標注出來了,按照說明更改即可觉啊,更改完成后保存文件拣宏。

6. 開始自動打包并發(fā)布

  • 打開終端,cd 到你項目工程的根目錄(xcodeproj 的同級目錄)杠人。

  • 輸入以下命令蚀浆,即可開始自動打包并上傳到 蒲公英 缀程。

fastlane beta
  • 輸入以下命令,即可開始自動打包并上傳到 iTunes Connect 市俊。
fastlane release
  • 打包的 .ipa 包和 dSYM 文件杨凑,以及生成的 Provisioning Profiles 都在工程目錄下的 archive 文件夾內,看上面的輸出地址就知道了摆昧。

  • 最后出現(xiàn)一個 successfully ?? 就表示成功了撩满,有錯誤終端也會有提示,按照提示繼續(xù)修改配置就行了绅你。


Fastlane 還能實現(xiàn)很多自動化的功能伺帘,感興趣的自己去了解一下吧,這里有篇文章寫的很全面可以看一下: 小團隊的自動化發(fā)布-Fastlane帶來的全自動化發(fā)布 忌锯。

將來的你伪嫁,一定會感激現(xiàn)在拼命的自己,愿自己與讀者的開發(fā)之路無限美好偶垮。

我的傳送門: 博客 张咳、簡書微博 似舵、GitHub 脚猾。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市砚哗,隨后出現(xiàn)的幾起案子龙助,更是在濱河造成了極大的恐慌,老刑警劉巖蛛芥,帶你破解...
    沈念sama閱讀 218,122評論 6 505
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件提鸟,死亡現(xiàn)場離奇詭異,居然都是意外死亡仅淑,警方通過查閱死者的電腦和手機沽一,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,070評論 3 395
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來漓糙,“玉大人铣缠,你說我怎么就攤上這事±デ荩” “怎么了蝗蛙?”我有些...
    開封第一講書人閱讀 164,491評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長醉鳖。 經常有香客問我捡硅,道長,這世上最難降的妖魔是什么盗棵? 我笑而不...
    開封第一講書人閱讀 58,636評論 1 293
  • 正文 為了忘掉前任壮韭,我火速辦了婚禮北发,結果婚禮上,老公的妹妹穿的比我還像新娘喷屋。我一直安慰自己琳拨,他們只是感情好,可當我...
    茶點故事閱讀 67,676評論 6 392
  • 文/花漫 我一把揭開白布屯曹。 她就那樣靜靜地躺著狱庇,像睡著了一般。 火紅的嫁衣襯著肌膚如雪恶耽。 梳的紋絲不亂的頭發(fā)上密任,一...
    開封第一講書人閱讀 51,541評論 1 305
  • 那天,我揣著相機與錄音偷俭,去河邊找鬼浪讳。 笑死,一個胖子當著我的面吹牛涌萤,可吹牛的內容都是我干的淹遵。 我是一名探鬼主播,決...
    沈念sama閱讀 40,292評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼形葬,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了暮的?” 一聲冷哼從身側響起笙以,我...
    開封第一講書人閱讀 39,211評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎冻辩,沒想到半個月后猖腕,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 45,655評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡恨闪,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,846評論 3 336
  • 正文 我和宋清朗相戀三年倘感,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片咙咽。...
    茶點故事閱讀 39,965評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡老玛,死狀恐怖,靈堂內的尸體忽然破棺而出钧敞,到底是詐尸還是另有隱情蜡豹,我是刑警寧澤,帶...
    沈念sama閱讀 35,684評論 5 347
  • 正文 年R本政府宣布溉苛,位于F島的核電站镜廉,受9級特大地震影響,放射性物質發(fā)生泄漏愚战。R本人自食惡果不足惜娇唯,卻給世界環(huán)境...
    茶點故事閱讀 41,295評論 3 329
  • 文/蒙蒙 一齐遵、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧塔插,春花似錦梗摇、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,894評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至伸刃,卻和暖如春谎砾,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背捧颅。 一陣腳步聲響...
    開封第一講書人閱讀 33,012評論 1 269
  • 我被黑心中介騙來泰國打工景图, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人碉哑。 一個月前我還...
    沈念sama閱讀 48,126評論 3 370
  • 正文 我出身青樓挚币,卻偏偏與公主長得像,于是被迫代替她去往敵國和親扣典。 傳聞我的和親對象是個殘疾皇子妆毕,可洞房花燭夜當晚...
    茶點故事閱讀 44,914評論 2 355

推薦閱讀更多精彩內容