在之前的文章中，我們介紹了使用gitlab ci構建Android包的方法。今天我們介紹使用gitlab ci如何構建IOS包，並且在打包成功或者失敗時，如何將訊息通知到企業微信。 如果對gitlab ci還不熟悉的，可以參考之前的文章[使用gitlab ci構建Android包](https://mp.weixin.qq.com/s?__biz=MzIzODU5ODUxMA==&mid=2247483957&idx=1&sn=bf83d5a296a2bbcf0eb0e73bbb65149d&chksm=e937a234de402b22e1d45c6c01554f1dee27ca6d48227eebb2c06bdc9db0e60953040bc28e58&token=747506873&lang=zh_CN#rd)，這篇文章我們主要涉及三個知識點： - IOS開發者證書。 - IOS打包命令。 - 如何往企業微信發訊息。 ## IOS開發者證書 IOS打包離不開開發者證書，因此首先我們需要先搞清楚IOS的證書是怎麼回事，它是怎麼工作的。 ### 為什麼需要證書 我們知道，如果手機不越獄的情況下，iphone手機安裝app只能通過官方的App Store。這種限制是怎麼做到的呢？其實很簡單，主要用到了**非對稱加密**。 首先蘋果官方生成一堆公私鑰，在所有的iphone手機裡內建了一個公鑰，在蘋果公司的後臺儲存著私鑰。當app開發者上傳app到App Store時，會用儲存在後臺的私鑰對App進行簽名，在iphone手機上下載這個app後，用手機上的公鑰來驗證這個簽名，如果簽名驗證通過，則表示這個app是由蘋果後臺認證的，並且沒有被篡改過。 基於這種簽名機制，保證了在iphone手機上安裝的每一個app都是經過蘋果認證允許的。 但是，一個新的問題來了，如果我們的app還處於開發中，還沒有上傳到appStore，該怎麼安裝到iphone手機上呢？這就需要用到開發者證書在中間做一個過渡作用。 ### 證書型別 常用的開發者證書分為兩種，一種是個人開發者證書，一種是企業開發者證書。其中，我們常見的有兩種模式： - In-House：企業內部分發，可以直接的安裝ipa包（一般是將包上傳到服務端，生成連結，點選連結可以下載）。不過最新的ios系統，需要在【通用—關於本機—證書信任設定】中對企業證書進行信任。 - Ad-Hoc：相當於是企業分發的限制版，限制100個裝置安裝，需要提前在蘋果後臺配置iphone裝置的裝置號（可通過第三方工具或者訪問蒲公英查詢）。 需要注意的是由企業證書籤名的包，是不能上傳到App Store的，因此需要根據自己公司的情況申請不同的開發者證書。 ### 原理介紹 上面其實已經提到，證書的工作原理是通過非對稱加密，從網上找了一幅圖，很好的介紹了這個過程：  上圖對應的步驟如下： - 在mac電腦上申請一對公私鑰，圖中是公鑰M和私鑰M。 - 對於蘋果的證書來說，跟App Store工作原理一樣，在蘋果後臺伺服器放置了私鑰A，在蘋果裝置上存放了對應的公鑰A。 - 將公鑰M上傳到蘋果後臺，用私鑰A進行簽名，得到包含公鑰M及其簽名。同時還有一個Provision profile（大家常說的pp檔案）檔案（其中包含了AppID、裝置列表、App可使用的許可權），將證書檔案下載到本地mac。 - 在開發app時，使用本地的私鑰M對app進行簽名，連同上面的pp檔案一起被打包到app中。 - 在安裝app時，ios系統獲取證書，通過內建的公鑰A，去驗證app內的證書是正確的。如果能驗證通過，則可以將App內的證書資料取出來，使用公鑰M驗證App的簽名是否正確，驗證安裝app的裝置ID是否存在裝置列表中等。 上面的步驟，大致描述了蘋果開發者證書的工作原理，如果你沒太理解也沒關係。可以結合著上圖多看幾遍。 另外，這裡還有個知識點，在mac電腦申請的公鑰和私鑰M只能在申請的電腦使用，怎麼讓其他夥伴也能正常使用呢？可以將私鑰M匯出成.p12檔案，其他Mac電腦匯入私鑰M，就可以正常使用了。 ## IOS打包 首先打包之前，需要清理工程（workspace和scheme引數的值需要拿到ios程式碼才能檢視）： ``` bash $ xcodebuild clean -workspace xxxx.xcworkspace -scheme xxxx ``` 其次，如果你想要ios包的構建號是自動遞增的，可以使用agvtool這個工具： ``` bash $ agvtool next-version -all ``` 接著，就可以開始archive包（對Target進行編譯、歸檔，生成.xcarchive）。 ``` bash $ xcodebuild -workspace xxxx.xcworkspace -scheme xxxx -configuration Debug archive -archivePath xxxxPath/xxxxx.xcarchive ``` 最後，就是將歸檔檔案匯出，生成不同渠道的ipa包： ``` bash $ xcodebuild -exportArchive -archivePath build/$SCHEME_NAME.xcarchive -exportPath build -exportOptionsPlist $EXPORT_OPTIONS_PLIST ``` 這裡需要指定一個exportOptionsPlist，是對匯出ipa的配置，我這裡寫的比較簡單，格式如下： ``` xml compileBitcode destination export method development signingStyle automatic stripSwiftSymbols teamID xxxxxxxx thinning <none> ``` 如果你覺得使用命令列的方式相對麻煩的話，可以考慮使用打包工具fastlane（後面我再專門寫文章介紹）。 ## 傳送訊息通知 企業微信中可以建立一個群機器人，然後通過webhook來進行訊息通知。企業微信提供了詳細的配置方式，可以參考：[企業機器人配置](https://work.weixin.qq.com/api/doc/90000/90136/91770)。其本質上就是傳送了一個請求： ``` shell curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa' \ -H 'Content-Type: application/json' \ -d ' { "msgtype": "text", "text": { "content": "hello world" } }' ``` 我們只需要將key替換成我們建立機器人的key即可。 ## 整合之後的.gitlab-ci.yml配置檔案 最後貼一個我在專案中使用的配置檔案，如下所示： ``` yaml variables: CONFIGURATION: "Debug" WORKSPACE: "xxxx.xcworkspace" SCHEME_NAME: "xxxx" EXPORT_MAIN_DIRECTORY: "build" EXPORT_OPTIONS_PLIST: "ExportOptions-dev.plist" CODE_SIGN_IDENTITY: "xxxxxx" PROVISIONING_PROFILE: "xxxxx" LANG: "en_US.UTF-8" stages: - makedir - archive - ipa - upload - notify # 建立對應目錄 dir_job: stage: makedir script: - mkdir $EXPORT_MAIN_DIRECTORY - EXPORT_MAIN_DIRECTORY=$EXPORT_MAIN_DIRECTORY/$(date "+%Y%m%d%H%M%S") - echo $EXPORT_MAIN_DIRECTORY - mkdir $EXPORT_MAIN_DIRECTORY tags: - ios # 構建archive archive_job: stage: archive script: - agvtool next-version -all # 更新構建號，版本號之後再更新 - xcodebuild clean -workspace $WORKSPACE -scheme $SCHEME_NAME - xcodebuild -workspace $WORKSPACE -scheme $SCHEME_NAME -configuration Debug archive -archivePath $EXPORT_MAIN_DIRECTORY/$SCHEME_NAME.xcarchive artifacts: expire_in: '2 day' name: "下載xcarchive,保留2天" paths: - $EXPORT_MAIN_DIRECTORY/$SCHEME_NAME.xcarchive tags: - ios # 匯出ipa ipa_job: stage: ipa script: - echo 'export ipa' - xcodebuild -exportArchive -archivePath $EXPORT_MAIN_DIRECTORY/$SCHEME_NAME.xcarchive -exportPath $EXPORT_MAIN_DIRECTORY -exportOptionsPlist $EXPORT_OPTIONS_PLIST artifacts: expire_in: '5 day' name: "下載ipa,保留5天" paths: - $EXPORT_MAIN_DIRECTORY/$SCHEME_NAME.ipa only: - qa tags: - ios # 上傳ipa upload_job: stage: upload script: - curl -H "Authorization:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7Il9pZCI6IjVlOTE4Yzc5MmMzZGQ0MDAxZTRiOGY1YiIsInVzZXJuYW1lIjoic3VodWNoZW4ddiLCJlbWFdddpbCI6InN1aHVjaGVuQHFxLmNvbSJ9LCJleHAiOjQ3NDAxOTcyODgsImlhdCI6MTU4NjU5NzI4OH0.5UUkM4lJddYrnvXvHaNNJIY_j5OsBQmLw0mBUrXG3d9E4" -F "file=@$EXPORT_MAIN_DIRECTORY/$SCHEME_NAME.ipa" http://上傳包地址/api/apps/5e916b9eac2363001dd7554a/upload only: - qa tags: - ios # 構建失敗時的通知訊息 notifyFailWeChat: stage: notify script: - curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=26b07c1b-03ea-49da-afc7-f68a359f2a52' -H 'Content-Type:application/json' -d "{\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"ios專案構建結果：失敗\n>本次構建由：$GITLAB_USER_NAME 觸發\n>專案名稱：$CI_PROJECT_NAME\n>提交號：$CI_COMMIT_SHA\n>提交日誌：$CI_COMMIT_MESSAGE\n>構建分支：$CI_COMMIT_BRANCH\n>流水線地址：[$CI_PIPELINE_URL]($CI_PIPELINE_URL)\"}}" tags: - ios only: - qa when: on_failure # 構建成功時的通知訊息 notifySuccessWeChat: stage: notify script: - curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=26b07c1b-03ea-49da-afc7-f68a359f2a52' -H 'Content-Type:application/json' -d "{\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"ios專案構建結果：成功\n>請前往釋出平臺下載體驗：[下載地址](http://app下載地址)\n>本次構建由：$GITLAB_USER_NAME 觸發\n>專案名稱：$CI_PROJECT_NAME\n>提交號：$CI_COMMIT_SHA\n>提交日誌：$CI_COMMIT_MESSAGE\n>構建分支：$CI_COMMIT_BRANCH\n>流水線地址：[$CI_PIPELINE_URL]($CI_PIPELINE_URL)\"}}" tags: - ios only: - qa when: on_success ``` ## 總結 如果你們公司目前還沒搞起來Jenkins，我推薦嘗試用gitlab實現ci/cd流水線，因為可以減少很多配置和外掛的安裝。相對來說實現成本更低一些，從目前我用gitlab ci的情況來看，基本上Jenkins能實現的gitlab ci都能