因為網上教程多是依靠Github，而且很多是在Jenkins中配置Xcode引數，相當的麻煩，我們是用Shell 指令碼，非常的easy。在這裡記錄下環境搭建的過程，希望能幫他人減少一點坑。

1 安裝Jenkins
Jenkins是基於Java開發的一種持續整合工具。所以呢，要使用Jenkins必須使用先安裝JDK。

1.1 JDK安裝
JDK 下載地址

安裝JDK的過程略，別說你不會安裝（如有不會安裝的，自行百度）。

1.2 Jenkins安裝
Jenkins 下載地址

安裝過程如下：

也可以下載jenkins.war, 然後執行Java -jar jenkins.war，進行安裝。

安裝完成之後，Safari可能會自動開啟，如果沒有自動開啟，開啟瀏覽器，輸入http://localhost:8080

這個時候可能會報一個錯誤。如果出現了上面的問題，原因可能是Java環境有問題，重新安裝JDK環境即可。

正常的話，應該會看到下面這個重設初始密碼的介面

注意：
1、Jenkins 安裝成功後,會建立一個Jenkins使用者，而Jenkins的工作區間預設是在【/使用者/共享/Jenkins/Home/jobs】目錄下，可以用Finder–>前往，進入。
2、Jenkins目錄下的資料夾的讀寫許可權只對Jenkins使用者開放，所以後面apple證書等必須在Jenkins使用者下安裝，專案的ipa匯出也得在Jenkins使用者下操作。（或者用管理員許可權修改該目錄針對使用者的許可權)
3、Jenkins的使用是每一個使用者都可以使用，所以有可能導致構建版本的時候報錯，還是老老實實在Jenkins使用者下操作吧。

2.設定Jenkins使用者
2.1 進入 系統偏好設定->使用者與群組
2.2 點選左下角的解鎖，輸入當前使用者的密碼
2.3 此時Jenkins使用者還是一個空的無名使用者，可以在使用者列表中選擇Jenkins使用者，右擊並選擇“高階選項”，輸入全名並確定。

2.4 點選“更改密碼”重設Jenkins使用者的密碼。為了後期方便，可勾選“執行使用者管理這臺電腦”，將Jenkins使用者設為管理員。
2.5 選擇使用者列表下方的登入選項，將自動登入使用者設為Jenkins。

3.初始化Jenkins
重啟以後，自動以Jenkins登入了。找到/Users/Shared/Jenkins/Home/ 這個目錄下，開啟initialAdminPassword檔案，複製出密碼，就可以填到網頁上去重置密碼了。如下圖

一路安裝過來，輸入使用者名稱，密碼，郵件這些，就算安裝完成了。

4.安裝外掛
正常情況下，常用的外掛都已經安裝了，如果有外掛安裝失敗或者需要特殊的外掛，可以自行安裝。

5.Xcode以及開發證書設定
因為要使用Xcode命令，所以必須保證Xcode command Line已安裝。

5.1 設定apple development 證書
在原來Xcode開發所在使用者下，匯出釋出證書，然後拷貝到Jenkins使用者環境下，雙擊安裝到Mac 的鑰匙串中。

注意：
因為使用者訪問鑰匙串中的證書需要許可權，而用jenkins構建時，不管是用Xcode外掛配置還是shell 指令碼，都不能輸入使用者密碼，所以必須設定證書的【訪問控制】為允許所有應用程式訪問此專案。

5.2 安裝mobileprovision描述檔案
同樣需要在Jenkins使用者下，安裝好打包需要的手機描述檔案。

6 配置構建專案
下面講解構建專案的配置，可以使用本地的專案，也可以使用SVN上的專案（只需要填入svn上工程地址即可），然後輸入shell 指令碼就可以開始構建了。

6.1 使用本地專案構建
步驟如下：

點選OK，在【/使用者/共享/Jenkins/Home/jobs】目錄下會生成HelloJenkins的目錄。

其他的設定項，均不用設定，只需要設定下指令碼即可，指令碼詳細的內容如下：

# 工程名
APP_NAME="HelloJenkins"
# 證書
CODE_SIGN_DISTRIBUTION="iPhone Distribution: XXXXXXXXXXXX"
# info.plist路徑
project_infoplist_path="./${APP_NAME}/Info.plist"

#取版本號
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")

#取build值
bundleVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" "${project_infoplist_path}")

DATE="$(date +%Y%m%d)"
IPANAME="${APP_NAME}_V${bundleShortVersion}_${DATE}.ipa"

echo "=================clean================="
xcodebuild -target "${APP_NAME}"  -configuration 'Release' clean

echo "+++++++++++++++++build+++++++++++++++++"
xcodebuild -target "${APP_NAME}" -sdk iphoneos -configuration 'Release' CODE_SIGN_IDENTITY="${CODE_SIGN_DISTRIBUTION}" SYMROOT='$(PWD)'

xcrun -sdk iphoneos PackageApplication "./Release-iphoneos/${APP_NAME}.app" -o ~/"${IPANAME}"

注意1：【-o ~/$IPANAME】表示匯出的ipa檔案在當前使用者的目錄下，即【/使用者/共享/Jenkins/】下。
其中CODE_SIGN_IDENTITY=”iPhone Distribution:
xxxxxxxxxx”是你打包使用的證書在鑰匙串中的常用名稱。
匯出的ipa，叫【HelloJenkins_V1.2_20160118.ipa】。

注意2：如果如上圖【配置專案第二步】那樣，在xcodeproj相同目錄下，新建一個sh指令碼檔案，用【sh
xxx.sh】命令的話，見6.3介紹。 如果你的專案中用到了cocoapods,那指令碼有幾個引數需要調整一下，詳情見下文。

注意3（2016.02.17更新）：CODE_SIGN_IDENTITY
這個屬性可以不設定，直接設定profile就可以了，編譯時會自動去匹配對應的CODE_SIGN_IDENTITY，需要注意的是設定profile時，設定的是其UUID值。例如【PROVISIONING_PROFILE=’f035763e-e847-4db8-ac10-0004809fdc90’】

點選儲存，然後點選左側選單，立即構建，即可開始構建。

6.2 使用svn地址構建
第一步，新建專案，與上面的一樣。
第二步，不用將工程拷貝到jobs目錄下了，直接在配置裡原始碼管理那一欄設定svn地址

第三步，設定shell 指令碼，與上面的一樣。
第四步，立即構建即可。

6.3 如何使用【sh jenkins.sh】
將打包指令碼寫在jenkins.sh檔案中，並將此檔案放在project根目錄，Jenkins中按下圖修改。

6.4 使用cocoapods的專案指令碼如何改
使用cocoapods後，因為啟動專案的工程檔案已經由【xxx.xcodeproj】變為【xxx.xcworkspace】,所以在build時，需要新增【-workspace】和【-scheme】，同時去掉【-target】,如果不修改這些引數，構建會報錯也會提示設定這些項。

# 工程名
APP_NAME="HelloJenkins"
# 證書
CODE_SIGN_DISTRIBUTION="iPhone Distribution: SunEee Weilian Technology Development Co., Ltd."
# info.plist路徑
project_infoplist_path="./${APP_NAME}/Info.plist"

#取版本號
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")

#取build值
bundleVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" "${project_infoplist_path}")

DATE="$(date +%Y%m%d)"
IPANAME="${APP_NAME}_V${bundleShortVersion}_${DATE}.ipa"

#要上傳的ipa檔案路徑
IPA_PATH="$HOME/${IPANAME}"
echo ${IPA_PATH}
echo "${IPA_PATH}">> text.txt

echo "=================clean================="
xcodebuild -workspace "${APP_NAME}.xcworkspace" -scheme "${APP_NAME}"  -configuration 'Release' clean

echo "+++++++++++++++++build+++++++++++++++++"
xcodebuild -workspace "${APP_NAME}.xcworkspace" -scheme "${APP_NAME}" -sdk iphoneos -configuration 'Release' CODE_SIGN_IDENTITY="${CODE_SIGN_DISTRIBUTION}" SYMROOT='$(PWD)'

xcrun -sdk iphoneos PackageApplication "./Release-iphoneos/${APP_NAME}.app" -o ~/"${IPANAME}"

6.5 新增構建後自動上傳蒲公英的指令碼

注意：最新的版本中，構建後操作步驟裡已經沒有“Execute shell”這一項了

upload.sh指令碼與上面jenkins.sh指令碼在同一目錄。
【upload.sh】內容如下：

#蒲公英上的User Key
uKey="9743f8cbe9ebef9863912a9d52ac19ce"
#蒲公英上的API Key
apiKey="0419615fa1ebbe8179ee9978abc3d753"
#要上傳的ipa檔案路徑
IPA_PATH=$(cat text.txt)

rm -rf text.txt

#執行上傳至蒲公英的命令
echo "++++++++++++++upload+++++++++++++"
curl -F "[email protected]${IPA_PATH}" -F "uKey=${uKey}" -F "_api_key=${apiKey}" http://www.pgyer.com/apiv1/app/upload

注意：指令碼中的uKey和apiKey，是自己的賬戶對應的userKey和apiKey。

上傳成功後，會返回相應的json資料。失敗提示，可以參考蒲公英官網說明。

6.6 沒有Scheme，導致無法打包
有時候會遇到專案程式碼拉下來後，執行打包指令碼會卡在xcodebuild命令下，通過xcodebuild -list命令檢視：如圖顯示no schems.

原因是本機生成的scheme，在另一臺Mac下不可用。又由於我們一般上傳SVN或git的時候會把xcuserdata檔案刪除，這樣就找不到scheme了，而用Xcode開啟一次工程之後就可以成功執行了，也就是生成了xcuserdata檔案。
具體解決看圖：將圖上按鈕全部勾選，然後xcworkspace中會生成xcshareddata檔案，好，我們需要的正是該檔案，注意將該檔案附帶工程中上傳至SVN或git，那樣在其他電腦上都可執行成功了！

注意：其實不需要將所有Scheme都共享，只需共享打包指令碼會用到的Scheme即可。

6.7 命令列呼叫code sign時報錯：User interaction is not allowed
雖然5.1設定了證書所有應用可用，但是還是可能會遇到User interaction is not allowed，這是因為Jenkins使用的是一個獨立的使用者環境。解決方法是在你的打包指令碼的簽名前加上

security unlock-keychain  -p "你的使用者密碼" ~/Library/Keychains/login.keychain

構建成功之後，這句就可以刪掉了，只需執行一次。
如果還是出錯，可以使用
security show-keychain-info ~/Library/Keychains/login.keychain
檢視一下具體情況，有可能提示
Keychain "/Users/Shared/Jenkins/Library/Keychains/login.keychain" lock-on-sleep timeout=300s，
即只有5分鐘有效。可以將時間設定長一點來解決
security set-keychain-settings -t 3600 -l ~/Library/Keychains/login.keychain

6.8 Python 字元編碼問題
如果使用到了Python指令碼，可能會遇到“UnicodeEncodeError: ‘ascii’ codec can’t encode characters ”的錯誤，可以在Python檔案的開頭加上

import sys 
reload(sys) 
sys.setdefaultencoding('utf-8')