自動(dòng)化打包(持續(xù)集成+持續(xù)交付+持續(xù)部署)

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

(1)快速發(fā)現(xiàn)錯(cuò)誤。每完成一點(diǎn)更新,就集成到主干,可以快速發(fā)現(xiàn)錯(cuò)誤,定位錯(cuò)誤也比較容易。

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

持續(xù)集成的目的,就是讓產(chǎn)品可以快速迭代,同時(shí)還能保持高質(zhì)量。它的核心措施是,代碼集成到主干之前,必須通過自動(dòng)化測(cè)試。只要有一個(gè)測(cè)試用例失敗,就不能集成。

Martin Fowler(重構(gòu):改善既有代碼的設(shè)計(jì)的作者)說過,"持續(xù)集成并不能消除Bug,而是讓它們非常容易發(fā)現(xiàn)和改正。

"持續(xù)交付(Continuous delivery)指的是,頻繁地將軟件的新版本,交付給測(cè)試和用戶,以供測(cè)試和評(píng)審。如果通過,代碼就進(jìn)入生產(chǎn)階段。

持續(xù)部署(continuous deployment)是持續(xù)交付的下一步,指的是代碼通過以后,自動(dòng)部署到生產(chǎn)環(huán)境。

主要的工具就是Jenkins+fastlane (但是我個(gè)人覺得Jenkins 維護(hù)成本高個(gè)人, 個(gè)人覺得它主要比f(wàn)astlane就多一個(gè)好處,能自動(dòng)檢測(cè)gitlab你的代碼的上傳然后調(diào)用腳本?,其實(shí)業(yè)務(wù)不復(fù)雜的話直接用fastlane就很不錯(cuò),所以重點(diǎn)講一下fastlane 吧)

1 Jenkins的安裝?

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

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


一直點(diǎn)擊繼續(xù) 直到安裝完成。安裝完成之后,Safari可能會(huì)自動(dòng)打開,如果沒有自動(dòng)打開,打開瀏覽器,輸入http://localhost:8080,會(huì)出現(xiàn)下圖的重設(shè)初始密碼的界面。

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


打開initialAdminPassword文件,復(fù)制出密碼,就可以填到網(wǎng)頁(yè)上去重置密碼了。如下圖

點(diǎn)擊 install suggested plugins ? 然后等待安裝完成 如下圖


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

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

安裝GitLab插件

因?yàn)槲覀冇玫氖荊itLab來管理源代碼,Jenkins本身并沒有自帶GitLab插件,所以我們需要依次選擇系統(tǒng)管理->管理插件,在“可選插件”中選中“GitLab Plugin”和“Gitlab Hook Plugin”這兩項(xiàng),然后安裝。

安裝Xcode插件

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

安裝完了這個(gè),我們就可以配置一個(gè)構(gòu)建項(xiàng)目了。



輸入項(xiàng)目名字,點(diǎn)擊新建好的項(xiàng)目,進(jìn)來配置一下General參數(shù)


接著設(shè)置源碼管理

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


如果正常的配置正確的話,是不會(huì)出現(xiàn)下圖中的那段紅色的警告。如果有下圖的提示,就說明Jenkins還沒有連通GitLab或者SVN,那就請(qǐng)?jiān)贆z查SSH Key是否配置正確。


構(gòu)建觸發(fā)器設(shè)置這里是設(shè)置自動(dòng)化測(cè)試的地方。

Poll SCM(poll source code management) 輪詢?cè)创a管理

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

Build periodically(定時(shí)build)

一般設(shè)置為類似: 00 20 * * *? 每天 20點(diǎn)執(zhí)行定時(shí)build 。當(dāng)然兩者的設(shè)置都是一樣可以通用的。


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

fastlane安裝

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

xcode-select --install

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

[sudo] gem install fastlane

進(jìn)到項(xiàng)目目錄。在xcodeproj文件同級(jí)目錄下,執(zhí)行

fastlane?init

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

成功之后,會(huì)在你工程的根目錄下創(chuàng)建fastlane文件夾里面內(nèi)容如下,最重要的兩個(gè)文件就是Appfile和Fastfile,:


其中:

Appfile, 用于存放 app ID 和你的 Apple ID。 Fastfile, 用于管理你所創(chuàng)建的 lane,lane 則會(huì)調(diào)用 action。

我們先看?Fastfile文件,說到Fastfile文件就要先介紹一下?fastlane組件。fastlane其實(shí)是一個(gè)工具集,包含了我們?nèi)粘i_發(fā)中上線時(shí)需要的大部分操作。比如gym/deliver等。主要組件包括:

deliver:自動(dòng)上傳截圖,APP的元數(shù)據(jù),二進(jìn)制(ipa)文件到iTunes Connect

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

frameit:可以把截的圖片自動(dòng)套上一層外邊框

pem:自動(dòng)生成、更新推送配置文件

sigh:用來創(chuàng)建、更新、下載、修復(fù)Provisioning Profile的工具

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

cert:自動(dòng)創(chuàng)建管理iOS代碼簽名證書

pilot:管理TestFlight的測(cè)試用戶,上傳二進(jìn)制文件

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

gym:自動(dòng)化編譯打包工具

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

scan:自動(dòng)運(yùn)行測(cè)試工具,并且可以生成漂亮的HTML報(bào)告

Fastfile文件

Fastfile文件的主要結(jié)構(gòu)如下所示:

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:指定當(dāng)前默認(rèn)的平臺(tái),可以選擇ios/android/mac

(3)before_all:在執(zhí)行每一個(gè)lane之前都會(huì)調(diào)用這部分的內(nèi)容

(4)after_all:在每個(gè)lane執(zhí)行完成之后都會(huì)執(zhí)行這部分的內(nèi)容

(5)error:每個(gè)lane執(zhí)行出錯(cuò)就會(huì)執(zhí)行這部分的內(nèi)容

(6)desc:對(duì)lane的描述,fastlane會(huì)自動(dòng)將desc的內(nèi)容生成說明文檔

(7)lane:定義一個(gè)lane(任務(wù)),可以理解為一個(gè)函數(shù),我們?cè)趫?zhí)行的時(shí)候使用fastlane [ios] lane名稱

下面是官方提供的一個(gè)示例:

lane :beta do

? increment_build_number

? cocoapods

? match

? testflight

? sh "./customScript.sh"

? slack

end

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

比如我需要完成一套發(fā)布流程:

#發(fā)布到AppStore

lane :release do

? #增加build版本號(hào),需要先配置build setting

? increment_build_number

? #pod資源更新

? cocoapods

? #打包

? gym

? #發(fā)布到AppStore

? deliver(force: true)

? #發(fā)布testflight測(cè)試

? testflight

end

我們?cè)陧?xiàng)目目錄下,用終端執(zhí)行如下命令即可:

fastlane?release

場(chǎng)景

隨著業(yè)務(wù)的發(fā)展,產(chǎn)品線的增加,我們需要將APP拆分為若干個(gè)基礎(chǔ)組件和業(yè)務(wù)組件,以便跨APP使用,并且方便管理維護(hù)(這又是另外一個(gè)大的議題,就不在此贅述了)。每個(gè)組件都由一個(gè)私有Pod來管理,Pod的發(fā)布和更新也成為了我們?nèi)粘9ぷ鞯囊徊糠郑瑢?duì)于這些Pod,一般我們團(tuán)隊(duì)內(nèi)部的原則是:誰(shuí)制作,誰(shuí)管理,誰(shuí)發(fā)布,Pod的負(fù)責(zé)人我們內(nèi)部稱之為庫(kù)管,這件事也就分擔(dān)到了每個(gè)庫(kù)管身上,庫(kù)管發(fā)布一個(gè)Pod的流程大約如下:

增加Podspec中的版本號(hào)

執(zhí)行pod lib lint命令進(jìn)行庫(kù)驗(yàn)證

Git Commit代碼

Git Push代碼到遠(yuǎn)端

打一個(gè)Git Tag

將Tag Push到遠(yuǎn)端

執(zhí)行pod repo push命令發(fā)布庫(kù)到私有倉(cāng)庫(kù)

如果只有兩三個(gè)庫(kù)的話,并且?guī)斓母骂l率較低的時(shí)候,每次手動(dòng)來處理還好。但是當(dāng)庫(kù)逐漸增多的時(shí)候這件事就變得相當(dāng)麻煩,尤其是當(dāng)頂層的庫(kù)依賴底層庫(kù)的時(shí)候,那么升級(jí)一個(gè)庫(kù),影響面將遠(yuǎn)遠(yuǎn)超過其本身,通過人工的方式處理的話,整個(gè)過程會(huì)變得相當(dāng)痛苦。

那我們可以 在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 # 確認(rèn) 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}") # 提交版本號(hào)修改

? add_git_tag(tag: target_version) # 設(shè)置 tag

? push_to_git_remote # 推送到 git 倉(cāng)庫(kù)

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

end

我們?cè)陧?xiàng)目目錄下,用終端執(zhí)行如下命令即可:

fastlane do_release_lib project:GMUtil version:0.1.4

還有在安卓由于國(guó)內(nèi)Android市場(chǎng)眾多上經(jīng)常會(huì)遇到?多渠道打包,這里我們也使用Fastlane如何進(jìn)行處理:

Fastlane的Action機(jī)制

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

fastlane/fastlane/lib/fastlane/actions/

針對(duì)pod的執(zhí)行創(chuàng)建一個(gè)action來針對(duì)下面三種情況的執(zhí)行

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

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

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

自定義Action的流程大約如下,首先,我們?cè)诮K端中執(zhí)行命令:

fastlane new_action

后根據(jù)提示,在命令行中敲入action的名字pod,然后Fastlane會(huì)在當(dāng)前目錄的actions文件夾中幫我們創(chuàng)建了一個(gè)pod.rb的Ruby文件,內(nèi)容大致如下(省略了非重點(diǎn)部分):

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這個(gè)module,并且繼承自Action這個(gè)父類。雖然模板中的內(nèi)容還挺多,不過不用擔(dān)心,大部分內(nèi)容都是一些簡(jiǎn)單的文本描述,對(duì)于我們來說只需要重點(diǎn)關(guān)注這兩個(gè)方法就行:

1.self.run方法:這里放置的是實(shí)際的業(yè)務(wù)處理代碼。

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

在self.available_options中進(jìn)行聲明,在self.run方法中編寫最終的業(yè)務(wù)邏輯,同時(shí)將上面的options通過params暴露出去,這樣在運(yùn)行pod這個(gè)action的時(shí)候,我們就可以傳入對(duì)應(yīng)的參數(shù),從而Fastlane可以執(zhí)行攜帶各種選項(xiàng)的完整命令,

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項(xiàng)目下的fastlane/actions文件夾中,然后在該項(xiàng)目目錄下,執(zhí)行如下命令:

fastlane action pod

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

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

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

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

最后,在Fastfile中定義一個(gè)Lane來進(jìn)行最終的集成處理:

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

接下來的事就簡(jiǎn)單多了,每次需要打包的時(shí)候,只要執(zhí)行如下的命令即可:

fastlane do_package_apk project:Gengmei version:6.3.0

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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容