Jenkins-iOS自动打包流程

Jenkins iOS自动打包流程

背景

在开发中我们经常需要打测试包，然后上传至蒲公英等三方平台，这其中需要经历的操作为：

  • Git仓库拉取代码
  • 设置项目的打包环境
  • 利用 xcode 进行打包
  • 上传至蒲公英等三方平台

每一次打包，上面的过程必不可少，而且都是手工的，本篇文章我们将采用CD（Continuous Delivery）持续交付和CI（Continuous Integration）持续集成来进行自动化打包一键操作，解放双手，拒绝手动的重复低效率劳动。

本篇文章讲解如何使用 Jenkins + shell脚本 以及 Jenkins + fastlane 自动打包发布至蒲公英等三方平台。

CI/CD（持续集成、持续交付/持续部署）

CI/CD 是一种通过在应用开发阶段引入自动化来频繁向客户交付应用的方法。

CI/CD 的核心概念是持续集成、持续交付和持续部署。作为一个面向开发和运营团队的解决方案，CI/CD 主要针对在集成新代码时所引发的问题。

具体而言，CI/CD 可让持续自动化和持续监控贯穿于应用的整个生命周期（从集成和测试阶段，到交付和部署）。这些关联的事务通常被统称为“CI/CD 管道”，由开发和运维团队以敏捷方式协同支持。

  • CI（Continuous Integration）是指持续集成，它属于开发人员的自动化流程。成功的 CI 意味着应用代码的新更改会定期构建、测试并合并到共享存储库中。该解决方案可以解决在一次开发中有太多应用分支，从而导致相互冲突的问题。

  • CD（Continuous Delivery/Deployment）是指持续交付或持续部署

    • 持续交付通常是指开发人员对应用的更改会自动进行错误测试并上传到存储库（如 GitHub 或容器注册表），然后由运维团队将其部署到实时生产环境中。这旨在解决开发和运维团队之间可见性及沟通较差的问题。因此，持续交付的目的就是确保尽可能减少部署新代码时所需的工作量。

    • 持续部署（另一种“CD”）指的是自动将开发人员的更改从存储库发布到生产环境，以供客户使用。它主要为了解决因手动流程降低应用交付速度，从而使运维团队超负荷的问题。持续部署以持续交付的优势为根基，实现了管道后续阶段的自动化。

详细流程

20210304175817690.png

自动化打包流程

graph LR
    1[本地代码] --提交--> 2[远程仓库] --> 3[Jenkins自动打包] --> 4[部署发布到蒲公英/Testflight] --> 5[结果邮件/钉钉/QQ通知]

Jenkins概述

Jenkins 是一款流行的开源持续集成（Continuous Integration）工具，广泛用于项目开发，具有自动化构建、测试和部署等功能。

安装Jenkins环境

使用 Homebrew 软件包管理器安装Jenkins

没有Homebrew的请先安装Homebrew，网上资料很多，这里不再赘述。

安装命令

  • 安装最新的LTS版本：brew install jenkins-lts
  • 安装特定的LTS版本：brew install jenkins-lts@YOUR_VERSION
  • 启动 Jenkins 服务：brew services start jenkins-lts
  • 重新启动 Jenkins 服务：brew services restart jenkins-lts
  • 更新 Jenkins 版本：brew upgrade jenkins-lts

安装步骤

  • 启动 Jenkins 服务后，浏览 http://localhost:8080 ，该页面需要确认是管理员安装，让我们输入密码，根据提示获取管理员密码，点击继续。
  • 选择安装推荐的插件，等待插件安装完毕。
  • 插件安装完成后会自动跳转到配置管理员账户页，配置完成点击保存并完成注册。
  • 浏览器输入 http://localhost:8080 打开Jenkins，登录即可。

Jenkins 配置-iOS

安装相关插件

构建xcode项目需要安装的插件

  • Git Parameter：分支管理

在Jenkins首页->系统管理->插件管理搜索相关插件进行安装即可。

环境变量配置

选择系统管理 -> 系统配置 -> 全局属性 -> 勾选环境变量选项
键：PATH
值：在终端中输入echo $PATH将输出内容复制填写。

image-20220605203314715.png

新建任务

创建任务

在Jenkins首页->新建任务中输入任务名称，选择构建一个自由风格的软件项目，点击确定。

image-20220604085359715.png

任务相关配置

选择General -> 参数化构建过程 -> Git参数

image-20220604085859262.png

填写名称，选择类型为分支类型，默认origin/master

image-20220604090215644.png

选择源码管理 -> Git，输入仓库地址，添加账号密码。

image-20220604095423461.png

选择构建 -> 增加构建步骤 -> 执行shell

image-20220605190845531.png

添加打包脚本，保存。

Fastlane打包

1、简介
Fastlane是用Ruby语言编写的一套自动化工具集和框架，每一个工具实际都对应一个Ruby脚本，用来执行某一个特定的任务，而Fastlane核心框架则允许使用者通过类似配置文件的形式，将不同的工具有机而灵活的结合在一起，从而形成一个个完整的自动化流程。

2、原理

  • Fastlane命令执行的底层并不是自己实现的，而是调用其他的插件或者工具执行的。
  • 核心一：打包命令，Fastlane中的gym工具只是xcodebuild工具的一个封装。因此安装Fastlane的步骤里有安装IDE的指令集。
  • 核心二：iTC（即iTunesConnect 苹果的账号证书应用管理平台）命令。苹果除了提供图形化可操作的网页之外，还提供相对应的一整套底层 API 给开发者使用，Fastlane的底层操作是封装的这套API。

我们iOS开发者，感觉最繁琐的事就是打包上架了，打包过程不仅繁琐还特别耗费时间。那么有没有工具能将我们解放出来呢？有，答案就是Fastlane。Fastlane是移动端App开发的脚本工具。
使用Fastlane自动打包上传的基本步骤如下：
1、安装Fastlane -> 2、Fastlane初始化 -> 3、配置证书和描述文件 -> 4、一键上传

  • Fastlane的安装有多种途径，其中之一就是使用sudo gem install fastlane命令安装，其他途径这里不再赘述，也是一行命令的事。

  • 可以用命令fastlane --version来查看是否安装成功

  • 在项目中初始化fastlane 使用命令fastlane init，根据提示一步步进行即可。

  • 初始化成功之后，在项目根目录下会多几个文件，Appfile苹果账号信息、Fastfile填写打包脚本的地方（重点、重点、重点）。

  • 若使用蒲公英上传，需安装蒲公英插件，在终端输入fastlane add_plugin pgyer命令，即可安装蒲公英的 fastlane 插件。

Fastlane打包脚本示例（使用Ruby语言）

default_platform(:iOS)

#蒲公英api_key和user_key
api_key = "your api_key"
user_key = "your user_key"
configuration = "Release"#Debug_Production_Server

platform :iOS do
  desc "🚀🚀🚀🚀🚀打包并上传蒲公英🚀🚀🚀🚀"
  lane :pgybeta do
  #指定项目的scheme名称
  scheme = "TuWanApp"
  #更新描述
  update_desc = "更新描述"
  gym(
    #输出的ipa名称
    output_name:"#{scheme}_#{Time.new.strftime("%Y%m%d%H%M")}",
    # 是否清空以前的编译信息 true：是
    clean:true,
    scheme:scheme,
    # 指定打包方式，Release 或者 Debug
    configuration:"#{configuration}",
    # 指定打包所使用的输出方式，目前支持app-store, package, ad-hoc, enterprise, development
    export_method:"ad-hoc",
    # 指定输出文件夹
    output_directory:"./build/pgy",
    )
  pgyer(api_key: "#{api_key}", user_key: "#{user_key}", update_description: "#{update_desc}")
  end
end

Jenkins + Fastlane配置

Jenkins shell脚本

#!/bin/bash
 
export LANG=en_US.UTF-8
 
export LANGUAGE=en_US.UTF-8
 
export LC_ALL=en_US.UTF-8
 
set -e
 
#输出错误
function echo_error() {
    echo "\033[31m$1\033[0m"
}
 
#输出信息
function echo_info() {
    echo "\033[32m$1\033[0m"
}
 
#打包
function packaging() {
 
    echo_info "====================开始===================="
 
    #参数校验 $#  添加到Shell的参数个数
    if [ $# != "1" ] || ([ $1 != "debug" ] && [ $1 != "release" ] && [ $1 != "appStore" ]); then
       echo_error '请指定打包类型：debug, release, appStore'
       exit 1
    fi
 
    #参数配置
    fastlane_output_path="./build/pgy"
    
    #你的蒲公英账号 API Key
    PGY_API_KEY="your api_key"
 
    #定义一些符变量
    export v_env=$1
    export v_project_name="TuWanMusic"
    export v_build_number="${BUILD_NUMBER}"
    export v_git_branch="${GIT_BRANCH}"
    export v_commit_node="$(git log -n 1 --pretty=format:"%h")"
    export v_download_URL="https://www.pgyer.com/8haT"
    export v_QRCode_URL="https://www.pgyer.com/8haT"
    export v_last_10_logs="$(git log -n 10 --pretty=format:"%h %ci %cn%n%s%n")"
 
    echo_info "====================安装pod依赖===================="
    #安装pod依赖
    #rm -rf './Pods/Local Podspecs'
    #pod update
    pod install
 
    #删除构建输出
    rm -rf "${fastlane_output_path}"
    
    #一个项目里面多个target设置
    target="TuWanMusic"
    if [ $1 == "debug" ]; then
        target="TuWanMusic"
    fi
    #版本号
    export v_app_version=$(echo "$(fastlane run get_version_number xcodeproj:OneAset.xcodeproj target:${target}))" | tr -d '\n' | sed -E 's/.*Result: ([0-9\.]*).*/\1/g')
    
 
    #构建
    echo_info "====================构建===================="
    ipa_name="TuWanMusic"
    
    #fastlane打包
    fastlane ${v_env}
 
    #上传二进制包到蒲公英
    if [ $1 != "appStore" ]; then
        echo_info "====================上传二进制包到蒲公英===================="
        resp=$(curl -F "file=@${fastlane_output_path}/${ipa_name}.ipa" -F "_api_key=${PGY_API_KEY}" -F "buildInstallType=1" https://www.pgyer.com/apiv2/app/upload)
        echo "pgy_resp=${resp}"
 
        #解析数据，生成下载地址
        build_key=$(echo "$resp" | tr "\n" " " | sed -E 's/.*"buildKey" *: *"([^"]*)".*/\1/g')
        v_QRCode_URL=$(echo "$resp" | tr "\n" " " | sed -E 's/.*"buildQRCodeURL" *: *"([^"]*)".*/\1/g' | sed -E 's/\\\//\//g')
        v_download_URL="https://www.pgyer.com/apiv2/app/install?_api_key=${PGY_API_KEY}&buildKey=${build_key}"
    
        v_download_URL="https://www.pgyer.com/${build_key}"
 
        echo_info "二维码地址：${v_QRCode_URL}"
 
        echo_info "app下载地址：${v_download_URL}"
            
    fi
    
}
 
export FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT=120
 
#执行打包
packaging ${BuildType}

构建打包任务

选择已创建的任务

image-20220605201225547.png

选择Build with Parameters -> 分支 -> 开始构建。

image-20220605201319733.png

查看控制台输出。

image-20220605202754537.png

补充说明

找不到/ExportOptions/XXXExportOptions.plist文件

  • AdHocExportOptions.plist，AppStoreExportOptios.plist，EnterpriseExportOptions.plist，DevelopmentExportOptions.plist文件可通过Xcode -> Product -> Archive打包生成的ExportOptions.plist文件添加相应前缀重命名即可获得。
  • 在Jenkins -> workspace -> 项目根目录下新建名为ExportOptions的文件夹，将相应plist文件拷贝到改文件夹中即可。
image-20220605204922279.png

证书及描述文件

在Xcode中配置完成即可。

大文件拉取git-lfs报错

  1. 运行brew install git-lfs即可安装

  2. 若不再需要大文件支持，可前往项目根目录 -> .git -> hooks -> 移除post-checkout文件即可。

拉取代码出错

cd到Jenkins -> workspace目录下，手动通过git clone将工程clone到本地，重启Jenkins，再次执行打包任务。

局域网使用IP访问jenkins

使用brew安装jenkins会避免很多其他安装方式产生的用户权限问题，但是会将httpListenAddress默认设置为127.0.0.1，这样我们虽然可以在本地用localhost:8080访问，但是本机和局域网均无法用ip访问。

解决办法为修改两个路径下的plist配置：

  • ～/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
  • /usr/local/opt/jenkins/homebrew.mxcl.jenkins.plist

第二个路径找不到的话，cmd + shift + G 输入/opt/homebrew/opt/jenkins，找到homebrew.mxcl.jenkins.plist

将上面两个plist中的httpListenAddress后的ip地址，修改为本机IP或者0.0.0.0，修改完成后，重启Jenkins，接下来就可以使用IP访问了。

fastlane版本升级注意事项

  1. 需要修改项目中Gemfile文件中的fastlane版本为当前要升级的版本；
  2. cd到项目目录下，执行bundle install，重新安装您的 gem 依赖；
  3. 再次运行 bundle update fastlane ；
  4. 重启电脑，环境变量生效；
  5. 若Jenkins中的fastlane版本仍然没有升级到最新，可以使用Jenkins新建任务的方式，在新建任务中添加构建shell脚本，执行如下代码：
echo 你的电脑密码 | sudo -S bundle update fastlane
fastlane --version
  1. 若版本仍然没有更新，请前往ruby安装目录下，卸载fastlane其他旧版本，只留新版本即可。
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,602评论 6赞 481
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,442评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 152,878评论 0赞 344
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,306评论 1赞 279
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,330评论 5赞 373
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,071评论 1赞 285
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,382评论 3赞 400
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,006评论 0赞 259
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,512评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,965评论 2赞 325
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,094评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,732评论 4赞 323
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,283评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,286评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,512评论 1赞 262
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,536评论 2赞 354
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,828评论 2赞 345

推荐阅读更多精彩内容