前言

持續(xù)集成是敏捷開(kāi)發(fā)中重要的一部分，為保證新功能的開(kāi)發(fā)，又保證舊功能的維護(hù)，從一個(gè)沖刺到下個(gè)沖刺。持續(xù)集成工具是我們保證開(kāi)發(fā)和維護(hù)并行的護(hù)航者，現(xiàn)在流行的集成工具有很多，例如：

1.Jenkins

2.Buildbot

3.Travis CI

經(jīng)過(guò)對(duì)比，Jenkins工具搭建相對(duì)簡(jiǎn)單（僅指安裝），打包速度也比較快，得到很多朋友的青睞，所以本文是以描述Jenkins搭建環(huán)境為主旨。（踩了好多坑啊哈哈哈）

Jenkins 的 好處

在寫(xiě)本文之前，我覺(jué)得有必要提一下Jenkins 對(duì)一個(gè)團(tuán)隊(duì)的好處。

最簡(jiǎn)單粗暴的好處就是降低 開(kāi)發(fā)團(tuán)隊(duì)與測(cè)試團(tuán)隊(duì)的耦合，Jenkins也支持定時(shí)自動(dòng)打包，上傳等，省去了“修改配置項(xiàng)--編譯---連接設(shè)備--運(yùn)行打包--裝ipa--然后交給等待的測(cè)試人員”這些簡(jiǎn)單繁瑣的步驟。也避免測(cè)試人員測(cè)錯(cuò)包之類(lèi)，把開(kāi)發(fā)已經(jīng)修改的bug打回來(lái)這種問(wèn)題。

注意：打包ipa包需要有xcode環(huán)境，所以要想在公司的服務(wù)器配置iOS打包環(huán)境，要求服務(wù)器必須是Mac OS系統(tǒng)，Linux和Windows只能靠邊了。我是在一臺(tái)Mac mini 下配的環(huán)境。

步驟大致可以分為以下幾步：

1.搭建Java環(huán)境

2.搭建Jenkins環(huán)境

3.配置證書(shū)和描述文件、鑰匙串

4.配置項(xiàng)目

5.配置xcode 環(huán)境

1.配置java環(huán)境

瀏覽器打開(kāi) http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html? ?選擇Mac OS 的安裝包下載，JDK安裝都很簡(jiǎn)單，安裝過(guò)程這里就省略了。

JDK

2.搭建Jenkins環(huán)境

瀏覽器打開(kāi) Jenkins官網(wǎng)?點(diǎn)擊下載Jenkins，選擇Mac OS安裝包，我現(xiàn)在裝的是2.46.1

選擇jenkins安裝包

接下來(lái)就是傻瓜式的下一步安裝，這里就不一一貼圖了。

安裝完成后瀏覽器一般會(huì)自動(dòng)打開(kāi)?http://localhost:8080，如果不自動(dòng)打開(kāi)可以手動(dòng)打開(kāi)這個(gè)鏈接，然后會(huì)提下下列的錯(cuò)誤信息

unlock Jenkins

顧名思義，我們要去log路徑下取到password，輸入才能進(jìn)入Jenkins。右鍵 Finder->前往文件夾->輸入/Users/Shared/Jenkins/Home 回車(chē)后應(yīng)該看到下面

jenkins psd

看到secrets文件是有個(gè)減號(hào)的，右鍵secrets->顯示簡(jiǎn)介->共享與權(quán)限->將everyone權(quán)限改成 讀與寫(xiě)。

secret權(quán)限

雙擊點(diǎn)開(kāi)secrets之后應(yīng)該如下所示：

initialAdminPassword

同理，因?yàn)槲覀儧](méi)有initialAdminPassword的讀寫(xiě)權(quán)限是無(wú)法打開(kāi)的，右鍵 initialAdminPassword->顯示簡(jiǎn)介->everyone權(quán)限改成讀與寫(xiě)

initialAdminPassword權(quán)限

然后用文本來(lái)打開(kāi)initialAdminPassword，把里面那串?dāng)?shù)字復(fù)制，把這串?dāng)?shù)字填到Jenkins啟動(dòng)的那個(gè)頁(yè)面，如果你不小心關(guān)了上面那個(gè)頁(yè)面，打開(kāi)http://localhost:8080即可。

解鎖

然后continue，這時(shí)會(huì)看到以下頁(yè)面，選擇紅色框里的 Install suggested plugins（Jenkins建議安裝的插件）

customize Jenkins

看到這個(gè)頁(yè)面之后，等待Jenkins把插件下載完

下載插件

這里創(chuàng)建下Admin User，把這些項(xiàng)都填完之后點(diǎn)擊save and finish就OK了。注意要記得用戶名和密碼，以后你登錄要用到的，忘記密碼就麻煩了。

創(chuàng)建用戶名和密碼

ready

到這步已經(jīng)說(shuō)明Jenkins環(huán)境已經(jīng)搭建好了。點(diǎn)擊start using jenkins

進(jìn)入jenkins頁(yè)面

這時(shí)需要配置一下插件，系統(tǒng)管理->管理插件->可選插件

插件管理第一步

因?yàn)轫?xiàng)目是配置svn為管理器的，git管理代碼的可以參照其他同學(xué)的教程自行配置。我們先下載svn插件，在過(guò)濾輸入框中輸入svn，勾選 SVN Publisher plugin。點(diǎn)擊直接安裝。

插件管理-svn

同理，我們要下載 xcode integration 和keychains and Provisioning Profiles Management 這兩個(gè)插件。

插件管理-xcode integration

插件管理- keychain and profiles

把這兩個(gè)搜索出來(lái)，勾選然后直接安裝。然后等待完成

等待插件安裝完成

安裝完成后我們重啟下jenkins，重新加載下插件?？梢曰阶畹紫鹿催x重啟，或者也可以在地址欄輸入http://localhost:8080/restart??

完成安裝插件重啟Jenkins

重啟之后應(yīng)該要輸入用戶名和密碼，把剛剛注冊(cè)的用戶名密碼輸入進(jìn)去。

還有一個(gè)重要的步驟，我們先給Jenkins用戶管理員的權(quán)限，避免后續(xù)的訪問(wèn)問(wèn)題。

系統(tǒng)偏好設(shè)置->用戶與群組->點(diǎn)開(kāi)鎖，然后在Jenkins用戶下勾選“允許用戶管理這臺(tái)電腦”。

到這步最好給Jenkins用戶設(shè)置一個(gè)密碼，便于后期檢查是否Jenkins配置錯(cuò)誤或者是檢查代碼錯(cuò)誤。

Jenkins用戶權(quán)限問(wèn)題

3.配置證書(shū)和描述文件、鑰匙串

點(diǎn)擊系統(tǒng)管理->keychain and provision Profiles Management

keychain and provision

在這之前，我準(zhǔn)備了開(kāi)發(fā)證書(shū).p12 + 描述文件，生產(chǎn)證書(shū).p12 + 描述文件，分別用來(lái)上線打包和測(cè)試打包。這步并不需要我們上傳證書(shū)，而是上傳需要描述的文件和login.keychain。login.keychain有坑！有坑！有坑?。。。?！ 之前我是把login.keychian 復(fù)制到桌面然后上傳的，構(gòu)建的時(shí)候總是報(bào)錯(cuò)keychian 權(quán)限問(wèn)題。然后我是按照以下方式來(lái)做的。

配置keychain 證書(shū)和描述文件

在此之前先普及一下，jenkins其實(shí)是自己開(kāi)了一個(gè)用戶，用于存儲(chǔ)一些配置文件和信息等。我們可以在finder里面找到Jenkins用戶的文件夾，點(diǎn)擊前往上層文件夾

尋找上層文件夾

然后找到共享中的jenkins用戶

jenkins目錄

1.Finder->前往文件夾->/Users/“你的mac用戶名”/library

2.找到keychains 這個(gè)文件夾，拷貝

3.用上面那種方法放到Jenkins->Library文件夾下

拷貝keychain文件

為了避免描述文件也出現(xiàn)類(lèi)似的找不到的錯(cuò)誤，我們也把描述文件拷貝到Jenkins用戶->Library。

1.Finder->前往文件夾->/Users/“你的mac用戶名”/library（或者還有一個(gè)方法，打開(kāi)xcode->preferences->找到你賬號(hào)下的描述文件）

2.找到keychains 這個(gè)文件夾，拷貝"MobileDevice"整個(gè)文件夾

3.用上面那種方法放到Jenkins->Library文件夾下。

拷貝mobileDevice文件

接下來(lái)就是上傳keychain和描述文件了。

上傳keychain和描述文件

這里我們選剛剛拷貝過(guò)去的Jenkins文件目錄下的keychain和描述文件。點(diǎn)擊選取文件->搜索login.keychain,這里要注意下是否為Jenkins目錄下的keychain。

上傳keychain

上傳完之后打開(kāi)鑰匙串，找到我需要上傳的兩本證書(shū)的名字，因?yàn)槲蚁肷蟼饕粋€(gè)開(kāi)發(fā)證書(shū)和一個(gè)生產(chǎn)證書(shū)，所以上傳兩個(gè)。把這兩個(gè)證書(shū)的名字復(fù)制下來(lái)

證書(shū)名字

然后點(diǎn)擊 Add Code Signing Identity，分別把這兩個(gè)名字粘貼過(guò)去。完成了之后大概如下：

keychain

接下來(lái)就是描述文件了。這里要注意一點(diǎn)，在Provisioning Profiles填上/Users/Shared/Jenkins/Library/MobileDevice/Provisioning Profiles這個(gè)地址。然后按照上傳keychain的步驟，把Jenkins用戶目錄下的描述文件上傳上去就行啦

Provisioning Profile地址

完了之后是這樣的。

keychain描述文件成功圖

4.配置項(xiàng)目

keychain配置好之后，接下來(lái)就是新建一個(gè)工程了。輸入你的項(xiàng)目名稱（項(xiàng)目名稱會(huì)在Jenkins下生成一個(gè)文件夾）。構(gòu)建一個(gè)自由風(fēng)格的軟件項(xiàng)目，點(diǎn)擊ok

新建項(xiàng)目

1.General

新建完之后點(diǎn)選丟棄舊的構(gòu)建，配置一下保持構(gòu)建的天數(shù)和最大個(gè)數(shù)

配置舊的構(gòu)建

2.源碼管理

然后配置源碼管理，這是Jenkins拉取代碼的路徑（盡量精確到項(xiàng)目位置），如果Credentials沒(méi)有，則點(diǎn)擊右邊的add，填上自己的svn賬號(hào)和密碼。假如這欄沒(méi)有報(bào)紅，基本上地址什么的都是正確的了。

配置svn

3.構(gòu)建環(huán)境

接下來(lái)配置構(gòu)建環(huán)境，這里我們勾選Keychains and Code Signing Identities，選擇login.keychain，然后選擇對(duì)應(yīng)的證書(shū)名字。同樣勾選Mobile Provisioning Profiles，選擇對(duì)應(yīng)的描述文件。

構(gòu)建環(huán)境

4.構(gòu)建

因?yàn)槲翼?xiàng)目用到cocoapods，所以要先在構(gòu)建這里選執(zhí)行腳本，在里面輸入

#bin/bsah - l

export LANG=en_US.UTF-8

export LANGUAGE=en_US.UTF-8

export LC_ALL=en_US.UTF-8

cd $WORKSPACE/你的項(xiàng)目名稱

/usr/local/bin/pod update --verbose --no-repo-update

注意：沒(méi)有#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/ ?這幾句可能會(huì)造成編譯器讀不懂pod語(yǔ)句。當(dāng)你構(gòu)建的時(shí)候提示pod語(yǔ)句出錯(cuò)，百分之九十都是這個(gè)錯(cuò)誤。

創(chuàng)建腳本

輸入

接下來(lái)添加xcode構(gòu)建工具

添加xcode構(gòu)建工具

首先配置General，這里又有一個(gè)坑！?。?！輸出路徑必須是workspace路徑下的，然后會(huì)報(bào)權(quán)限不夠等之類(lèi)的問(wèn)題

xcode-general配置

之后是Code signing & OS X keychain options

Code signing & OS X keychain options

接下來(lái)是配置 Advanced Xcode build options。

tips：jenkins會(huì)在它的目錄Home->workspace下建一個(gè)文件夾，這個(gè)文件夾名字就是你的項(xiàng)目名字（比如你的項(xiàng)目名字叫JenkinsProj，那么會(huì)存在Jenkins->Home->workspace->JenkinsProj這個(gè)文件夾）。${WORKSPACE}一般都會(huì)到Jenkins創(chuàng)建的文件夾下。

Build output diretory 還是老實(shí)點(diǎn)寫(xiě)在workspace下比較好，因?yàn)镴enkins創(chuàng)建的目錄我覺(jué)得足夠清晰了。之前我寫(xiě)在另一個(gè)用戶下就會(huì)報(bào)權(quán)限問(wèn)題。

advance配置

一般這樣配置完就可以成功打包了，在整個(gè)配置過(guò)程中，都不能粗心大意或者自以為是的隨意配置?？赡芪恼逻€有寫(xiě)的不夠的地方或者錯(cuò)誤的地方，歡迎大家指正完善。也希望大家把遇到的問(wèn)題多多分享一下~

錯(cuò)誤大全

1.鑰匙串的錯(cuò)誤

類(lèi)似下面的鑰匙串錯(cuò)誤，我給大家個(gè)tips：

1、鑰匙串無(wú)非是兩個(gè)地方設(shè)置和用到，分別為系統(tǒng)管理->Keychains and Provisioning Profiles Management 和 項(xiàng)目配置里面->構(gòu)建環(huán)境下的Keychains and Code Signing Identities 這兩個(gè)地方去找，看有沒(méi)有不匹配的地方，或者按照上面說(shuō)到的相應(yīng)步驟重新來(lái)。

鑰匙串錯(cuò)誤

2.cocoapods錯(cuò)誤

類(lèi)似下面的錯(cuò)誤，一般先要檢查項(xiàng)目配置里面->構(gòu)建->Execute shell 有沒(méi)有寫(xiě)錯(cuò)。

#bin/bsah - l

export LANG=en_US.UTF-8

export LANGUAGE=en_US.UTF-8

export LC_ALL=en_US.UTF-8

cd $WORKSPACE/你的項(xiàng)目文件

/usr/local/bin/pod update --verbose --no-repo-update

如果這樣寫(xiě)還不行，mac注銷(xiāo)當(dāng)前用戶，進(jìn)入Jenkins用戶，看是否安裝了cocoapods，如果沒(méi)有安裝，需要安裝一下，并且版本要與當(dāng)前用戶一致（Jenkins用戶的密碼可以在系統(tǒng)偏好設(shè)置->用戶與群組設(shè)置。）

cocoapods錯(cuò)誤

3.Xcode終止打包

遇到Xcode終止打包這時(shí)進(jìn)入Jenkins用戶，在Jenkins下編譯看有沒(méi)有問(wèn)題。如果有問(wèn)題，這時(shí)候就要檢查下你svn上的項(xiàng)目是否正確了。

4.scheme錯(cuò)誤

打開(kāi)Xcode->manageSchema，把share勾上

大家可以把遇到的問(wèn)題留言，我們共同解決