關於iOS自動化構建其實並不複雜，通過一些簡單的Git與Xcode指令，加上UI，我們自己也可以動手編寫一款自動化構建工具。這在之前的部落格中也有涉及，有興趣的朋友可以在如下地址找到這篇部落格：

       本篇部落格主要記錄使用Jenkins搭建iOS自動化構建專案的過程，關於Jenkins的更多自動化指令碼的應用，有機會後面再出專門的部落格介紹。

一、Jenkins的安裝與啟動

    Jenkins的安裝非常方面，在如下官網可以直接下載Jenkins的安裝包，其中有支援各個平臺的安裝包，選擇自己所需要的進行下載安裝即可。

   安裝完成後，Jenkins會自動啟動執行，在當前電腦的8080埠開啟一個Web應用服務，如果是第一次安裝啟動，我們需要配置一個賬戶作為初始使用者。

   對於在Mac上Jenkins的啟動，有兩種方式：

方式一：直接執行Java歸檔檔案啟動Jenkins

    如果是Mac電腦，Jenkins安裝完成後，在Applications目錄下會多出一個Jenkins資料夾，這個資料夾中包含一個jenkins.war的檔案，如下圖所示：

使用如下命令來啟動Jenkins：

java -jar /Applications/Jenkins/jenkins.war

使用這種方式啟動的Jenkins，要關閉服務需要找到Jenkins服務對應的PID，在終端輸入如下命令:

ps

在終端輸出的資訊中，可以看到Jenkins服務所對應的PID號，如下圖：

終端使用如下命令將此服務殺死即可：

kill -9 PID號

方式二：使用Mac的啟動進行控制器啟動Jenkins

    如果成功安裝了Jenkins，在Mac電腦磁碟的資源庫中的LaunchDaemons資料夾下可以找到Jenkins的啟動配置檔案，如下圖：

在命令列中執行如下命令即可啟動Jenkins服務：

sudo launchctl load /Library/LaunchDaemons/org.jenkins-ci.plist

使用如下命令關閉Jenkins服務：

sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist
 

二、建立持續整合專案

    在Jenkins的主頁選擇新建一個專案，建立選項中，我們輸入專案名稱，並選擇構建一個自由風格的軟體，如下圖：

下一步將進入到專案配置介面，首先需要設定下通用的配置，如下圖：

其中，描述部分可以填寫專案的相關介紹，丟棄舊的構建設定構建記錄儲存的天數和最多保持多少個構建記錄等。

    原始碼管理的配置是比較重要的一步，其用來設定構建專案從哪裡拉取專案的原始碼以及進行原始碼更新的操作。如下圖：

如果使用的是Git倉庫，如上圖所示，需要配置專案的路徑，賬戶以及要進行構建的分支。賬戶的主要用途是使得Jenkins有許可權拉取專案的程式碼，如果之前沒有新增過，可以點選右側的Add按鈕進行新增，如下圖：

可以選擇配置使用者名稱加密碼的方式新增賬戶，也可以使用SSH公鑰的方式。

    下一步我們需要配置構建的觸發器，構建觸發器有多種形式，比如定時觸發構建，遠端觸發，程式碼提交後觸發等等，如下圖：

其中遠端觸發是指我們可以通過遠端訪問Jenkins伺服器地址加上令牌引數來觸發構建。

之後再構建一欄中選擇增加構建步驟->執行Shell，新增如下Shell指令碼：

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8
/usr/local/bin/pod install
xcodebuild -archivePath "/Users/Shared/Jenkins/Home/workspace/Jenkins專案名稱/你的專案名.xcarchive" -workspace 你的專案名.xcworkspace -sdk iphoneos -scheme "你的專案名" -configuration "Release" archive

xcodebuild -exportArchive -archivePath "/Users/Shared/Jenkins/Home/workspace/Jenkins專案名稱/你的專案名.xcarchive" -exportPath "/Users/Shared/Jenkins/Home/workspace/Jenkins專案名稱/buildIPA" -exportOptionsPlist '/Users/Shared/Jenkins/Home/workspace/Tictalk-iOS/ExportOptions.plist' -allowProvisioningUpdates
curl -F "[email protected]/Users/Shared/Jenkins/Home/workspace/Jenkins專案名稱/buildIPA/你的專案名.ipa"

上面指令碼中，xcodebuild -archivePath 命令用來編譯專案，如果你的專案沒有使用workspace，需要將命令中的workspace修改成project，configuration引數用來配置編輯的方式，Release為釋出環境。xcodebuild -exportArchive 命令用來到處API包，需要額外注意，提前我們需要在/Users/Shared/Jenkins/Home/workspace/Jenkins專案名稱/你的專案名這個目錄下新增一個ExportOptions.plist檔案，新Xcode如果不配置這個檔案是無法打包成功的。curl -F 命令是用來將打包好的IPA包自動上傳到蒲公英分發平臺。

    ExportOptions.plist檔案編寫格式如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>compileBitcode</key>
	<false/>
	<key>method</key>
	<string>ad-hoc(IPA包模式)</string>
	<key>provisioningProfiles</key>
	<dict>(下面設定bundleID對應的provisioningProfiles檔名)
		<key>com.***</key>
		<string>AD_HOC</string>
		<key>com.***.TKNotificationCentent</key>
		<string>Content</string>
		<key>com.***.TKNotificationService</key>
		<string>Service</string>
	</dict>(下面配置證書)
	<key>signingCertificate</key>
	<string>iPhone Distribution</string>
	<key>signingStyle</key>
	<string>manual</string>
	<key>stripSwiftSymbols</key>
	<true/>(下面配置teamID)
	<key>teamID</key>
	<string>KJYHPT****</string>
	<key>thinning</key>
	<string><none></string>
</dict>
</plist>

三、構建可能出錯的地方

    配置完了上面的指令碼，你可以嘗試點選立即構建按鈕進行構建，當然構建過程中極有可能會出錯，你可以根據log輸出檢查下是否是因為下面的問題。

1.git相關命令出錯

    可能是Jenkins找不到git所在位置，在Jenkins的系統設定中選擇全域性工具配置，配置git路徑如下圖所示：

2.pod相關命令出錯

   這一步出錯的可能性極大，首先你的電腦可以使用pod不代表jenkins使用者有使用pod的許可權，最好使用jenkins使用者登入電腦，進行pod的更新升級，或者直接使用jenkins使用者登入，找到我們的專案，手動使用pod進行第三方的安裝。

3.xcodebuild相關命令出錯

    和git命令出錯的問題基本一致，我們需要配置路徑。在Jenkins的系統設定中找到系統配置，設定xcode相關工具如下：

4.編譯過程中證書或配置檔案出錯

    首先確保你的應用證書放在了鑰匙串的系統分類下，如圖：

其次，需要將Provisioning Profiles檔案複製到下面的目錄下，切記：

/Users/Shared/Jenkins/Library/MobileDevice/Provisioning Profiles

最後，請確認可以使用Xcode手動進行編輯和打包。而且證書和Provisioning Profiles檔案一定要正確和匹配。