1、Jenkins的安裝與啟動
- 方式一:直接下載安裝包
https://jenkins.io/index.html
安裝完成后在 Terminal 中輸入,即可打開 Jenkins。
open /Applications/Jenkins/jenkins.war
-
方式二:使用homebrew
- 安裝 homebrew(如果已經安裝,跳過此步)
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- 安裝 Jenkins
brew install jenkins
3.啟動 Jenkins
jenkins
2、訪問Jenkins
當Jenkins啟動后,瀏覽器中輸入 http://localhost:8080/
使用安裝包安裝會自動彈出了瀏覽器打開
如果端口沖突那么請修改端口
defaults write /Library/Preferences/org.jenkins-ci httpPort xxxx
-
請前往圖中紅字所示地址
受保護-請修改文件訪問權限 修改文件訪問權限后,進入該文件夾中,將
initialAdminPassword
中的密碼拷貝到輸入框,點擊continue
-
下載插件
選擇左邊-安裝建議的插件 -
插件安裝中。。。
插件安裝中 -
插件安裝完畢,創建賬戶->
Save and Finish
創建管理員賬戶 賬戶創建成功
3、Jenkins插件安裝
- 依次安裝以下Jenkins插件
GitLab
Xcode integration
Keychains and Provisioning Profiles Management
-
插件安裝步驟
進入插件管理頁面
搜索并安裝插件
4、創建Jenkins任務
- 回到Jenkins首頁,點擊
新建
創建Jenkins任務
5、配置剛剛創建好的Jenkins任務
5.1、設置源碼管理(這里我們使用的是git)
-
設置Gredentials
進入Gredentials頁面
創建
配置 如果不清楚上如中的
Key
, 應該填什么,請看下面
1、前往文件夾
~/.ssh/id_rsa
2、用文本編輯器打開id_rsa
, 拷貝里面的內容到上圖中Key
的輸入框,如下圖
- 配置好Credential, 點擊ok,再次回到項目的
源碼管理
,選擇Gredentials為我們剛剛創建的,如圖
選擇Gredentials
5.2、設置構建觸發器(可以觸發構建操作的配置)
5.3、設置構建環境,這里我們選擇Keychains and Code Signing Identities
勾選
Keychains and Code Signing Identities
-
配置
Keychain
和Provisioning Profiles
- 保存后進入
Keychains and Provisioning Profiles Management
頁面,如果沒有該選項,請參考上述第三步:Jenkins插件
安裝來安裝Keychains and Provisioning Profiles Management
插件
進入`Keychains and Provisioning Profiles Management`頁面
- 保存后進入
-
注意:保存后,在
/Users/Shared/Jenkins
文件夾下如圖:
需要出現`Keychains`和`MobileDevice`文件夾
如果未出現:
1、直接將/Users/‘你的用戶名’/Library/Keychains
文件夾拷貝到/Users/Shared/Jenkins
文件夾下;
2、直接將/Users/‘你的用戶名’/Library/MobileDevice
文件夾拷貝到/Users/Shared/Jenkins
文件夾下; 注意:這里配置的證書是將來用來打包項目用的證書,必須與你將要打包的Xcode項目中的配置一致!!!
注意:這里配置的證書是將來用來打包項目用的證書,必須與你將要打包的Xcode項目中的配置一致!!!
注意:這里配置的證書是將來用來打包項目用的證書,必須與你將要打包的Xcode項目中的配置一致!!!
-
需要手動配置Xcode項目的profile文件,不要使用
Auto........
,這里不再說明如何手動配置Xcode項目的profile文件
至此,我們完成如下圖的構建環境配置(如下圖)
構建環境配置
5.4、設置構建操作(這里我們選擇Xcode
)
點擊增加構建步驟, 選擇Xcode
-
如果沒有Xcode選項,請參考上述
第三步:Jenkins插件
安裝來安裝Xcode integration
插件
增加構建步驟-Xcode -
配置Xcode構建步驟
-
配置
General build settings
General build settings -
配置
Code signing & OS X keychain options
Code signing & OS X keychain options -
配置
Advanced Xcode build options
Advanced Xcode build options
-
此時我們所有的打包操作已經完畢,如果你僅僅是打包用,到此你可以點擊保存,點擊
立即構建
,進行構建操作了
既然已經做到這一步(自動打包),我們還可以配置一些構建操作,將打包后的IPA文件上傳到蒲公英,便于測試!配置如下:
- 1、在蒲公英網站上創建用戶,獲取到
userKey
和apiKey
- 2、在Jenkins上再次配置下我們之前配置好的項目,在之前添加的
Xcode
構建步驟下,新增一個Execute shell
構建步驟,如圖:
Execute shell - 3、在
command
中填寫如下命令:
#蒲公英上的User Key
uKey="xxxxxxxxxxxxxxxxxxxxxxxx"
#蒲公英上的API Key
apiKey="xxxxxxxxxxxxxxxxxxxxxxxx"
#要上傳的ipa文件路徑
IPA_PATH="我們打包后的IPA文件地址"
#執行上傳至蒲公英的命令,這句不需要修改
curl -F "file=@${IPA_PATH}" -F "uKey=${uKey}" -F "_api_key=${apiKey}" https://www.pgyer.com/apiv1/app/upload
-
配置完畢,點擊保存,我們再次構建我們的項目,如果不出意外,我們看到的是這樣的標志
構建成功
說明我們的項目構建成功,并成功發布到蒲公英,快去蒲公英上看看吧~~
6、常見報錯及解決辦法
1、This project contains no schemes
-
解決辦法:
勾選shared -
注意點:
- 這里我們不能去Jenkins項目目錄下修改Xcode項目的shared勾選,我們應該在本地的開發源碼上修改,然后提交到git遠程倉庫,再次構建!!!
-
由于gitignor文件,我們有可能沒有注意的情況下,并沒有將shared勾選這個設置提交到遠程倉庫,導致再次侯建依舊失敗!