持續(xù)集成指的是顽照,頻繁地(一天多次)將代碼集成到主干它呀。它的好處主要有兩個。
(1)快速發(fā)現(xiàn)錯誤棒厘。每完成一點更新,就集成到主干下隧,可以快速發(fā)現(xiàn)錯誤奢人,定位錯誤也比較容易。
(2)防止分支大幅偏離主干淆院。如果不是經(jīng)常集成何乎,主干又在不斷更新,會導(dǎo)致以后集成的難度變大土辩,甚至難以集成支救。
持續(xù)集成的目的,就是讓產(chǎn)品可以快速迭代拷淘,同時還能保持高質(zhì)量各墨。它的核心措施是,代碼集成到主干之前启涯,必須通過自動化測試贬堵。只要有一個測試用例失敗,就不能集成结洼。
Martin Fowler(重構(gòu):改善既有代碼的設(shè)計的作者)說過黎做,"持續(xù)集成并不能消除Bug,而是讓它們非常容易發(fā)現(xiàn)和改正松忍。
"持續(xù)交付(Continuous delivery)指的是蒸殿,頻繁地將軟件的新版本,交付給測試和用戶,以供測試和評審宏所。如果通過酥艳,代碼就進(jìn)入生產(chǎn)階段。
持續(xù)部署(continuous deployment)是持續(xù)交付的下一步楣铁,指的是代碼通過以后玖雁,自動部署到生產(chǎn)環(huán)境。
主要的工具就是Jenkins+fastlane (但是我個人覺得Jenkins 維護(hù)成本高個人盖腕, 個人覺得它主要比fastlane就多一個好處赫冬,能自動檢測gitlab你的代碼的上傳然后調(diào)用腳本?,其實業(yè)務(wù)不復(fù)雜的話直接用fastlane就很不錯溃列,所以重點講一下fastlane 吧)
1 Jenkins的安裝?
首先你要先在本地電腦把Java環(huán)境配置好 劲厌,http://www.reibang.com/p/b518ce7e2bce我直接貼出來地址吧?
我們來開始安裝Jenkins。從官網(wǎng)https://jenkins.io/?上下載最新的pkg安裝包听隐。
一直點擊繼續(xù) 直到安裝完成补鼻。安裝完成之后,Safari可能會自動打開雅任,如果沒有自動打開风范,打開瀏覽器,輸入http://localhost:8080沪么,會出現(xiàn)下圖的重設(shè)初始密碼的界面硼婿。
按照提示,找到/Users/Shared/Jenkins/Home/ 這個目錄下(也有可能不是這個目錄禽车,只需要按照它提示的目錄就行)寇漫,這個目錄雖然是共享目錄,但是有權(quán)限的殉摔,非Jenkins用戶/secrets/目錄是沒有讀寫權(quán)限的州胳。
打開initialAdminPassword文件,復(fù)制出密碼逸月,就可以填到網(wǎng)頁上去重置密碼了栓撞。如下圖
點擊 install suggested plugins ? 然后等待安裝完成 如下圖
一路安裝過來,輸入用戶名碗硬,密碼腐缤,郵件這些,就算安裝完成了肛响。
還是繼續(xù)登錄localhost:8080 岭粤,選擇“系統(tǒng)管理”——“管理插件”,我們要先安裝一些輔助插件特笋。
安裝GitLab插件
因為我們用的是GitLab來管理源代碼剃浇,Jenkins本身并沒有自帶GitLab插件巾兆,所以我們需要依次選擇系統(tǒng)管理->管理插件,在“可選插件”中選中“GitLab Plugin”和“Gitlab Hook Plugin”這兩項虎囚,然后安裝角塑。
安裝Xcode插件
同安裝GitLab插件的步驟一樣,我們依次選擇系統(tǒng)管理->管理插件淘讥,在“可選插件”中選中“Xcode integration”安裝圃伶。
安裝完了這個,我們就可以配置一個構(gòu)建項目了蒲列。
輸入項目名字窒朋,點擊新建好的項目,進(jìn)來配置一下General參數(shù)
接著設(shè)置源碼管理蝗岖。
由于現(xiàn)在我用到的是GitLab侥猩,先配置SSH Key,在Jenkins的證書管理中添加SSH抵赢。在Jenkins管理頁面欺劳,選擇“Credentials”,然后選擇“Global credentials (unrestricted)”铅鲤,點擊“Add Credentials”划提,如下圖所示,我們填寫自己的SSH信息邢享,然后點擊“Save”鹏往,這樣就把SSH添加到Jenkins的全局域中去了。
如果正常的配置正確的話驼仪,是不會出現(xiàn)下圖中的那段紅色的警告。如果有下圖的提示袜漩,就說明Jenkins還沒有連通GitLab或者SVN绪爸,那就請再檢查SSH Key是否配置正確。
構(gòu)建觸發(fā)器設(shè)置這里是設(shè)置自動化測試的地方宙攻。
Poll SCM(poll source code management) 輪詢源碼管理
需要設(shè)置源碼的路徑才能起到輪詢的效果奠货。一般設(shè)置為類似結(jié)果: 0/5 * * * * 每5分鐘輪詢一次
Build periodically(定時build)
一般設(shè)置為類似: 00 20 * * *? 每天 20點執(zhí)行定時build 。當(dāng)然兩者的設(shè)置都是一樣可以通用的座掘。
還有一些關(guān)于鑰匙串和證書递惋,描述文件的配置,但是我們主要用fastlane 腳本打包?溢陪,所以先說怎么安裝?fastlane吧
fastlane安裝
確保Xcode Command Line Tools 安裝了最新版
xcode-select --install
如果你單獨安裝過ruby(如果你能看得懂這句)萍虽,去掉sudo。如果使用系統(tǒng)自帶的ruby形真,需要sudo權(quán)限
[sudo] gem install fastlane
進(jìn)到項目目錄杉编。在xcodeproj文件同級目錄下,執(zhí)行
fastlane?init
如果是第一次使用 fastlane ,會要求輸入你的蘋果開發(fā)者賬號,期間會讓你輸入 Apple ID 賬號密碼(這個信息會存在鑰匙串中,后續(xù)使用無需再輸入密碼)邓馒,會檢測當(dāng)前的 app identifier 是否在 Apple Dev Center 中嘶朱,會檢測當(dāng)前 app 是否在 iTunes Connect 中,如果已經(jīng)在 Apple Dev Center 和 iTunes Connect 中創(chuàng)建相應(yīng)的信息,那么過程會很順利
成功之后光酣,會在你工程的根目錄下創(chuàng)建fastlane文件夾里面內(nèi)容如下疏遏,最重要的兩個文件就是Appfile和Fastfile,:
其中:
Appfile, 用于存放 app ID 和你的 Apple ID救军。 Fastfile, 用于管理你所創(chuàng)建的 lane财异,lane 則會調(diào)用 action。
我們先看?Fastfile文件缤言,說到Fastfile文件就要先介紹一下?fastlane組件宝当。fastlane其實是一個工具集,包含了我們?nèi)粘i_發(fā)中上線時需要的大部分操作胆萧。比如gym/deliver等庆揩。主要組件包括:
deliver:自動上傳截圖,APP的元數(shù)據(jù)跌穗,二進(jìn)制(ipa)文件到iTunes Connect
snapshot:自動截圖(基于Xcode7的UI test)
frameit:可以把截的圖片自動套上一層外邊框
pem:自動生成订晌、更新推送配置文件
sigh:用來創(chuàng)建、更新蚌吸、下載锈拨、修復(fù)Provisioning Profile的工具
produce:如果你的產(chǎn)品還沒在iTunes Connect(iTC)或者Apple Developer Center(ADC)建立,produce可以自動幫你完成這些工作
cert:自動創(chuàng)建管理iOS代碼簽名證書
pilot:管理TestFlight的測試用戶羹唠,上傳二進(jìn)制文件
boarding:建立一個添加測試用戶界面奕枢,發(fā)給測試者,可自行添加郵件地址佩微,并同步到iTunes Connect(iTC)
gym:自動化編譯打包工具
match:證書和配置文件管理工具
scan:自動運行測試工具缝彬,并且可以生成漂亮的HTML報告
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)的平臺,可以選擇ios/android/mac
(3)before_all:在執(zhí)行每一個lane之前都會調(diào)用這部分的內(nèi)容
(4)after_all:在每個lane執(zhí)行完成之后都會執(zhí)行這部分的內(nèi)容
(5)error:每個lane執(zhí)行出錯就會執(zhí)行這部分的內(nèi)容
(6)desc:對lane的描述哺眯,fastlane會自動將desc的內(nèi)容生成說明文檔
(7)lane:定義一個lane(任務(wù))谷浅,可以理解為一個函數(shù),我們在執(zhí)行的時候使用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中可以調(diào)用其他的lane)。
比如我需要完成一套發(fā)布流程:
#發(fā)布到AppStore
lane :release do
? #增加build版本號,需要先配置build setting
? increment_build_number
? #pod資源更新
? cocoapods
? #打包
? gym
? #發(fā)布到AppStore
? deliver(force: true)
? #發(fā)布testflight測試
? testflight
end
我們在項目目錄下夺姑,用終端執(zhí)行如下命令即可:
fastlane?release
場景
隨著業(yè)務(wù)的發(fā)展墩邀,產(chǎn)品線的增加,我們需要將APP拆分為若干個基礎(chǔ)組件和業(yè)務(wù)組件盏浙,以便跨APP使用磕蒲,并且方便管理維護(hù)(這又是另外一個大的議題留潦,就不在此贅述了)。每個組件都由一個私有Pod來管理辣往,Pod的發(fā)布和更新也成為了我們?nèi)粘9ぷ鞯囊徊糠滞迷海瑢τ谶@些Pod,一般我們團隊內(nèi)部的原則是:誰制作站削,誰管理坊萝,誰發(fā)布,Pod的負(fù)責(zé)人我們內(nèi)部稱之為庫管许起,這件事也就分擔(dān)到了每個庫管身上十偶,庫管發(fā)布一個Pod的流程大約如下:
增加Podspec中的版本號
執(zhí)行pod lib lint命令進(jìn)行庫驗證
Git Commit代碼
Git Push代碼到遠(yuǎn)端
打一個Git Tag
將Tag Push到遠(yuǎn)端
執(zhí)行pod repo push命令發(fā)布庫到私有倉庫
如果只有兩三個庫的話,并且?guī)斓母骂l率較低的時候园细,每次手動來處理還好惦积。但是當(dāng)庫逐漸增多的時候這件事就變得相當(dāng)麻煩,尤其是當(dāng)頂層的庫依賴底層庫的時候猛频,那么升級一個庫狮崩,影響面將遠(yuǎn)遠(yuǎn)超過其本身,通過人工的方式處理的話鹿寻,整個過程會變得相當(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}") # 提交版本號修改
? add_git_tag(tag: target_version) # 設(shè)置 tag
? push_to_git_remote # 推送到 git 倉庫
? pod_push(path: path, repo: "GMSpecs", allow_warnings: true, sources: SOURCES) # 提交到 CocoaPods
end
我們在項目目錄下,用終端執(zhí)行如下命令即可:
fastlane do_release_lib project:GMUtil version:0.1.4
還有在安卓由于國內(nèi)Android市場眾多上經(jīng)常會遇到?多渠道打包毡熏,這里我們也使用Fastlane如何進(jìn)行處理:
Fastlane的Action機制
Fastlane本身包含兩大模塊坦敌,一個是其內(nèi)核部分,另外一個就是Action了痢法。Action是Fastlane自動化流程中的最小執(zhí)行單元狱窘,直觀上來講就是Fastfile腳本中的一個個命令,比如:git_pull财搁,deliver蘸炸,pod_install等等,而這些命令背后都對應(yīng)一個用Ruby編寫的腳本妇拯。Fastlane已經(jīng)為我們提供了現(xiàn)成的模板幻馁,即使你對Ruby的語法不熟悉洗鸵,也沒有關(guān)系越锈,F(xiàn)astlane是開源的嘛,可以直接下載源碼看看別人的Action是怎么寫的就知道了膘滨,我們可以在這個目錄下找到所有的Action文件:
fastlane/fastlane/lib/fastlane/actions/
針對pod的執(zhí)行創(chuàng)建一個action來針對下面三種情況的執(zhí)行
pod install --no-repo-update (避免master repo的每次更新耗時)
pod update --no-repo-update (避免master repo的每次更新耗時)
pod repo update XXX (私有repo的更新)
自定義Action的流程大約如下甘凭,首先,我們在終端中執(zhí)行命令:
fastlane new_action
后根據(jù)提示火邓,在命令行中敲入action的名字pod丹弱,然后Fastlane會在當(dāng)前目錄的actions文件夾中幫我們創(chuàng)建了一個pod.rb的Ruby文件德撬,內(nèi)容大致如下(省略了非重點部分):
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這個父類蜓洪。雖然模板中的內(nèi)容還挺多,不過不用擔(dān)心坯苹,大部分內(nèi)容都是一些簡單的文本描述隆檀,對于我們來說只需要重點關(guān)注這兩個方法就行:
1.self.run方法:這里放置的是實際的業(yè)務(wù)處理代碼。
2.self.available_options方法:這里聲明需要對外暴露出的參數(shù)粹湃,沒有聲明的參數(shù)在執(zhí)行過程中無法使用恐仑。
在self.available_options中進(jìn)行聲明,在self.run方法中編寫最終的業(yè)務(wù)邏輯为鳄,同時將上面的options通過params暴露出去裳仆,這樣在運行pod這個action的時候,我們就可以傳入對應(yīng)的參數(shù)孤钦,從而Fastlane可以執(zhí)行攜帶各種選項的完整命令歧斟,
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文件夾中司训,然后在該項目目錄下构捡,執(zhí)行如下命令:
fastlane action pod
首先,我們自定義一個Action:add_channels_to_apk壳猜,這個Action的作用就是:
拷貝最終打包生成的apk文件勾徽,并修改文件名為渠道名,如gengmei_qq_630.apk
然后將一個渠道名寫入到apk文件的META-INFO目錄中
其次统扳,新建一個txt文件喘帚,里面寫入所有需要打包的渠道名,如:QQ,360,Baidu...等等咒钟,渠道名之間用逗號隔開吹由。
最后,在Fastfile中定義一個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
接下來的事就簡單多了朱嘴,每次需要打包的時候倾鲫,只要執(zhí)行如下的命令即可:
fastlane do_package_apk project:Gengmei version:6.3.0
無論是5個渠道,還是50個渠道萍嬉,1分鐘內(nèi)全部搞定乌昔,非常的方便。