美文网首页iOS 技术文档收录Jenkins 打包
iOS 底层原理38：自动化打包（二）Jenkins + Git

iOS 底层原理38：自动化打包（二）Jenkins + Git

作者: Style_月月 | 来源:发表于2022-04-14 18:52 被阅读0次

    iOS 底层原理 文章汇总

    前提

    一般大型的公司都有部署好的Jenkins环境，所以这里不在赘述Jenkins的搭建过程，对于Jenkins不了解的童鞋可以自行google下。

    Jenkins作为可扩展的自动化服务器，可用作简单的持续集成(CI，Continuous Integration)服务器，或是持续交付(CD，Continuous Deployment)中心。其特点如下：

    • 即时性。Jenkins是一个基于Java运行的程序，可立即运行，包含Windows、MacOSX、Linux等。

    • 配置简单。可以通过网页轻松配置

    • 插件丰富。目前有1000多插件

    • 扩展性强，Jenkins可以通过插件架构进行扩展，从而为Jenkins提供了无限可能

    • 分布式部署，可以在多态机器上分配工作，帮助开发者快速构建、测试等

    所以，对于开发者来说，Jenkins可以简单的通过配置git源和xcode插件配置打包项，就可以实现服务器自动打包了。

    Jenkins实现自动打包的方式主要有两种：

    • 无Jenkins服务器： 搭建Jenkins服务器 + 配置环境 + 自动打包配置
    • 有Jenkins服务器： 创建Mac从节点 + 配置环境 + 自动打包配置

    备注：以下配置的前提都是基于已部署好的Jenkins服务器进行的。

    Jenkins环境配置

    全局的配置主要是配置打包所需的证书和签名。使用管理员账户登录Jenkins，安装以下插件

    上传证书

    • 1、将发布证书+签名相关文件夹拷贝至桌面，并将login.keychain-db 改为 login.keychain

    • 2、manage jenkins -> Keychains and Provisioning Profiles Management -> 选择login文件并upload

      上传keychain

    • 3、填写正确的code signing，如下所示，红框中的内容就是code signing的值


      codeSigning

    最终效果如下


    证书最终效果

    上传签名

    • 1、填写Provisioning Profiles文件的具体路径，格式为：/Users/管理员用户名/Library/MobileDevice/Provisioning Profiles

    • 2、拷贝具体的签名，并upload，最终效果如下所示


      签名最终效果

    Mac从节点创建

    【前提】：Jenkins的master是Linux系统，首先尝试在Linux打包，但是结果不尽人意，主要有以下问题

    • 1、pod 命令找不到，使用npm，但是npm命令不会生成.xcworkspace文件
    • 2、xcodebuild命令找不到，有文档提示使用Facebook提供的xcbuild，但是仍然报错

    【结论】

    • iOS在Linux打包比较复杂，需要找到pod、xcode命令相关的替代命令，以及其他未发现的坑。
    • 所以为了更好的将自动化应用起来，采用了jenkins配置MaxOSX从节点，用于解决pod、xcode命令找不到的问题。

    创建Mac从节点的步骤如下：

    • 1、开启要绑定的MacOSX系统的电脑的远程登录：系统偏好设置☞共享☞勾选☞远程登录。用于获取远程登录的用户名 + IP

      配置远程登录

    • 在MacOSX的user文件中创建Jenkins文件夹：/User/Shared/Jenkins，需要开放读写权限

      配置Jenkins文件夹

    • 3、管理员账户登录jenkins，创建从节点：Manage Jenkins ☞ Manage Node and Clouds ☞ New Node

      创建从节点-01
      创建从节点-02

    • 4、配置节点：需要提前安装配置Slave节点的插件：SSH Slaves plugin

      配置从节点

    其中Credentials的配置如下所示：add -> Jenkins -> 选择Username with password

    配置Credentials

    • 5、到此为止，节点创建完成了，会自动连接：MacOSX -> log查看连接日志，以便及时排查问题


      从节点成功效果

    创建iOS项目

    • 1、新建项目：New Item，填写项目名称，选择项目风格


      新建item

    通用配置

    • 2、【特别提醒！！！】在项目时，需要配置运行的节点：项目 -> configure -> General
      选择运行节点

    源码配置

    • 3、配置源码 - Source Code Management


      配置源码

    说明：

    • git源码链接：最好是SSH的链接，不要https的
    • 配置源码的分支，一般是master

    • credential：Add - Jenkins - SSH Username with private key，粘贴SSH


      配置git的Credential

    Item环境配置

    • 4、配置编译环境 - Build Environment
      配置keychain，选择对应的code signing（注：创建项目后，需要点击Apply，可能才会显示配置好的证书签名）


      配置code signing

    自动打包脚本配置
    构建打包shell脚本，主要分为两部分

    • git clone源码 + pod install
    # 使用方法
# 1、替换自己项目：项目文件夹名（同git名一致）、git地址
# 2、


# 使用cocoapods需要加入这句
#!/bin/bash -l 
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8


# 项目的参数 build：表示是否进行编译
if [ $build == false ]; then
  exit
fi

if [ -d "xxxxx" ]; then
    echo '----------已有项目----------'
else
    echo '----------下载项目----------'
    # 需要替换成自己项目的地址
    git clone git@xxxxx.git  
fi

# 进入项目文件夹
cd xxxxx
echo 'pod install路径--'${workdir}
# 切换分支
git checkout dev
# 拉取最新代码 git pull origin 【远程分支名】:【本地分支名】
git pull origin dev:dev


# 更新pod
# 跳转至podfile所在目录
cd xxxxx
cur_dir=$(pwd)
echo '-----------install路径--'${cur_dir}
echo '---------------------------------------'
pod install
    • 打ipa包 + 上传AppStore
    #项目名
PROJECT_NAME='xxxxx'

#App名称
APP_NAME='xxxxx'

#scheme名称
SCHEME_NAME='xxxxx'

#打包模式
CONFIGURATION=release

#  下面两个参数只是在手动指定Pofile文件的时候用到，如果使用Xcode自动管理Profile,直接留空就好
# (跟method对应的)mobileprovision文件名，需要先双击安装.mobileprovision文件.手动管理Profile时必填
mobileprovision_name=""

# 项目的bundleID，手动管理Profile时必填
bundle_identifier=""

echo "--------------------脚本配置参数检查--------------------"
echo "PROJECT_NAME = ${PROJECT_NAME}"
echo "APP_NAME = ${APP_NAME}"
echo "SCHEME_NAME = ${SCHEME_NAME}"
echo "CONFIGURATION = ${CONFIGURATION}"
echo "mobileprovision_name = ${mobileprovision_name}"
echo "bundle_identifier = ${bundle_identifier}"


# 指定输出导出文件夹路径，version是项目配置的参数，每次可手动输入
export_path=${cur_dir}/build-${version}
#archive文件存放路径
ARCHIVE_PATH=$export_path/$SCHEME_NAME.xcarchive

#ipa文件存放路径
IPA_PATH=${export_path}/

#plist 文件路径：导出ipa所需的文件
EXPORT_OPTIONS_PLIST_PATH=${cur_dir}/ExportOptions.plist


echo "--------------------脚本固定路径检查--------------------"
echo "export_path = ${export_path}"
echo "ARCHIVE_PATH = ${ARCHIVE_PATH}"
echo "IPA_PATH = ${IPA_PATH}"
echo "EXPORT_OPTIONS_PLIST_PATH = ${EXPORT_OPTIONS_PLIST_PATH}"


# 先删除export_path文件
if [ -f "$export_path" ] ; then
    echo "${export_path}文件存在，进行删除"
    rm -f $export_path
fi



#清理工程
echo "--------------------正在清理工程--------------------"
xcodebuild clean -workspace ${PROJECT_NAME}.xcworkspace -scheme ${SCHEME_NAME}

echo "--------------------清理完成 🎉 🎉 🎉--------------------"

security unlock-keychain -p "1109221208l" ~/Library/Keychains/login.keychain

#生成archive文件
echo "--------------------正在生成 .xcarchive 文件--------------------"
xcodebuild \
-workspace ${PROJECT_NAME}.xcworkspace \
-scheme ${SCHEME_NAME} \
-configuration ${CONFIGURATION} \
-archivePath ${ARCHIVE_PATH} \
archive


#  检查是否构建成功
#  xcarchive 实际是一个文件夹不是一个文件所以使用 -d 判断
if [ -d "$ARCHIVE_PATH" ] ; then
    echo " 项目构建成功 🚀 🚀 🚀  "
else
    echo " 项目构建失败 😢 😢 😢  "
    exit 1
fi
echo "------------------------------------------------------"


#打ipa包
echo "--------------------正在导出 .ipa 文件--------------------"
echo '正在 导出 .ipa 文件'
xcodebuild  -exportArchive \
            -archivePath ${ARCHIVE_PATH} \
            -exportPath ${IPA_PATH} \
            -exportOptionsPlist ${EXPORT_OPTIONS_PLIST_PATH} \
            -allowProvisioningUpdates
       
# 检查文件是否存在
if [ -f "$IPA_PATH/$SCHEME_NAME.ipa" ] ; then
    echo " 导出 ${SCHEME_NAME}.ipa 包成功 🎉  🎉  🎉   "
    echo " ipa包路径：$export_path "
else
    echo " 导出 ${SCHEME_NAME}.ipa 包失败 😢 😢 😢     "
    exit 1
fi

# 输出打包总用时
echo "使用Jenkins打包总用时: ${SECONDS}s "
echo "------------------------------------------------------"


# 将包上传AppStore  
cd build-${version}
ipa_path="$SCHEME_NAME.ipa"
# 上传AppStore的密钥ID、Issuer ID
api_key="FFX6T2CD4W"
issuer_id="69a6de70-bd1a-47e3-e053-5b8c7c11a4d1"

echo "--------------------AppStore上传固定参数检查--------------------"
echo "ipa_path = ${ipa_path}"
echo "api_key = ${api_key}"
echo "issuer_id = ${issuer_id}"

# 项目的参数 upload：表示是否上传AppStore
if [ $upload == false ]; then
  echo "-------未选择上传AppStore--------"
else

    echo "------------------------------------------------------"
    echo "-------准备上传AppStore--------"
    
    # 验证
    validate="xcrun altool --validate-app -f ${ipa_path} -t ios --apiKey ${api_key} --apiIssuer ${issuer_id} --verbose"
    echo "running validate cmd" $validate
    uvalidateApp="$($validate)"
    if [ -z "$uvalidateApp" ]; then
        echo " 校验IPA失败😢 😢 😢   "
        echo "------------------------------------------------------"
    else
        echo " 校验IPA成功🎉  🎉  🎉  "
        echo "------------------------------------------------------"
        
        # 上传
        upload="xcrun altool --upload-app -f ${ipa_path} -t ios --apiKey ${api_key} --apiIssuer ${issuer_id} --verbose"
        echo "running upload cmd" $upload
        uploadApp="$($upload)"
        echo uploadApp
        if [ -z "$uploadApp" ]; then
            echo " 传IPA失败😢 😢 😢   "
            echo "------------------------------------------------------"
            # 发送上传失败邮件通知
            mail -s "ipa上传AppStore失败啦 😢 😢 😢 ，请联系管理员" ${notiEmail}
        else
            echo "上传IPA成功🎉  🎉  🎉 "
            echo "------------------------------------------------------"
            # 发送上传成功邮件通知
            mail -s "ipa上传AppStore成功啦 🎉  🎉  🎉" ${notiEmail}
        fi

    fi
fi
    

exit 0

    备注：mac电脑需要配置上传相关的密钥，参考文章：使用xcrun altool上传ipa

    使用

    • 登录Jenkins，选择对应的打包项目


      选择item

    • 构建一个新的版本


      构建新版本

    • 自动打包过程中可进入具体的版本，查看终端日志


      打包log

    遇到的问题

    在执行pod 命令时，提示pod command not found

    • 解决方法】在shell脚本最前面加上 #!/bin/bash -l
    #!/bin/bash -l
export LANG=en_US.UTF-8

    pod install 私有三方库报错

    code signing报错

    • 报错：Command CodeSign failed with a nonzero exit code
    • 原因：是 Jenkins，ssh 方式到 slave 机上，默认是没有账户的，但是访问钥匙串要求必须有用户身份，所以添加一步输入密码解锁钥匙串，可以给 Jenkins 一个用户身份。
    • 【解决办法】： build 步骤前添加一步解锁钥匙串
    security unlock-keychain -p "login pwd" ~/Library/Keychains/login.keychain

    所以，综上所述，Jenkins自动打包流程如下


    Jenkins自动打包流程图示

    参考文章

    iOS-最新Jenkins自动化打包配置完整教程
    GitLab CI/CD，iOS项目管控实战应用
    部署在 linux 服务器上的 Jenkins 到底能否实现
    从零开始-Linux服务器上用jenkins搭建Java/Android/Ios持续集成环境
    Jenkins配置节点(解决Linux上iOS打包)
    远程Jenkins新增Mac电脑节点

    相关文章

      网友评论

        本文标题：iOS 底层原理38：自动化打包（二）Jenkins + Git

        本文链接：https://www.haomeiwen.com/subject/yxzasrtx.html

        延伸阅读

        深度阅读

        • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

        栏目导航

        热点阅读

        iOS 技术文档收录

        Jenkins 打包

        关于我们|服务条款|联系我们|iOS 底层原理38：自动化打包（二）Jenkins + Git|投稿指南|网站地图|RSS订阅|排版工具|手机版

        提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

        Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

        备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

        本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

        所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！