前言

由于工作原因，近期項(xiàng)目需要集成Jenkins 。因此參考了網(wǎng)上很多的資料，但是發(fā)現(xiàn)網(wǎng)上的資料都不是很全面，都有或多或少的坑，所以在此我根據(jù)我自己個(gè)人配置的經(jīng)驗(yàn)總結(jié)一下Jenkins具體的安裝及使用（如果有什么錯(cuò)誤的地方請(qǐng)留言指正，謝謝。）。

本文內(nèi)容部分摘自：http://m.itdecent.cn/p/7a2efc7c69fe ? ? ? ? ?http://www.cocoachina.com/ios/20160804/17281.html。

Jenkins的主要作用及特點(diǎn)：

作用：

1.? ? ? 持續(xù)、自動(dòng)地構(gòu)建/測(cè)試軟件項(xiàng)目。

2. ? ? ?監(jiān)控一些定時(shí)執(zhí)行的任務(wù)。

特點(diǎn)：

1.? ? ? 易于安裝-只要把jenkins.war部署到servlet容器，不需要數(shù)據(jù)庫(kù)支持。

2.??????易于配置-所有配置都是通過(guò)其提供的web界面實(shí)現(xiàn)。? ? 集成RSS/E-mail通過(guò)RSS發(fā)布構(gòu)建結(jié)果或當(dāng)構(gòu)建完成時(shí)通過(guò)e-mail通知。

3.??????生成JUnit/TestNG測(cè)試報(bào)告。

4.??????分布式構(gòu)建支持Jenkins能夠讓多臺(tái)計(jì)算機(jī)一起構(gòu)建/測(cè)試。

5.??????文件識(shí)別:Jenkins能夠跟蹤哪次構(gòu)建生成哪些jar，哪次構(gòu)建使用哪個(gè)版本的jar等。

6.??????插件支持:支持?jǐn)U展插件，你可以開(kāi)發(fā)適合自己團(tuán)隊(duì)使用的工具。

配置Jenkins ?大概需要以下幾步

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

2.安裝插件 、 配置證書(shū)和描述文件、鑰匙串

3.配置項(xiàng)目

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

5.構(gòu)建后操作

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

從官網(wǎng)https://jenkins.io/上下載最新的pkg安裝包，選擇 MAC OS。

安裝完成之后，Safari可能會(huì)自動(dòng)打開(kāi)，如果沒(méi)有自動(dòng)打開(kāi)，打開(kāi)瀏覽器，輸入http://localhost:8080?（這個(gè)時(shí)候可能會(huì)打不開(kāi)網(wǎng)頁(yè) ?請(qǐng)關(guān)閉防火墻開(kāi)放8080端口）

這個(gè)時(shí)候如果你重啟電腦會(huì)發(fā)現(xiàn)Jenkins給你新增了一個(gè)用戶，名字就叫Jenkins，不過(guò)這個(gè)時(shí)候你不知道密碼。你可能會(huì)去試密碼，肯定是是不對(duì)的，因?yàn)槌跏济艽a很復(fù)雜。這個(gè)時(shí)候正確做法是打開(kāi)http://localhost:8080 會(huì)出現(xiàn)下圖的重設(shè)初始密碼的界面。

按照提示，找到/Users/Shared/Jenkins/Home/ 這個(gè)目錄下，這個(gè)目錄雖然是共享目錄，但是有權(quán)限的，非Jenkins用戶/secrets/目錄是沒(méi)有讀寫(xiě)權(quán)限的。

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

到這一步 Jenkins 已經(jīng)安裝完成了。

2. 安裝插件 、 配置證書(shū)和描述文件、鑰匙串

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

安裝GitLab插件

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

安裝Xcode插件

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

安裝Keychains and Provisioning Profiles Management 插件

因?yàn)槲覀兇虬枰C書(shū)和描述文件，所以需要安裝Keychains and Provisioning Profiles Management插件 依然選擇系統(tǒng)管理->管理插件，在“可選插件”中選中“Keychains and Provisioning Profiles Management”安裝。

安裝完成后我們重啟下jenkins，重新加載下插件。可以滑到最底下勾選重啟，或者也可以在地址欄輸入http://localhost:8080/restart

重啟之后應(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ò)誤。

接下來(lái)我們配置證書(shū)、描述文件、鑰匙串

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

這里需要注意的是 ：上傳的不是證書(shū)，需要的是描述文件和login.keychain ?

之前說(shuō)過(guò)，系統(tǒng)自動(dòng)生成了一個(gè)Jenkins用戶? 這個(gè)Jenkins 用于存儲(chǔ)一些配置文件和信息等。我們可以在finder里面找到Jenkins用戶的文件夾

下面

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

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

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

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

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

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

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

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

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

上傳完之后打開(kāi)鑰匙串，找到需要上傳證書(shū)的名字 然后復(fù)制下來(lái)?

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

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

下圖就是傳完大概的樣子

3. 配置項(xiàng)目

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

1.General

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

2.源碼管理

然后配置源碼管理，這是Jenkins拉取代碼的地址（盡量精確到項(xiàng)目位置），如果Credentials沒(méi)有，則點(diǎn)擊右邊的add

Repository URL 可以使用 HTTP 或 SSH 兩種形式的，這里需要注意，如果是采用 HTTP 形式的話，后面配置 Credentials 需要選擇 Username with password 項(xiàng)，輸入登錄用戶名和密碼：

如果是采用 SSH 形式的話（不要ssh://前綴），后面配置 Credentials 需要選擇 SSH Username with private key 項(xiàng)，輸入用戶名（隨便輸入）和與Git上公鑰對(duì)應(yīng)的私鑰：

/Users/{username}/.ssh/id_rsa

如果紅色報(bào)錯(cuò)的話，請(qǐng)核對(duì)Git地址和私鑰或用戶密碼對(duì)應(yīng)。

Branch Specifier (blank for 'any')：默認(rèn)是master，你可以根據(jù)實(shí)際情況進(jìn)行編輯。

3.構(gòu)建觸發(fā)器

可以選擇某種情況下觸發(fā)項(xiàng)目構(gòu)建，也可以不選。

4.構(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)的描述文件。

5.構(gòu)建

這里需要注意，如果你的項(xiàng)目是使用了cocoapods管理第三方庫(kù)的話，這里需要增加一個(gè)腳本執(zhí)行的步驟：Execute shell -> Xcode（即下一步驟） ,順序不能錯(cuò)。這是因?yàn)椋掳姹镜腦code不能直接構(gòu)建.xcworksapce項(xiàng)目，需要使用腳本。（PS：如果不是cocoapods管理的可以直接跳過(guò)這步）

#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ò)誤。

坑提示：如果報(bào)錯(cuò) 如下圖

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

接下來(lái)構(gòu)建Xcode

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

之后是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)題。

注意：這個(gè)選項(xiàng)使用目錄系統(tǒng)已經(jīng)定位到 Jenkins目錄下 。

一般這樣配置完就可以成功打包了。

5.構(gòu)建后操作 ?

文檔 ?blog.fir.im/jenkins/? ? 詳細(xì)講解了 如何打包生成二維碼