持續集成指的是,頻繁地(一天多次)將代碼集成到主干。它的好處主要有兩個。
(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分鐘內全部搞定,非常的方便。