iOS 使用Jenkins持续集成(简称CI)

  1. 安装jenkins
    1.1. 直接到官网下载安装包,通过安装包安装
    1.2. 通过Homebrew使用命令行安装
    1
    2
    3
    4
    5
    6
    1. 安装Homebrew
    $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    2. 安装Jenkins
    $ brew install jenkins
    3、启动Jenkins
    $ jenkins

一切顺利的话,打开浏览器输入:http://localhost:8080/就能看到jenkins已经运行起来了,如果你更换了端口就是你后来设置的端口。接下来打开Jenkins后会让去一个填写password的页面如下图,存储password的地方就是图片上那行红色字体目录

然后将我们得到的password输入到Administrator password中,即可进入如下界面,接着安装一些建议的插件左边的,安装过程中,有的插件可能会安装失败,强烈建议点击右下角的重试,直到把建议安装的都装好

插件安装完成后,可能不会自动跳转,刷新下界面即可,在刷新后的界面中注册,输入用户名和密码,建议输入后点蓝色按钮保存完成

  1. 安装jenkins插件
    如果要使用Jenkins的插件构建工程的,需要在开始新建工程前安装一些Jenkins插件,在可选插件中选择我们需要的插件进行安装
    1
    2
    3
    4
    5
    1. Xcode integration
    2. GIT plugin
    3. GitLab Plugin
    4. Gitlab Hook Plugin
    5. Keychains and Provisioning Profiles Management

我们今天使用Execute shell Shell脚本构建工程

  1. jenkins的使用
    3.1. 构建一个自由风格的软件项目

3.2. General参数

可以设置包的保留天数和最大保留个数,这些可以根据需要进行调整,可以不要选

  • jenkins插件配置多个项目extended choice parameter插件主要是构建的时候可以多选框来选择要构建的项目模块




($+上面的Name)就可以获取该值

3.3. 源码管理

3.4. 构建触发器设置
触发器可自定义的地方很多,可以根据项目需要选择可省略

  • 定时构建:不管SVNGit中数据有无变化,均执行定时化的构建任务
  • 轮询SCM:只要SVNGit中数据有更新,则执行构建任务
    日程表的填写内容有5个参数,从左到右的参数含义如下:
    ⦁ 第1个参数:分钟minute,取值0~59
    ⦁ 第2个参数:小时hour,取值0~23
    ⦁ 第3个参数:天day,取值1~31
    ⦁ 第4个参数:月month,取值1~12
    ⦁ 第5个参数:星期week,取值0~707都是表示星期天
    5个参数可选择性设定,不写死的参数用*号代替,参数之间用空格隔开。例如:
    1
    2
    3
    4
    5
    6
    7
    8
    "0 21 * * *"表示每晚21点0分自动化构建一次
    "0 * * * *"表示每个小时的第0分钟执行一次构建
    "H/5 * * * *"每隔5分钟构建一次
    "H H/2 * * *"每两小时构建一次
    "H H 30 * *"每月30号构建一次
    "H(0-29)/10 * * * *"每个小时的前半个小时内的每10分钟
    "0 8-17/2 * * 1-5"周一到周五,8点~17点,两小时构建一次
    "H H 1,15 1-11 *"每月1号、15号各构建一次,除12月等

3.5. 构建环境设置
本文使用的是shell脚本构建工程,所以该项可以省去
3.6. 构建
有两种方式打包,一是用Xcode插件打包,二是用Shell脚本打包,本文选择第二种

  • iOS自动打包—Jenkins Shell如下:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    ## !/bin/sh
    ## 项目名
    TARGET_NAME=NNAlgorithm
    ## Scheme名
    SCHEME=NNAlgorithm
    ##=======================
    ## 编译类型
    BUILD_TYPE=Release
    ## 当前目录
    SORCEPATH=${WORKSPACE}
    ## workspace名
    SPACE=${WORKSPACE}/${TARGET_NAME}.xcodeproj
    ##xcarchive文件的存放路径
    ARCHIVEPATH=$SORCEPATH/build/$SCHEME.xcarchive
    ## ipa文件的存放路径
    EXPORTPATH=$SORCEPATH/build/$SCHEME
    ## ExportOptions.plist文件的存放路径,该文件要存放在这个路径下内容如下
    EXPORTOPTIONSPLIST=$SORCEPATH/build/ExportOptions.plist
    ## 导出后的ipa路径
    EXPORTPATHIPA=$SORCEPATH/build/$SCHEME/$SCHEME.ipa

    echo -e "============First Build Clean============"
    ## 清理缓存
    ## 如果工程使用的是cocoapods,则'-project %s.xcodeproj'替换为'-workspace %s.xcworkspace'
    xcodebuild clean -project $SPACE -scheme ${SCHEME} -configuration ${BUILD_TYPE}
    echo -e "============Build Clean============"
    ## 输出关键信息
    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============"

    ## 导出archive包
    xcodebuild archive -project ${SPACE} -scheme ${SCHEME} -archivePath $ARCHIVEPATH
    echo -e "============Build Archive Success============"

    echo -e "============Export IPA============"
    ## 导出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}/Info.plist"
    ## 取版本号
    BUNDLESHORTVERSION=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${PROJECT_INFOPLIST_PATH}")
    ## 取build值
    VERSION=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" "${PROJECT_INFOPLIST_PATH}")
    ## ipa更名规则 项目名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============"

    #userKey和apiKey需要在蒲公英的账号设置中查找
    userKey="xxx"
    apiKey="xxx"
    #蒲公英打包
    curl -F "file=@${EXPORTPATHNEWIPA}" \
    -F "uKey=${userKey}" \
    -F "_api_key=${apiKey}" \
    -F "isPublishToPublic=2" \
    http://www.pgyer.com/apiv1/app/upload
  • ExportOptions.plist

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
    <key>provisioningProfiles</key>
    <dict>
    <key>com.Y***ane</key>
    <string>azur***_dev</string>
    </dict>
    <key>method</key>
    <string>development</string>
    <key>signingCertificate</key>
    <string>iPhone Developer</string>
    <key>signingStyle</key>
    <string>manual</string>
    <key>teamID</key>
    <string>42***ZL</string>
    <key>compileBitcode</key>
    <false/>
    <key>uploadSymbols</key>
    <false/>
    </dict>
    </plist>
  • 其中plist文件中的method参数有如下几个方法:app-store, ad-hoc, enterprise, development
    3.7. 构建后操作

  • 邮件通知系统,通过系统管理系统设置,进行邮件配置
  • 设置jenkins地址和管理员邮箱地址

  • 设置发件人等信息
    这里的发件人邮箱地址切记要和系统管理员邮件地址保持一致

  • 注:上图的Password为邮箱的SMTP授权秘钥,至此系统管理处的内容已配置完成

  • 配置Jenkins自带的邮件功能(测试邮件功能是否正常使用,可以不配置,不影响)

和上面Extended E-mail Notification配置一样即可,点击Test configuration,收到邮件并且显示Email was successfully sent,代表邮件配置成功,接下来可以去项目中具体配置就可以使用了

  • 进入项目,然后找到构建后操作,点击增加构建后的操作步骤,点击Editable Email Notification

  • 至此所有的配置已完成,点击应用后保存,enjoy it!

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Project Recipient List:这个项目的需要发送邮件给哪些人,可以在这里输入多个邮箱,中间以英文逗号隔开
Project Reply-To List:保持默认即可,这个是收到邮件的人回复邮件时候回复给谁用的,一般不会回复邮件
Content Type:可以选择Html或者Default也行,因为我们在jenkins系统设置中的默认格式就是html
Default Subject: 邮件主题,可以书写成:XXX项目iOS打包通知:$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS! 分析下这几个参数什么意思:$PROJECT_NAME 构建项目的名称;$BUILD_NUMBER 构建的号码;$BUILD_STATUS 构建状态,这几个参数,它会自动读取,按照这种格式书写即可
Default Content:邮件内容,以下内容为模板,可直接复制修改使用:

<hr/>
本邮件是程序自动下发的,请勿回复!<br/><hr/>
项目名称:$PROJECT_NAME<br/><hr/>
构建编号:$BUILD_NUMBER<br/><hr/>
构建状态:$BUILD_STATUS<br/><hr/>
触发原因:${CAUSE}<br/><hr/>
构建日志地址:<a href="${BUILD_URL}console">${BUILD_URL}console/</a><br/><hr/>
构建地址:<a href="$BUILD_URL">$BUILD_URL</a><br/><hr/>
构建报告:<a href="${BUILD_URL}testReport">${BUILD_URL}testReport/</a><br/><hr/>
变更集:${JELLY_SCRIPT,template="html"}<br/><hr/>
  1. Jenkins卸载方法(Windows/Linux/MacOS)
  • 如果使用brew安装的,可以执行以下命令$ brew uninstall jenkins
  • 注:Jenkins修改工程的工作空间
    在项目的配置中点击高级,选择使用自定义工作空间,输入工作空间路径即可

-------------本文结束感谢您的阅读-------------
最近的文章

iOS 关于Other Linker Flags的作用

在用第三方库时,我们常常在Xcode的Build Settings下Other Linker Flags里面加入-ObjC标志,它和Objective-C的一个重要特性:类别(category)有关 根据官方的解释,Unix的标准静态库实现和Objective-C的动态特性之间有一些冲突:Obje …

代码库 继续阅读
更早的文章

iOS 插件化开发(动态库研究)

framework是一种优秀的资源打包方式,我们平时看到的第三方发布的framework大部分都是静态库,苹果对iOS允许使用动态库,但是要利用动态库热更新,由于苹果的审核和签名技术,暂时还是不行,内部使用还是可行的 思路:在用户想使用某个功能的时候让其从服务器上将动态库文件下载到本地,然后手动 …

代码库 继续阅读