前言
持續集成是敏捷開發中重要的一部分,為保證新功能的開發,又保證舊功能的維護,從一個沖刺到下個沖刺。持續集成工具是我們保證開發和維護并行的護航者,現在流行的集成工具有很多,例如:
1.Jenkins
2.Buildbot
經過對比,Jenkins工具搭建相對簡單(僅指安裝),打包速度也比較快,得到很多朋友的青睞,所以本文是以描述Jenkins搭建環境為主旨。(踩了好多坑啊哈哈哈)
Jenkins 的 好處
在寫本文之前,我覺得有必要提一下Jenkins 對一個團隊的好處。
最簡單粗暴的好處就是降低 開發團隊與測試團隊的耦合,Jenkins也支持定時自動打包,上傳等,省去了“修改配置項--編譯---連接設備--運行打包--裝ipa--然后交給等待的測試人員”這些簡單繁瑣的步驟。也避免測試人員測錯包之類,把開發已經修改的bug打回來這種問題。
注意:打包ipa包需要有xcode環境,所以要想在公司的服務器配置iOS打包環境,要求服務器必須是Mac OS系統,Linux和Windows只能靠邊了。我是在一臺Mac mini 下配的環境。
步驟大致可以分為以下幾步:
1.搭建Java環境
2.搭建Jenkins環境
3.配置證書和描述文件、鑰匙串
4.配置項目
5.配置xcode 環境
1.配置java環境
瀏覽器打開 http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html? ?選擇Mac OS 的安裝包下載,JDK安裝都很簡單,安裝過程這里就省略了。
2.搭建Jenkins環境
瀏覽器打開 Jenkins官網?點擊下載Jenkins,選擇Mac OS安裝包,我現在裝的是2.46.1
接下來就是傻瓜式的下一步安裝,這里就不一一貼圖了。
安裝完成后瀏覽器一般會自動打開?http://localhost:8080,如果不自動打開可以手動打開這個鏈接,然后會提下下列的錯誤信息
顧名思義,我們要去log路徑下取到password,輸入才能進入Jenkins。右鍵 Finder->前往文件夾->輸入/Users/Shared/Jenkins/Home 回車后應該看到下面
看到secrets文件是有個減號的,右鍵secrets->顯示簡介->共享與權限->將everyone權限改成 讀與寫。
雙擊點開secrets之后應該如下所示:
同理,因為我們沒有initialAdminPassword的讀寫權限是無法打開的,右鍵 initialAdminPassword->顯示簡介->everyone權限改成讀與寫
然后用文本來打開initialAdminPassword,把里面那串數字復制,把這串數字填到Jenkins啟動的那個頁面,如果你不小心關了上面那個頁面,打開http://localhost:8080即可。
然后continue,這時會看到以下頁面,選擇紅色框里的 Install suggested plugins(Jenkins建議安裝的插件)
看到這個頁面之后,等待Jenkins把插件下載完
這里創建下Admin User,把這些項都填完之后點擊save and finish就OK了。注意要記得用戶名和密碼,以后你登錄要用到的,忘記密碼就麻煩了。
到這步已經說明Jenkins環境已經搭建好了。點擊start using jenkins
這時需要配置一下插件,系統管理->管理插件->可選插件
因為項目是配置svn為管理器的,git管理代碼的可以參照其他同學的教程自行配置。我們先下載svn插件,在過濾輸入框中輸入svn,勾選 SVN Publisher plugin。點擊直接安裝。
同理,我們要下載 xcode integration 和keychains and Provisioning Profiles Management 這兩個插件。
把這兩個搜索出來,勾選然后直接安裝。然后等待完成
安裝完成后我們重啟下jenkins,重新加載下插件??梢曰阶畹紫鹿催x重啟,或者也可以在地址欄輸入http://localhost:8080/restart??
重啟之后應該要輸入用戶名和密碼,把剛剛注冊的用戶名密碼輸入進去。
還有一個重要的步驟,我們先給Jenkins用戶管理員的權限,避免后續的訪問問題。
系統偏好設置->用戶與群組->點開鎖,然后在Jenkins用戶下勾選“允許用戶管理這臺電腦”。
到這步最好給Jenkins用戶設置一個密碼,便于后期檢查是否Jenkins配置錯誤或者是檢查代碼錯誤。
3.配置證書和描述文件、鑰匙串
點擊系統管理->keychain and provision Profiles Management
在這之前,我準備了開發證書.p12 + 描述文件,生產證書.p12 + 描述文件,分別用來上線打包和測試打包。這步并不需要我們上傳證書,而是上傳需要描述的文件和login.keychain。login.keychain有坑!有坑!有坑?。。。?! 之前我是把login.keychian 復制到桌面然后上傳的,構建的時候總是報錯keychian 權限問題。然后我是按照以下方式來做的。
在此之前先普及一下,jenkins其實是自己開了一個用戶,用于存儲一些配置文件和信息等。我們可以在finder里面找到Jenkins用戶的文件夾,點擊前往上層文件夾
然后找到共享中的jenkins用戶
1.Finder->前往文件夾->/Users/“你的mac用戶名”/library
2.找到keychains 這個文件夾,拷貝
3.用上面那種方法放到Jenkins->Library文件夾下
為了避免描述文件也出現類似的找不到的錯誤,我們也把描述文件拷貝到Jenkins用戶->Library。
1.Finder->前往文件夾->/Users/“你的mac用戶名”/library(或者還有一個方法,打開xcode->preferences->找到你賬號下的描述文件)
2.找到keychains 這個文件夾,拷貝"MobileDevice"整個文件夾
3.用上面那種方法放到Jenkins->Library文件夾下。
接下來就是上傳keychain和描述文件了。
這里我們選剛剛拷貝過去的Jenkins文件目錄下的keychain和描述文件。點擊選取文件->搜索login.keychain,這里要注意下是否為Jenkins目錄下的keychain。
上傳完之后打開鑰匙串,找到我需要上傳的兩本證書的名字,因為我想上傳一個開發證書和一個生產證書,所以上傳兩個。把這兩個證書的名字復制下來
然后點擊 Add Code Signing Identity,分別把這兩個名字粘貼過去。完成了之后大概如下:
接下來就是描述文件了。這里要注意一點,在Provisioning Profiles填上/Users/Shared/Jenkins/Library/MobileDevice/Provisioning Profiles這個地址。然后按照上傳keychain的步驟,把Jenkins用戶目錄下的描述文件上傳上去就行啦
完了之后是這樣的。
4.配置項目
keychain配置好之后,接下來就是新建一個工程了。輸入你的項目名稱(項目名稱會在Jenkins下生成一個文件夾)。構建一個自由風格的軟件項目,點擊ok
1.General
新建完之后點選丟棄舊的構建,配置一下保持構建的天數和最大個數
2.源碼管理
然后配置源碼管理,這是Jenkins拉取代碼的路徑(盡量精確到項目位置),如果Credentials沒有,則點擊右邊的add,填上自己的svn賬號和密碼。假如這欄沒有報紅,基本上地址什么的都是正確的了。
3.構建環境
接下來配置構建環境,這里我們勾選Keychains and Code Signing Identities,選擇login.keychain,然后選擇對應的證書名字。同樣勾選Mobile Provisioning Profiles,選擇對應的描述文件。
4.構建
因為我項目用到cocoapods,所以要先在構建這里選執行腳本,在里面輸入
#bin/bsah - l
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8
cd $WORKSPACE/你的項目名稱
/usr/local/bin/pod update --verbose --no-repo-update
注意:沒有#bin/bsah - l
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8 ? /usr/local/bin/ ?這幾句可能會造成編譯器讀不懂pod語句。當你構建的時候提示pod語句出錯,百分之九十都是這個錯誤。
接下來添加xcode構建工具
首先配置General,這里又有一個坑?。。?!輸出路徑必須是workspace路徑下的,然后會報權限不夠等之類的問題
之后是Code signing & OS X keychain options
接下來是配置 Advanced Xcode build options。
tips:jenkins會在它的目錄Home->workspace下建一個文件夾,這個文件夾名字就是你的項目名字(比如你的項目名字叫JenkinsProj,那么會存在Jenkins->Home->workspace->JenkinsProj這個文件夾)。${WORKSPACE}一般都會到Jenkins創建的文件夾下。
Build output diretory 還是老實點寫在workspace下比較好,因為Jenkins創建的目錄我覺得足夠清晰了。之前我寫在另一個用戶下就會報權限問題。
一般這樣配置完就可以成功打包了,在整個配置過程中,都不能粗心大意或者自以為是的隨意配置??赡芪恼逻€有寫的不夠的地方或者錯誤的地方,歡迎大家指正完善。也希望大家把遇到的問題多多分享一下~
錯誤大全
1.鑰匙串的錯誤
類似下面的鑰匙串錯誤,我給大家個tips:
1、鑰匙串無非是兩個地方設置和用到,分別為系統管理->Keychains and Provisioning Profiles Management 和 項目配置里面->構建環境下的Keychains and Code Signing Identities 這兩個地方去找,看有沒有不匹配的地方,或者按照上面說到的相應步驟重新來。
2.cocoapods錯誤
類似下面的錯誤,一般先要檢查項目配置里面->構建->Execute shell 有沒有寫錯。
#bin/bsah - l
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8
cd $WORKSPACE/你的項目文件
/usr/local/bin/pod update --verbose --no-repo-update
如果這樣寫還不行,mac注銷當前用戶,進入Jenkins用戶,看是否安裝了cocoapods,如果沒有安裝,需要安裝一下,并且版本要與當前用戶一致(Jenkins用戶的密碼可以在系統偏好設置->用戶與群組設置。)
3.Xcode終止打包
遇到Xcode終止打包這時進入Jenkins用戶,在Jenkins下編譯看有沒有問題。如果有問題,這時候就要檢查下你svn上的項目是否正確了。
4.scheme錯誤
打開Xcode->manageSchema,把share勾上
大家可以把遇到的問題留言,我們共同解決