自動化打包(持續集成+持續交付+持續部署)

持續集成指的是,頻繁地(一天多次)將代碼集成到主干。它的好處主要有兩個。

(1)快速發現錯誤。每完成一點更新,就集成到主干,可以快速發現錯誤,定位錯誤也比較容易。

(2)防止分支大幅偏離主干。如果不是經常集成,主干又在不斷更新,會導致以后集成的難度變大,甚至難以集成。

持續集成的目的,就是讓產品可以快速迭代,同時還能保持高質量。它的核心措施是,代碼集成到主干之前,必須通過自動化測試。只要有一個測試用例失敗,就不能集成。

Martin Fowler(重構:改善既有代碼的設計的作者)說過,"持續集成并不能消除Bug,而是讓它們非常容易發現和改正。

"持續交付(Continuous delivery)指的是,頻繁地將軟件的新版本,交付給測試和用戶,以供測試和評審。如果通過,代碼就進入生產階段。

持續部署(continuous deployment)是持續交付的下一步,指的是代碼通過以后,自動部署到生產環境。

主要的工具就是Jenkins+fastlane (但是我個人覺得Jenkins 維護成本高個人, 個人覺得它主要比fastlane就多一個好處,能自動檢測gitlab你的代碼的上傳然后調用腳本?,其實業務不復雜的話直接用fastlane就很不錯,所以重點講一下fastlane 吧)

1 Jenkins的安裝?

首先你要先在本地電腦把Java環境配置好 ,http://www.lxweimin.com/p/b518ce7e2bce我直接貼出來地址吧?

我們來開始安裝Jenkins。從官網https://jenkins.io/?上下載最新的pkg安裝包。


一直點擊繼續 直到安裝完成。安裝完成之后,Safari可能會自動打開,如果沒有自動打開,打開瀏覽器,輸入http://localhost:8080,會出現下圖的重設初始密碼的界面。

按照提示,找到/Users/Shared/Jenkins/Home/ 這個目錄下(也有可能不是這個目錄,只需要按照它提示的目錄就行),這個目錄雖然是共享目錄,但是有權限的,非Jenkins用戶/secrets/目錄是沒有讀寫權限的。


打開initialAdminPassword文件,復制出密碼,就可以填到網頁上去重置密碼了。如下圖

點擊 install suggested plugins ? 然后等待安裝完成 如下圖


一路安裝過來,輸入用戶名,密碼,郵件這些,就算安裝完成了。

還是繼續登錄localhost:8080 ,選擇“系統管理”——“管理插件”,我們要先安裝一些輔助插件。

安裝GitLab插件

因為我們用的是GitLab來管理源代碼,Jenkins本身并沒有自帶GitLab插件,所以我們需要依次選擇系統管理->管理插件,在“可選插件”中選中“GitLab Plugin”和“Gitlab Hook Plugin”這兩項,然后安裝。

安裝Xcode插件

同安裝GitLab插件的步驟一樣,我們依次選擇系統管理->管理插件,在“可選插件”中選中“Xcode integration”安裝。

安裝完了這個,我們就可以配置一個構建項目了。



輸入項目名字,點擊新建好的項目,進來配置一下General參數


接著設置源碼管理

由于現在我用到的是GitLab,先配置SSH Key,在Jenkins的證書管理中添加SSH。在Jenkins管理頁面,選擇“Credentials”,然后選擇“Global credentials (unrestricted)”,點擊“Add Credentials”,如下圖所示,我們填寫自己的SSH信息,然后點擊“Save”,這樣就把SSH添加到Jenkins的全局域中去了。


如果正常的配置正確的話,是不會出現下圖中的那段紅色的警告。如果有下圖的提示,就說明Jenkins還沒有連通GitLab或者SVN,那就請再檢查SSH Key是否配置正確。


構建觸發器設置這里是設置自動化測試的地方。

Poll SCM(poll source code management) 輪詢源碼管理

需要設置源碼的路徑才能起到輪詢的效果。一般設置為類似結果: 0/5 * * * * 每5分鐘輪詢一次

Build periodically(定時build)

一般設置為類似: 00 20 * * *? 每天 20點執行定時build 。當然兩者的設置都是一樣可以通用的。


還有一些關于鑰匙串和證書,描述文件的配置,但是我們主要用fastlane 腳本打包?,所以先說怎么安裝?fastlane吧

fastlane安裝

確保Xcode Command Line Tools 安裝了最新版

xcode-select --install

如果你單獨安裝過ruby(如果你能看得懂這句),去掉sudo。如果使用系統自帶的ruby,需要sudo權限

[sudo] gem install fastlane

進到項目目錄。在xcodeproj文件同級目錄下,執行

fastlane?init

如果是第一次使用 fastlane ,會要求輸入你的蘋果開發者賬號,期間會讓你輸入 Apple ID 賬號密碼(這個信息會存在鑰匙串中,后續使用無需再輸入密碼),會檢測當前的 app identifier 是否在 Apple Dev Center 中,會檢測當前 app 是否在 iTunes Connect 中,如果已經在 Apple Dev Center 和 iTunes Connect 中創建相應的信息,那么過程會很順利

成功之后,會在你工程的根目錄下創建fastlane文件夾里面內容如下,最重要的兩個文件就是Appfile和Fastfile,:


其中:

Appfile, 用于存放 app ID 和你的 Apple ID。 Fastfile, 用于管理你所創建的 lane,lane 則會調用 action。

我們先看?Fastfile文件,說到Fastfile文件就要先介紹一下?fastlane組件。fastlane其實是一個工具集,包含了我們日常開發中上線時需要的大部分操作。比如gym/deliver等。主要組件包括:

deliver:自動上傳截圖,APP的元數據,二進制(ipa)文件到iTunes Connect

snapshot:自動截圖(基于Xcode7的UI test)

frameit:可以把截的圖片自動套上一層外邊框

pem:自動生成、更新推送配置文件

sigh:用來創建、更新、下載、修復Provisioning Profile的工具

produce:如果你的產品還沒在iTunes Connect(iTC)或者Apple Developer Center(ADC)建立,produce可以自動幫你完成這些工作

cert:自動創建管理iOS代碼簽名證書

pilot:管理TestFlight的測試用戶,上傳二進制文件

boarding:建立一個添加測試用戶界面,發給測試者,可自行添加郵件地址,并同步到iTunes Connect(iTC)

gym:自動化編譯打包工具

match:證書和配置文件管理工具

scan:自動運行測試工具,并且可以生成漂亮的HTML報告

Fastfile文件

Fastfile文件的主要結構如下所示:

fastlane_version "2.14.2"

default_platform :ios

platform :ios do

before_all do

? cocoapods

? end

? ?lane :test do

? end

? ?lane :beta do

? end

? ?lane :release do

? end

? ?after_all do |lane|

? end

? error do |lane, exception|

? end

end

說明:

(1)fastlane_version:指定fastlane使用的最小版本

(2)default_platform:指定當前默認的平臺,可以選擇ios/android/mac

(3)before_all:在執行每一個lane之前都會調用這部分的內容

(4)after_all:在每個lane執行完成之后都會執行這部分的內容

(5)error:每個lane執行出錯就會執行這部分的內容

(6)desc:對lane的描述,fastlane會自動將desc的內容生成說明文檔

(7)lane:定義一個lane(任務),可以理解為一個函數,我們在執行的時候使用fastlane [ios] lane名稱

下面是官方提供的一個示例:

lane :beta do

? increment_build_number

? cocoapods

? match

? testflight

? sh "./customScript.sh"

? slack

end

像increment_build_number、cocoapods這樣的一條命令都是一個action,由這樣的一個個action組成了一個lane(lane中可以調用其他的lane)。

比如我需要完成一套發布流程:

#發布到AppStore

lane :release do

? #增加build版本號,需要先配置build setting

? increment_build_number

? #pod資源更新

? cocoapods

? #打包

? gym

? #發布到AppStore

? deliver(force: true)

? #發布testflight測試

? testflight

end

我們在項目目錄下,用終端執行如下命令即可:

fastlane?release

場景

隨著業務的發展,產品線的增加,我們需要將APP拆分為若干個基礎組件和業務組件,以便跨APP使用,并且方便管理維護(這又是另外一個大的議題,就不在此贅述了)。每個組件都由一個私有Pod來管理,Pod的發布和更新也成為了我們日常工作的一部分,對于這些Pod,一般我們團隊內部的原則是:誰制作,誰管理,誰發布,Pod的負責人我們內部稱之為庫管,這件事也就分擔到了每個庫管身上,庫管發布一個Pod的流程大約如下:

增加Podspec中的版本號

執行pod lib lint命令進行庫驗證

Git Commit代碼

Git Push代碼到遠端

打一個Git Tag

將Tag Push到遠端

執行pod repo push命令發布庫到私有倉庫

如果只有兩三個庫的話,并且庫的更新頻率較低的時候,每次手動來處理還好。但是當庫逐漸增多的時候這件事就變得相當麻煩,尤其是當頂層的庫依賴底層庫的時候,那么升級一個庫,影響面將遠遠超過其本身,通過人工的方式處理的話,整個過程會變得相當痛苦。

那我們可以 在fastlane 中 這些寫

desc "Release new private pod version"

lane :do_release_lib do |options|

? target_version = options[:version]

? project? ? ? ? = options[:project]

? path? ? ? ? ? = "#{project}.podspec"

? git_pull

? ensure_git_branch # 確認 master 分支

? pod_install

? pod_lib_lint(verbose: true, allow_warnings: true, sources: SOURCES, use_bundle_exec: true, fail_fast: true)

? version_bump_podspec(path: path, version_number: target_version) # 更新 podspec

? git_commit_all(message: "Bump version to #{target_version}") # 提交版本號修改

? add_git_tag(tag: target_version) # 設置 tag

? push_to_git_remote # 推送到 git 倉庫

? pod_push(path: path, repo: "GMSpecs", allow_warnings: true, sources: SOURCES) # 提交到 CocoaPods

end

我們在項目目錄下,用終端執行如下命令即可:

fastlane do_release_lib project:GMUtil version:0.1.4

還有在安卓由于國內Android市場眾多上經常會遇到?多渠道打包,這里我們也使用Fastlane如何進行處理:

Fastlane的Action機制

Fastlane本身包含兩大模塊,一個是其內核部分,另外一個就是Action了。Action是Fastlane自動化流程中的最小執行單元,直觀上來講就是Fastfile腳本中的一個個命令,比如:git_pull,deliver,pod_install等等,而這些命令背后都對應一個用Ruby編寫的腳本。Fastlane已經為我們提供了現成的模板,即使你對Ruby的語法不熟悉,也沒有關系,Fastlane是開源的嘛,可以直接下載源碼看看別人的Action是怎么寫的就知道了,我們可以在這個目錄下找到所有的Action文件:

fastlane/fastlane/lib/fastlane/actions/

針對pod的執行創建一個action來針對下面三種情況的執行

pod install --no-repo-update (避免master repo的每次更新耗時)

pod update --no-repo-update (避免master repo的每次更新耗時)

pod repo update XXX (私有repo的更新)

自定義Action的流程大約如下,首先,我們在終端中執行命令:

fastlane new_action

后根據提示,在命令行中敲入action的名字pod,然后Fastlane會在當前目錄的actions文件夾中幫我們創建了一個pod.rb的Ruby文件,內容大致如下(省略了非重點部分):

module Fastlane

? module Actions

? ? class PodLibLintAction < Action

? ? ? def self.run(params)

? ? ? ? UI.message "Parameter API Token: #{params[:api_token]}"

? ? ? end

? ? ? ......

? ? ? def self.available_options

? ? ? ? [

? ? ? ? ? FastlaneCore::ConfigItem.new(key: :api_token,

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? env_name: "FL_POD_LIB_LINT_API_TOKEN", # The name of the environment variable

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? description: "API Token for PodLibLintAction", # a short description of this parameter

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? verify_block: proc do |value|

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? UI.user_error!("No API token for PodLibLintAction given, pass using `api_token: 'token'`") unless (value and not value.empty?)

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? end),

? ? ? ? ? ......

? ? ? ? ]

? ? end

?end

end

可以看到,自定義的Action都是隸屬于Fastlane/Actions這個module,并且繼承自Action這個父類。雖然模板中的內容還挺多,不過不用擔心,大部分內容都是一些簡單的文本描述,對于我們來說只需要重點關注這兩個方法就行:

1.self.run方法:這里放置的是實際的業務處理代碼。

2.self.available_options方法:這里聲明需要對外暴露出的參數,沒有聲明的參數在執行過程中無法使用。

在self.available_options中進行聲明,在self.run方法中編寫最終的業務邏輯,同時將上面的options通過params暴露出去,這樣在運行pod這個action的時候,我們就可以傳入對應的參數,從而Fastlane可以執行攜帶各種選項的完整命令,

module Fastlane

? module Actions

? ? module SharedValues

? ? ? POD_INSTALL_CUSTOM_VALUE = :POD_INSTALL_CUSTOM_VALUE

? ? end

? ? class PodInstallAction < Action

? ? ? def self.run(params)

? ? ? ? repo = "-no-repo-update"

? ? ? ? command = []

? ? ? ? command << "pod install"

? ? ? ? if params[:repo_update]

? ? ? ? ? repo = "--repo-update"

? ? ? ? end

? ? ? ? command << repo

? ? ? ? if params[:verbose]

? ? ? ? ? command << "--verbose"

? ? ? ? end

? ? ? ? result = Actions.sh(command.join(' '))

? ? ? ? UI.success(command.join(' ') + " Successfully ")

? ? ? ? return result

? ? ? end

? ? ? def self.description

? ? ? ? "pod install action"

? ? ? end

? ? ? def self.details

? ? ? ? "verbose / repo-update"

? ? ? end

? ? ? def self.available_options

? ? ? ? [

? ? ? ? FastlaneCore::ConfigItem.new(key: :verbose,

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? description: "Allow output detail in console",

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? optional: true,

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? is_string: false,

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? default_value: false),

? ? ? ? ? FastlaneCore::ConfigItem.new(key: :repo_update,

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? description: "Allow output detail in console",

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? optional: true,

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? is_string: false,

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? default_value: false)

? ? ? ? ]

? ? ? end

? ? ? def self.output

? ? ? end

? ? ? def self.return_value

? ? ? end

? ? ? def self.authors

? ? ? ? ["yang"]

? ? ? end

? ? ? def self.is_supported?(platform)

? ? ? ? platform == :ios

? ? ? end

? ? end

? end

end

最后,我們將pod.rb拷貝到iOS項目下的fastlane/actions文件夾中,然后在該項目目錄下,執行如下命令:

fastlane action pod

首先,我們自定義一個Action:add_channels_to_apk,這個Action的作用就是:

拷貝最終打包生成的apk文件,并修改文件名為渠道名,如gengmei_qq_630.apk

然后將一個渠道名寫入到apk文件的META-INFO目錄中

其次,新建一個txt文件,里面寫入所有需要打包的渠道名,如:QQ,360,Baidu...等等,渠道名之間用逗號隔開。

最后,在Fastfile中定義一個Lane來進行最終的集成處理:

desc "Package a new app version with different channels"

lane :do_package_apk do |options|

? ? project = "#{options[:project]}"

? ? target_version = options[:version]

? ? git_pull

? ? gradle(task: "clean")

? ? gradle(task: "assembleRelease")

? ? add_channels_to_apk(channels: './channels.txt')

end

接下來的事就簡單多了,每次需要打包的時候,只要執行如下的命令即可:

fastlane do_package_apk project:Gengmei version:6.3.0

無論是5個渠道,還是50個渠道,1分鐘內全部搞定,非常的方便。

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

推薦閱讀更多精彩內容