iOS項目自動化構建實踐（Jenkins+Pgyer+Email）

參考文章：
https://wiki.jenkins-ci.org/display/JENKINS/Keychains+and+Provisioning+Profiles+Plugin
http://www.egeek.me/2013/02/23/jenkins-and-xcode-user-interaction-is-not-allowed/

安裝Jenkins

開始

打開Terminal，獲取管理員密碼命令如下：

sudo cat /Users/Shared/Jenkins/Home/secrets/initialAdminPassword
  • 點擊Continue , 進入到插件安裝引導頁
插件安裝
  • 選擇 Install suggested plugins（建議插件）進行安裝，然后倒杯茶，慢慢等一會兒~~
安裝中
  • 安裝完成后，進入創建用戶頁面（建議將密碼備份到印象筆記，如果忘記的話，在【遇到的坑和解決方案】可以找到解決方案）
創建用戶
  • 安裝完成，進入到自動構建管理頁面
自動構建管理頁面

配置Jenkins

  • 主要配置

    • 配置Jenkins插件
    • 配置login.keychain
    • 配置證書
    • 配置郵件腳本

  • 配置Jenkins插件
    系統管理 - 管理插件 - 可選插件，分別安裝下列插件：

    • Xcode integration : 該插件是的Jenkins可以調用Xcode的命令行工具以自動化構建和打包iOS應用（iPhone，iPad等）
    • GitLab Plugin : This plugin is a build trigger that allows GitLab to trigger Jenkins builds when code is pushed or a merge request is created. Configuration done on a per-job basis.
    • Gitlab Authentication plugin : The GitLab Authentication Plugin provides a means of using GitLab for authentication and authorization to secure Jenkins. GitLab Enterprise is also supported.

  • 配置login.keychain

iOS項目簽名，需要配置Jenkins的鑰匙串??文件，一種簡單的方法是把本地User目錄下的login.keychain文件copy到Jenkins目錄下

sudo mkdir /Users/Shared/Jenkins/Library
sudo mkdir /Users/Shared/Jenkins/Library/Keychains
sudo cp ${HOME}/Library/Keychains/login.keychain /Users/Shared/Jenkins/Library/Keychains
  • 配置證書Provisioning file

iOS項目描述文件，和配置login.keychain類似，可以直接copy一份到Jenkins目錄

sudo mkdir /Users/Shared/Jenkins/Library/MobileDevice
sudo mkdir /Users/Shared/Jenkins/Library/MobileDevice/Provisioning\ Profiles
sudo cp ${HOME}/Library/MobileDevice/Provisioning\ Profiles/* /Users/Shared/Jenkins/Library/MobileDevice/Provisioning\ Profiles/
  • 配置郵件腳本

可以參考下面的Python腳本（該腳本在巧哥腳本的基礎上優化的，可以自動構建完成后自動發郵件給多個郵箱）

# coding=utf-8

import time
import urllib2
import time
import json
import mimetypes
import os
import smtplib
from email.MIMEText import MIMEText
from email.MIMEMultipart import MIMEMultipart
import json
import sys
reload(sys)
sys.setdefaultencoding( "utf-8" )

#===============需配置=================
# 上傳文件的文件名
file_name = 'Demo'
# 接受郵箱地址
mailto_list=["xxxxxxxxx01@qq.com","xxxxxxxxx02@qq.com"]
# 發送郵箱的服務器、用戶名、授權碼、郵箱的后綴
mail_host="smtp.qq.com"
mail_user="xxxx"
mail_pass="xxxxxxxxx"
mail_postfix="qq.com"
# 蒲公英用戶Key
uKey = 'xxxxxxxxxxxxxxxxxxxxxxxxx'
# 蒲公英API Key
_api_key = 'xxxxxxxxxxxxxxxxxxxxxxxxx'
#==========================================

#蒲公英應用上傳地址
url = 'http://www.pgyer.com/apiv1/app/upload'
#安裝應用時需要輸入的密碼，這個可不填
installPassword = '111111'
# 運行時環境變量字典
environsDict = os.environ
#此次 jenkins 構建版本號
jenkins_build_number = environsDict['BUILD_NUMBER']
#獲取 ipa 文件路徑
def get_ipa_file_path():
    #工作目錄下面的 ipa 文件
    ipa_file_workspace_path = '/Users/Shared/Jenkins/Home/workspace/' + file_name + '/Build/' + file_name + '.ipa'
    if os.path.exists(ipa_file_workspace_path):
        return ipa_file_workspace_path

ipa_file_path = get_ipa_file_path()
print ipa_file_path

def _encode_multipart(params_dict):
    boundary = '----------%s' % hex(int(time.time() * 1000))
    data = []
    for k, v in params_dict.items():
        data.append('--%s' % boundary)
        if hasattr(v, 'read'):
            filename = getattr(v, 'name', '')
            content = v.read()
            decoded_content = content.decode('ISO-8859-1')
            data.append('Content-Disposition: form-data; name="%s"; filename="kangda.ipa"' % k)
            data.append('Content-Type: application/octet-stream\r\n')
            data.append(decoded_content)
        else:
            data.append('Content-Disposition: form-data; name="%s"\r\n' % k)
            data.append(v if isinstance(v, str) else v.decode('utf-8'))
    data.append('--%s--\r\n' % boundary)
    return '\r\n'.join(data), boundary

def handle_resule(result):
    json_result = json.loads(result)
    print json_result
    if json_result['code'] is 0:
        send_Email(json_result)

def send_Email(json_result):
    print json_result
    appName = json_result['data']['appName']
    appKey = json_result['data']['appKey']
    appVersion = json_result['data']['appVersion']
    appBuildVersion = json_result['data']['appBuildVersion']
    appShortcutUrl = json_result['data']['appShortcutUrl']
    appUpdated = json_result['data']['appUpdated']

    environsString = '安裝鏈接 : ' + 'http://www.pgyer.com/' + str(appShortcutUrl) + '   密碼 : ' + installPassword + '  更新于：' + str(appUpdated)
    msg = MIMEText(environsString)
    me=mail_user+"<"+mail_user+"@"+mail_postfix+">"
    msg['Subject'] = '【' + str(appName) + ' ' + str(appVersion) +'】' + '(iOS)' + ' 自動構建成功，快給開發提幾個Bugs！！！'
    msg['From'] = me
    msg['To'] = ";".join(mailto_list)
    
    try:
        s = smtplib.SMTP_SSL('smtp.qq.com')
        s.connect(mail_host,port=465)
        s.login(mail_user, mail_pass)
        s.sendmail(me, mailto_list, msg.as_string())
        s.close()
        print 'success'
    except Exception, e:
        print e

params = {
    'uKey': uKey,
    '_api_key': _api_key,
    'file': open(ipa_file_path, 'rb'),
    'publishRange': '2',
    'password': installPassword
}

coded_params, boundary = _encode_multipart(params)
req = urllib2.Request(url, coded_params.encode('ISO-8859-1'))
req.add_header('Content-Type', 'multipart/form-data; boundary=%s' % boundary)
try:
    resp = urllib2.urlopen(req)
    body = resp.read().decode('utf-8')
    handle_resule(body)

except urllib2.HTTPError as e:
    print(e.fp.read())
  • mail_pass="xxxxxxxxx" 是授權碼，并不是發送郵箱的密碼（如何開啟SMTP功能和授權秘鑰，參考這篇文章）
  • uKey、_api_key為蒲公英用戶Key和API Key，獲取方式參照這篇文章
  • 將這個腳本文件命名為Demo.py(或者你的項目名.py),移動到
    /Users/Shared/Jenkins/目錄下（創建自動構建任務的時候需要使用）

創建一個自動構建任務

  • 在管理頁面，創建一個新任務，選擇構建一個自由風格的軟件項目。


    創建一個新任務

  • 點擊OK，進入到任務配置頁面


    任務配置頁面
  • 下面以GitLab托管源碼演示配置流程：
    1. 源碼管理器：選擇Git，填寫Repository URL，點擊Add添加Credentials

遇到的坑和解決方案

  1. pod update的時候提示 : CocoaPods requires your terminal to be using UTF-8 encoding

解決方案：在執行pod update之前export LC_ALL="en_US.UTF-8"
【參考：http://www.tuicool.com/articles/J3mE7r】

最后編輯于 ：
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發布，文章內容僅代表作者本人觀點，簡書系信息發布平臺，僅提供信息存儲服務。

推薦閱讀更多精彩內容