前言

由于工作原因，近期項目需要集成Jenkins 。因此參考了網上很多的資料，但是發現網上的資料都不是很全面，都有或多或少的坑，所以在此我根據我自己個人配置的經驗總結一下Jenkins具體的安裝及使用（如果有什么錯誤的地方請留言指正，謝謝。）。

本文內容部分摘自：http://www.lxweimin.com/p/7a2efc7c69fe ? ? ? ? ?http://www.cocoachina.com/ios/20160804/17281.html。

Jenkins的主要作用及特點：

作用：

1.? ? ? 持續、自動地構建/測試軟件項目。

2. ? ? ?監控一些定時執行的任務。

特點：

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

2.??????易于配置-所有配置都是通過其提供的web界面實現。? ? 集成RSS/E-mail通過RSS發布構建結果或當構建完成時通過e-mail通知。

3.??????生成JUnit/TestNG測試報告。

4.??????分布式構建支持Jenkins能夠讓多臺計算機一起構建/測試。

5.??????文件識別:Jenkins能夠跟蹤哪次構建生成哪些jar，哪次構建使用哪個版本的jar等。

6.??????插件支持:支持擴展插件，你可以開發適合自己團隊使用的工具。

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

1.搭建Jenkins環境

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

3.配置項目

4.配置xcode 環境

5.構建后操作

1. 搭建Jenkins 環境

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

安裝完成之后，Safari可能會自動打開，如果沒有自動打開，打開瀏覽器，輸入http://localhost:8080?（這個時候可能會打不開網頁 ?請關閉防火墻開放8080端口）

這個時候如果你重啟電腦會發現Jenkins給你新增了一個用戶，名字就叫Jenkins，不過這個時候你不知道密碼。你可能會去試密碼，肯定是是不對的，因為初始密碼很復雜。這個時候正確做法是打開http://localhost:8080 會出現下圖的重設初始密碼的界面。

按照提示，找到/Users/Shared/Jenkins/Home/ 這個目錄下，這個目錄雖然是共享目錄，但是有權限的，非Jenkins用戶/secrets/目錄是沒有讀寫權限的。

打開initialAdminPassword文件，復制出密碼，就可以填到網頁上去重置密碼了。如下圖

到這一步 Jenkins 已經安裝完成了。

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

這時需要安裝配置一下插件，系統管理->管理插件->可選插件

安裝GitLab插件

因為我們用的是GitLab來管理源代碼，Jenkins本身并沒有自帶GitLab插件，所以我們需要依次選擇 系統管理->管理插件，在“可選插件”中選中“GitLab Plugin”和“Gitlab Hook Plugin”這兩項，然后安裝。

安裝Xcode插件

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

安裝Keychains and Provisioning Profiles Management 插件

因為我們打包需要證書和描述文件，所以需要安裝Keychains and Provisioning Profiles Management插件 依然選擇系統管理->管理插件，在“可選插件”中選中“Keychains and Provisioning Profiles Management”安裝。

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

重啟之后應該要輸入用戶名和密碼，把剛剛注冊的用戶名密碼輸入進去。還有一個重要的步驟，我們先給Jenkins用戶管理員的權限，避免后續的訪問問題。系統偏好設置->用戶與群組->點開鎖，然后在Jenkins用戶下勾選“允許用戶管理這臺電腦”。到這步最好給Jenkins用戶設置一個密碼，便于后期檢查是否Jenkins配置錯誤或者是檢查代碼錯誤。

接下來我們配置證書、描述文件、鑰匙串

點擊系統管理->keychain and provision Profiles Management

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

之前說過，系統自動生成了一個Jenkins用戶? 這個Jenkins 用于存儲一些配置文件和信息等。我們可以在finder里面找到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用戶目錄下的描述文件上傳上去就行啦?

下圖就是傳完大概的樣子

3. 配置項目

keychain配置好之后，接下來就是新建一個工程了。輸入你的項目名稱（項目名稱會在Jenkins下生成一個文件夾）。構建一個自由風格的軟件項目，點擊ok

1.General

新建完之后點選丟棄舊的構建，配置一下保持構建的天數和最大個數

2.源碼管理

然后配置源碼管理，這是Jenkins拉取代碼的地址（盡量精確到項目位置），如果Credentials沒有，則點擊右邊的add

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

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

/Users/{username}/.ssh/id_rsa

如果紅色報錯的話，請核對Git地址和私鑰或用戶密碼對應。

Branch Specifier (blank for 'any')：默認是master，你可以根據實際情況進行編輯。

3.構建觸發器

可以選擇某種情況下觸發項目構建，也可以不選。

4.構建環境

接下來配置構建環境，這里我們勾選Keychains and Code Signing Identities，選擇login.keychain，然后選擇對應的證書名字。同樣勾選Mobile Provisioning Profiles，選擇對應的描述文件。

5.構建

這里需要注意，如果你的項目是使用了cocoapods管理第三方庫的話，這里需要增加一個腳本執行的步驟：Execute shell -> Xcode（即下一步驟） ,順序不能錯。這是因為，新版本的Xcode不能直接構建.xcworksapce項目，需要使用腳本。（PS：如果不是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語句出錯，百分之九十都是這個錯誤。

坑提示：如果報錯 如下圖

mac注銷當前用戶，進入Jenkins用戶，看是否安裝了cocoapods，如果沒有安裝，需要安裝一下，并且版本要與當前用戶一致（Jenkins用戶的密碼可以在系統偏好設置->用戶與群組設置。）

接下來構建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創建的目錄我覺得足夠清晰了。之前我寫在另一個用戶下就會報權限問題。

注意：這個選項使用目錄系統已經定位到 Jenkins目錄下 。

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

5.構建后操作 ?

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