強烈建議一定要在網(wǎng)絡(luò)好的情況下配置,并且最好能上外網(wǎng),不然折磨死你!
為什么寫這篇文章了,因為到目前為止我還沒看到一篇完善靠譜的iOS Jenkins配置文章。
首先我這里安裝配置Jenkins都是使用Homebrew。
Homebrew是一款Mac OS平臺下的軟件包管理工具. 官網(wǎng)這里 Homebrew
安裝以及操作步驟
- 1.安裝
Homebrew - 2.使用
Homebrew安裝Jenkins - 3.安裝
Jenkins插件 - 4.配置證書
- 5.創(chuàng)建項目配置
- 6.腳本配置
- 7.項目打包
1.1 安裝Homebrew,在終端運行以下指令安裝
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
安裝成功后顯示
==> Installation successful!
==> Homebrew has enabled anonymous aggregate formulae and cask analytics.
Read the analytics documentation (and how to opt-out) here:
https://docs.brew.sh/Analytics
No analytics data has been sent yet (or will be during this `install` run).
==> Homebrew is run entirely by unpaid volunteers. Please consider donating:
https://github.com/Homebrew/brew#donations
==> Next steps:
- Run `brew help` to get started
- Further documentation:
[https://docs.brew.sh](https://docs.brew.sh)
執(zhí)行 brew -v 來查看安裝版本
brew -v
顯示如下則說明Homebrew安裝成功
Homebrew 2.5.9-48-gf2d46ef
Homebrew/homebrew-core (git revision cb8d; last commit 2020-11-11)
edison@192 ~ %
如果已經(jīng)安裝的則建議更新一下Homebrew,運行以下指令更新
brew update
2.1 通過Homebrew安裝Jenkins
這里需要注意:
因為安裝Jenkins需要依賴jdk,所以當我們用最新的Homebrew來安裝Jenkins時會默認先安裝 jdk 11版本
來源看這里 https://formulae.brew.sh/formula/jenkins
但是如果我們的項目是在gitlab上開發(fā),那么我們在Jenkins里需要安裝gitlab相關(guān)插件,gitlab需要依賴ruby-runtime。但是目前ruby-runtime是不支持jdk 11的。
這就是為什么你按照其他的教程來安裝Jenkins時,教程里告訴你需要先安裝jdk,然后你安裝jdk 8的版本后,再用Homebrew來安裝Jenkins時,結(jié)果在安裝gitlab插件時,安裝ruby-runtime一直顯示錯誤
java.lang.RuntimeException: unsupported Java version: 11
所以你以為自己安裝了jdk 8,其實Homebrew已經(jīng)重新下載了一份jdk 11文件,并和Jenkins形成了依賴關(guān)系。
說了這么多,怎么解決呢?
在你已經(jīng)安裝Homebrew的情況下,并且還沒安裝Jenkins時,先全局搜索Jenkins,找到如下兩個文件

這兩個文件是你安裝Jenkins時配置jdk的文件。
把里面openjdk@11 改成openjdk@8,
java_version: “11” 改成java_version: “8”,

這樣一改那么你在下載Jenkins時就會默認下載jdk 8,注意兩個文件都要改好后保存。
接下來安裝Jenkins,終端執(zhí)行命令安裝Jenkins
brew install jenkins-lts
安裝完成后會出現(xiàn)
==> jenkins-lts
Note: When using launchctl the port will be 8080.
To have launchd start jenkins-lts now and restart at login:
brew services start jenkins-lts
Or, if you don't want/need a background service you can just run:
jenkins-lts
安裝完成后啟動Jenkins
brew services start jenkins-lts
注意我們這里的jenkins-lts就相當于Jenkins命令,這是官方提供的一種安裝方式
所以當你用jenkins-lts命令安裝后,執(zhí)行Jenkins命令就無效
官網(wǎng)這里 https://www.jenkins.io/download/lts/macos/
有些博客上是寫Jenkins來啟動服務(wù) (在這里就是jenkins-lts命令了)
但是直接用Jenkins命令啟動服務(wù),這樣就會導(dǎo)致你每次重啟瀏覽器都要執(zhí)行這個命令,不然就會報你的登錄名和密碼錯誤。
所以建議使用brew services start jenkins-lts來啟動Jenkins服務(wù),這樣不必每次都要執(zhí)行命令來啟動Jenkins
啟動Jenkins后再瀏覽器輸入以下地址
http://localhost:8080
打開之后就會出現(xiàn)

此時說明Jenkins已經(jīng)安裝并且啟動成功
然后通過以下地址找到密碼文件initialAdminPassword
注意這里可能因為個人電腦配置而導(dǎo)致路徑差異,要以上圖中的路徑為依據(jù)
/Users/edison/.jenkins/secrets/initialAdminPassword
用文本軟件打開initialAdminPassword文件把密碼輸入,點擊繼續(xù)
2.2 安裝推薦的插件
如果正常進入此頁面 點擊安裝推薦的插件

此時如果出現(xiàn)Jenkins離線,則是網(wǎng)絡(luò)問題導(dǎo)致,這個自己想辦法解決網(wǎng)絡(luò)問題
一定要把所有軟件安裝成功才進行下一步,如果安裝失敗點擊重試。

3.1安裝自己需要的插件
在首頁點擊Manage Jenkins->System Configuration->Manage Plugins ->可選插件,
然后搜索以下列出的插件安裝
-
GitLab Plugin因為項目代碼是部署在gitlab上,所以需要安裝 Gitlab Hook PluginXcode integration-
Keychains and Provisioning Profiles Management配置證書 -
DingTalk打包成功通知群里測試 -
Git Parameter Plug-In配置打包多個分支
4.1配置證書
由于打包需要手動配置證書,所以這里需要上傳Keychains和Provisioning描述文件兩個文件
在首頁點擊Manage Jenkins->Uncategorized->Keychains and Provisioning Profiles Management
注意在頁面最底部
配置鑰匙串和描述文件這里需要注意一下
很多人估計在這里會被坑到,這個應(yīng)該也是Jenkins頁面設(shè)計的一個缺陷。
那就是大家點擊選取login.keychain之后,然后點擊upload。此時鑰匙串keychain是上傳成功了。
但是Provisioning描述文件就沒有去選取和upload上傳。
我想應(yīng)該是大家看到選取上傳按鈕只有一個,覺得選取上傳按鈕和對應(yīng)的文件是一一對應(yīng)的。
也就是會顧慮到我在同一個地方再上傳Provisioning文件會覆蓋掉之前的login.keychain文件,也就是之前的文件會被丟失。
但是請注意,你點擊upload之后文件已經(jīng)保存了。所以這里需要在同一個地方上傳兩個文件沒問題。

4.2 上傳Keychains文件
點擊 選取文件 找到login.keychain這個文件
login.keychain地址
/Users/louxunmac/Library/Keychains
注意由于系統(tǒng)版本升級現(xiàn)在沒有login.keychain這個文件,取而代之的是login.keychain-db文件。
所以我們需要在同一個文件夾下拷貝一份login.keychain-db文件,然后改名成login.keychain文件
選取login.keychain之后然后點擊上傳upload
然后Keychains這里還有Identities->Code Signing Identity這里需要填寫下,
在鑰匙串里找到開發(fā)環(huán)境的證書copy證書名字然后填寫到Code Signing Identity輸入框里

到此keychain配置完成
4.3 上傳Provisioning Profiles描述文件
Provisioning描述文件 地址
/Users/louxunmac/Library/MobileDevice/Provisioning Profiles
因為我的Jenkins打包是用的開發(fā)環(huán)境證書。所以這里只需要用到開發(fā)環(huán)境的Provisioning描述文件
如果用發(fā)布證書打包,那么別人是安裝不了的。發(fā)布證書打包唯一的安裝渠道是走app store。
還是重復(fù)剛才配置keychain的上傳步驟,點擊選取開發(fā)環(huán)境Provisioning描述文件
這個地址里面可能會有多個描述文件,所以你要選擇你此時在Xcode里正在使用的開發(fā)環(huán)境Provisioning描述文件
選取上傳成功后然后在Provisioning Profiles Directory Path里填寫Provisioning地址
到此Provisioning配置完成
最后點擊save保存
至于最后判斷這兩項是否都配置完成可以參照我的截圖
到現(xiàn)在Jenkins的配置告一段落。
5.1創(chuàng)建項目
接下來是創(chuàng)建一個item,即創(chuàng)建一個項目
這里需要注意一點,這里的項目名字一定是你的APP里 product name,否則打包時就會報路徑出錯導(dǎo)致打包失敗
實在不清楚就在Xcode build setting里搜索 product name。

然后選擇第一個自由風格,點擊確定。項目創(chuàng)建完畢。
5.2項目配置
5.2.1 代碼打包分支配置
點擊項目的配置即可進入配置頁面 ,找到并勾選 This project is parameterized
由于Git Parameter插件已經(jīng)安裝,所以點擊添加參數(shù)選中Git Parameter
然后名稱寫branchName , 參數(shù)類型選擇 分支或標簽,默認值填寫origin/master ,如圖


5.2.2 項目代碼地址配置
源碼管理里選中g(shù)it,Repository URL這里填寫你的git項目倉庫地址,Credentials里這里相當于配置git權(quán)限
指定分支填寫$branchName ,如圖:

Credentials配置
點擊添加Jenkins,默認進來應(yīng)該就是domain是全局憑據(jù),類型是username with password,范圍是全局
那就按照默認的來配置,如果不是也最好改一下。
用戶名這里填寫git賬號的用戶名,然后填寫密碼,ID就是git的User ID
這里填寫完點擊添加如果沒有報紅就說明配置成功,不用懷疑了。就如上圖所示

估計很多人在這個時候會忘記自己git賬號和密碼,也不知道那個ID怎么填?然后也不好意思或者暫時不知道找誰拿回賬號密碼
因為git賬號我們只需要輸入一次就行,既然只需要輸入一次,那么他肯定就會保存在本地。
所以只需要找到他就行
如果你是用Sourcetree,那么點擊偏好設(shè)置->高級,如下圖
找到主機名稱,這個主機名稱就是你的git項目倉庫地址,用戶名就是你的git賬號
這里有,說明你是登錄成功狀態(tài)。

打開鑰匙串,如下圖在密碼里根據(jù)你的主機名和賬戶名找到對應(yīng)的一行,然后選中,鼠標右鍵,復(fù)制密碼
或者選中,右鍵點擊顯示簡介,查看密碼。

到此你的賬戶名和密碼都已經(jīng)找到了,還差一個ID。
此時可以在瀏覽器輸入那個主機名稱的ip地址,然后輸入賬戶名和密碼驗證下。
登入成功說明git賬號密碼都是對的。
然后網(wǎng)頁最右上角點擊進入setting,此時setting里面那個user ID就找到了。


5.2.3設(shè)置debug,release 模式
點擊添加參數(shù)選擇choice parmaeter,然后按照下圖配置就行。


5.2.4 Keychains和Provisioning配置
由于之前安裝配置過Keychains and Provisioning Profiles Management,這里直接勾選,選擇就行。完成

5.2.5釘釘機器人添加配置
在你當前的工作群里 智能群助手里添加機器人。
這里需要注意兩點
0.1 Webhook 這個釘釘默認分配的,這個地址我們到時候要加在腳本里
0.2 安全設(shè)置,由于目前Jenkins里的插件只支持ip設(shè)置,所以這里我們先輸入配置一個ip地址。
輸入命令行
nslookup localhost

輸出顯示 把最后一行Address ip地址輸入點擊完成。至此釘釘機器人添加完成。
Server: 202.96.134.133
Address: 202.96.134.133#53
Name: localhost
Address: 127.0.0.1
接下來是配置Jenkins釘釘機器人
點擊Manage Jenkins->System Configuration->configure system 找到釘釘
這里需要勾選通知時機,看個人情況勾選。
webhook填寫:釘釘群里添加的機器人里分配的webhook。
ip:釘釘群里添加的機器人里配置的ip。
然后點擊測試,此時估計會報錯,不要慌,把輸入框底部提示的那個ip地址加在釘釘群里添加機器人的安全設(shè)置ip里。
然后再點擊測試,提示成功。
最后別忘了保存

7.1腳本
至此,里Jenkins打包配置就差最后一步了,執(zhí)行腳本配置。
對于腳本這塊,因為沒什么研究,所以就不多解釋了。
但是需要注意幾點。
7.1.1.腳本里的項目名,這個也是寫的product name,
腳本里有兩個地方寫到 項目名,就在前兩行,我的項目名寫的是YunDian,到時候你們自己替換成自己的就行
7.1.2 然后說說最后蒲公英和釘釘?shù)哪_本配置,就在腳本最后兩段那里。
先說蒲公英,這里需要把userKey和apiKey替換成自己的,然后如果設(shè)置了下載密碼就把PASSWORD也填寫下
這樣蒲公英的腳本配置完成
釘釘這里需要把下載鏈接地址https://www.pgyer.com/abc改成自己項目的下載地址,然后下載密碼填上。
最后https://oapi.dingtalk.com/robot/send?access_token=d7bed3f96cbbbed96ed1a39ed0018bb815aa0jeeekkekeke這里替換成自己的Webhook
## 上傳蒲公英
#userKey和apiKey需要在蒲公英的賬號設(shè)置中查找
userKey="6721185289b82dcc123a2c7dddjjd"
apiKey="0385141eef7d17e0f6b5725adddddd"
PASSWORD=123
MSG=`git log -1 --pretty=%B`
#蒲公英打包
curl -F "file=@${EXPORTPATHNEWIPA}" \
-F "uKey=${userKey}" \
-F "_api_key=${apiKey}" \
-F "updateDescription=${MSG}" \
-F "password=${PASSWORD}" \
http://www.pgyer.com/apiv1/app/upload
#釘釘發(fā)布通知
message="### <font color=#00BFFF>測試環(huán)境【iOS-APP】發(fā)布成功</font>\n 下載鏈接:https://www.pgyer.com/abc\n密碼:123"
MSG_JSON='{"msgtype":"markdown","markdown":{"title":"App發(fā)布通知","text":"'${message}'"}}'
echo "${MSG_JSON}"
echo ${1}
curl 'https://oapi.dingtalk.com/robot/send?access_token=d7bed3f96cbbbed96ed1a39ed0018bb815aa0jeeekkekeke' \
-H 'Content-Type:application/json' \
-d "${MSG_JSON}"
完整腳本如下,改好后直接放在構(gòu)建Execute shell里面,最后保存。

## !/bin/sh
## 項目名
TARGET_NAME=YunDian
## Scheme名
SCHEME=YunDian
##=======================
## 編譯類型
if [[ "${Configuration_Type}" == "Debug" ]]; then
# 測試環(huán)境
BUILD_TYPE=Debug
else
# 生產(chǎn)環(huán)境
BUILD_TYPE=Release
fi
## 當前目錄
SORCEPATH=${WORKSPACE}
## workspace名 YunDian.xcworkspace
SPACE=${WORKSPACE}/${TARGET_NAME}.xcworkspace
##xcarchive文件的存放路徑
ARCHIVEPATH=$SORCEPATH/build/$SCHEME.xcarchive
## ipa文件的存放路徑
EXPORTPATH=$SORCEPATH/build/$SCHEME
## ExportOptions.plist文件的存放路徑,該文件要存放在這個路徑下內(nèi)容如下
EXPORTOPTIONSPLIST=$SORCEPATH/build/ExportOptions.plist
## 導(dǎo)出后的ipa路徑
EXPORTPATHIPA=$SORCEPATH/build/$SCHEME/$SCHEME.ipa
echo -e "============First Build Clean============"
## 清理緩存
## 如果工程使用的是cocoapods,則'-project %s.xcodeproj'替換為'-workspace %s.xcworkspace'
xcodebuild clean -workspace $SPACE -scheme ${SCHEME} -configuration ${BUILD_TYPE}
DELETEIPAFILE=$SORCEPATH/build/$SCHEME/*.ipa
rm -f ${DELETEIPAFILE}
echo -e "============Build Clean============"
## 輸出關(guān)鍵信息
echo -e " TARGET_NAME : ${TARGET_NAME}"
echo -e " BUILD_TYPE : ${BUILD_TYPE}"
echo -e " SORCEPATH : ${SORCEPATH}"
echo -e " ARCHIVEPATH : ${ARCHIVEPATH}"
echo -e " EXPORTPATH : ${EXPORTPATH}"
echo -e " EXPORTOPTIONSPLIST : ${EXPORTOPTIONSPLIST}"
echo -e "============Build Archive============"
## 導(dǎo)出archive包
xcodebuild archive -workspace ${SPACE} -scheme ${SCHEME} -configuration ${BUILD_TYPE} -archivePath $ARCHIVEPATH
echo -e "============Build Archive Success============"
echo -e "============Export IPA============"
## 導(dǎo)出IPA包
xcodebuild -exportArchive -archivePath $ARCHIVEPATH -exportPath ${EXPORTPATH} -exportOptionsPlist ${EXPORTOPTIONSPLIST}
echo -e "============Export IPA SUCCESS============"
## 編譯完成時間 20181030_0931
BUILD_DATE="$(date +'%Y%m%d_%H%M')"
## info.plist路徑
PROJECT_INFOPLIST_PATH="${SORCEPATH}/${TARGET_NAME}/Resources/Info.plist"
## 取版本號
BUNDLESHORTVERSION=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${PROJECT_INFOPLIST_PATH}")
## 取build值
VERSION=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" "${PROJECT_INFOPLIST_PATH}")
## ipa更名規(guī)則 項目名V版本_年月日_時分
IPANAME="${TARGET_NAME}V${BUNDLESHORTVERSION}_${BUILD_DATE}.ipa"
## 更名后ipa路徑
EXPORTPATHNEWIPA=$EXPORTPATH/$IPANAME
echo -e "============Export end :${BUILD_DATE}============"
echo -e "============IPA Old Name: ${EXPORTPATHIPA}============"
echo -e "============IPA New Name: ${EXPORTPATHNEWIPA}============"
## IPA更名
cp $EXPORTPATHIPA $EXPORTPATHNEWIPA
echo -e "============Create New Name Success============"
## 刪除老IPA
rm $EXPORTPATHIPA
echo -e "============Delete Old Name Success============"
echo -e "============Start Uploading============"
## 上傳蒲公英
#userKey和apiKey需要在蒲公英的賬號設(shè)置中查找
userKey="6721185289b82dcc123a2c7d18859fc4"
apiKey="0385141eef7d17e0f6b5725a3f22ddc0"
PASSWORD=123
MSG=`git log -1 --pretty=%B`
#蒲公英打包
curl -F "file=@${EXPORTPATHNEWIPA}" \
-F "uKey=${userKey}" \
-F "_api_key=${apiKey}" \
-F "updateDescription=${MSG}" \
-F "password=${PASSWORD}" \
http://www.pgyer.com/apiv1/app/upload
message="### <font color=#00BFFF>測試環(huán)境【iOS-樓訊云店】發(fā)布成功</font>\n 下載鏈接:https://www.pgyer.com/OmpT\n密碼:123"
MSG_JSON='{"msgtype":"markdown","markdown":{"title":"App發(fā)布通知","text":"'${message}'"}}'
echo "${MSG_JSON}"
echo ${1}
curl 'https://oapi.dingtalk.com/robot/send?access_token=d7bed3f96cbbbed96ed1a39ed0018bb815aa076330ac554f2e025111521da8c6' \
-H 'Content-Type:application/json' \
-d "${MSG_JSON}"
這樣整個Jenkins配置全部完成。
但是應(yīng)該不會就這么輕易打包成功。
8.1開始打包
我們點擊build with parameters,選中你要構(gòu)建的分支,最后點擊開始構(gòu)建。

如果構(gòu)建成功那就不管了,做別的事去
大概率會報錯,當看到如下錯誤The file “ExportOptions.plist” couldn’t be opened because there is no such file時,說明ExportOptions.plist這個文件不存在。再看看報錯里面的路徑是在/Users/louxunmac/.jenkins/workspace/yundian/build/YunDian.xcarchive里沒找到。
怎么查看錯誤,如下圖bulid history點擊構(gòu)建對應(yīng)的tag次數(shù),點擊倒三角查看控制臺輸出
+ echo -e '============Build Archive Success============'
-e ============Build Archive Success============
+ echo -e '============Export IPA============'
-e ============Export IPA============
+ xcodebuild -exportArchive -archivePath /Users/louxunmac/.jenkins/workspace/yundian/build/YunDian.xcarchive -exportPath /Users/louxunmac/.jenkins/workspace/yundian/build/YunDian -exportOptionsPlist /Users/louxunmac/.jenkins/workspace/yundian/build/ExportOptions.plist
error: Couldn't load -exportOptionsPlist: The file “ExportOptions.plist” couldn’t be opened because there is no such file.
Error Domain=NSCocoaErrorDomain Code=260 "The file “ExportOptions.plist” couldn’t be opened because there is no such file." UserInfo={NSFilePath=/Users/louxunmac/.jenkins/workspace/yundian/build/ExportOptions.plist, NSUnderlyingError=0x7fe868b13e10 {Error Domain=NSPOSIXErrorDomain Code=2 "No such file or directory"}}
** EXPORT FAILED **
Build step 'Execute shell' marked build as failure
Finished: FAILURE

既然沒有那么我們就創(chuàng)建一個ExportOptions.plist文件。
如下圖創(chuàng)建ExportOptions.plist文件
我們需要使用Xcode來構(gòu)建一個開發(fā)環(huán)境包。點擊Xcode->product->archive
選擇development

注意這里 app thinning這里選擇none,additional options 這里不要勾選 然后點擊next

最后打包成功后,拷貝一份ExportOptions.plist文件到報錯的路徑下面/Users/louxunmac/.jenkins/workspace/yundian/build/YunDian.xcarchive,就拷貝在build這個文件夾里

如果出現(xiàn)如下錯誤,那就是ipa路徑不對,很可能是你上一步導(dǎo)出的包里面ExportOptions.plist文件的問題,所以要按照如上打包打出。
+ cp /Users/louxunmac/.jenkins/workspace/yundian/build/YunDian/YunDian.ipa '/Users/louxunmac/.jenkins/workspace/yundian/build/YunDian/YunDianV$(MARKETING_VERSION)_20201111_1134.ipa'
cp: /Users/louxunmac/.jenkins/workspace/yundian/build/YunDian/YunDian.ipa: No such file or directory
Build step 'Execute shell' marked build as failure
Finished: FAILURE
基本到此打包就會成功,如果遇到其它問題可以Google 我這里暫時只能提供這些
最后配置好了 如何讓其它機器訪問?比如讓你們公司的測試訪問你的電腦打包地址來打包
1.修改ip
把homebrew.mxcl.jenkins-lts.plist文件里的httpListenAddress地址127.0.0.1 改成0.0.0.0
以下兩個地方都改一下
/Users/louxunmac/Library/LaunchAgents/homebrew.mxcl.jenkins-lts.plist
/usr/local/Cellar/jenkins-lts/2.249.3/homebrew.mxcl.jenkins-lts.plist
改好后要讓環(huán)境生效
1.鏈接launchd 配置文件
ln -sfv /usr/local/opt/jenkins-lts/*.plist ~/Library/LaunchAgents
2.加載文件執(zhí)行命令行:
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.jenkins-lts.plist
最后重啟Jenkins
brew services restart jenkins-lts
這個時候用手機輸入ip地址 奇跡出現(xiàn)了(注意把下面的ip地址替換為你本機的ip地址,如下圖箭頭)
`http://10.1.221.162:8080`
