腾讯云CODING CI(持续集成) iOS项目

一.自定义节点  自定义节点文档

因为coding上默认的构建计划的模板中没有关于我们iOS的构建模板，所以我们需要自定义一个构建过程。

image

二.自定义节点池

因为构建计划需要一个指定的节点池来运行构建任务所以我们需要创建一个新的节点池

以下以Mac os为例：

进入构建节点，选择【接入新节点】->【macOS】，接入方式选择 Bash，在接入配置中选择对应节点池，点击【生成接入配置并复制】。

在终端中输入命令后，等待服务下载完成。安装完成后可以使用以下命令进行验证

qci_worker version

接下来在构建计划中选择我们创建的节点池进行构建

三.构建计划-流程配置

这里我讲一下常规流程：

1、构建开始

2、从代码仓库检出代码（附上默认代码路径：/Users/用户名/codingci/tools/jenkins_home/workspace/xxx）

注：每次代码拉取的时候会在workspace目录下创建项目路径，但是文件名不固定。

3、自定义构建计划（执行shell脚本）

注：实际操作中，我发现我用不到第二步。因为在shell脚本中我使用的是xcodebuild命令打包方式，此方式需要用到项目根目录路径，所以必须要知道拉取代码的具体路径。（每次检出代码的过程会在workspace文件夹下创建项目路径，和脚本路径，具体获取方式我在脚本中写了注释）又因为，项目使用了cocoapod管理第三方库，在拉取代码以后需要执行pod install 来拉取第三方库，在拉取的过程中因为网络原因可能会失败，进而可能导致打包失败的情况。我选择了删除第二步骤，直接打包我的本地代码。

下面附上我的shell脚本：

此脚本参考了coder大神的打包脚本：脚本地址

#!/bin/sh

### 需要根据自己项目的情况进行修改，XXX都是需要进行修改的，可搜索进行修改 ###

# Project名称

PROJECT_NAME=$scheme_name

## Scheme名

SCHEME_NAME=$scheme_name

## 编译类型 Debug/Release二选一

BUILD_TYPE=$build_type

:<<!

// echo "============获取clone下来的项目路径============"

// # 获取当前shell脚本路径

// CURRENT_PATH=$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )

// echo "脚本路径 = ${CURRENT_PATH}"

// ## 项目根路径，xcodeproj/xcworkspace所在路径

// PROJECT_ROOT_PATH=${CURRENT_PATH%@*}

// echo "项目根路径 = ${PROJECT_ROOT_PATH}"

// echo "============获取路径结束============"

!

## 项目根路径，xcodeproj/xcworkspace所在路径

PROJECT_ROOT_PATH=$projectRootPath

## 打包生成路径

PRODUCT_PATH=$project_path

## ExportOptions.plist文件的存放路径，该文件描述了导出ipa文件所需要的配置

## 如果不知道如何配置该plist，可直接使用xcode打包ipa结果文件夹的ExportOptions.plist文件

EXPORTOPTIONSPLIST_PATH=$exportOptionsPlist_path

## workspace路径

WORKSPACE_PATH=${PROJECT_ROOT_PATH}/${PROJECT_NAME}.xcworkspace

## project路径

PROJECT_PATH=${PROJECT_ROOT_PATH}/${PROJECT_NAME}.xcodeproj

:<<!

// ### 开始pod过程 ###

// cd PROJECT_ROOT_PATH  #进入工程目录

// pod install

// ### pod结束 ###

!

### 编译打包过程 ###

echo "============Build Clean Begin============"

## 清理缓存

## workspace形式

xcodebuild clean -workspace ${WORKSPACE_PATH} -scheme ${SCHEME_NAME} -configuration ${BUILD_TYPE} || exit

echo "============Build Clean End============"

#获取Version

VERSION_NUMBER=`sed -n '/MARKETING_VERSION = /{s/MARKETING_VERSION = //;s/;//;s/^[[:space:]]*//;p;q;}' ${PROJECT_PATH}/project.pbxproj`

# 获取build

BUILD_NUMBER=`sed -n '/CURRENT_PROJECT_VERSION = /{s/CURRENT_PROJECT_VERSION = //;s/;//;s/^[[:space:]]*//;p;q;}' ${PROJECT_PATH}/project.pbxproj`

## 编译开始时间,注意不可以使用标点符号和空格

BUILD_START_DATE="$(date +'%Y-%m-%d_%H-%M')"

## IPA所在目录路径

IPA_DIR_NAME=${VERSION_NUMBER}_${BUILD_NUMBER}_${BUILD_START_DATE}

##xcarchive文件的存放路径

ARCHIVE_PATH=${PRODUCT_PATH}/IPA/${IPA_DIR_NAME}/${SCHEME_NAME}.xcarchive

## ipa文件的存放路径

IPA_PATH=${PRODUCT_PATH}/IPA/${IPA_DIR_NAME}

# 解锁钥匙串 -p后跟为电脑密码

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

echo  "============Build Archive Begin============"

## 导出archive包

## workspace形式

xcodebuild archive -workspace ${WORKSPACE_PATH} -scheme ${SCHEME_NAME} -archivePath ${ARCHIVE_PATH} -configuration ${BUILD_TYPE} -allowProvisioningUpdates -destination 'generic/platform=iOS' -quiet || exit

echo "============Build Archive Success============"

echo "============Export IPA Begin============"

## 导出IPA包

xcodebuild -exportArchive -archivePath $ARCHIVE_PATH -exportPath ${IPA_PATH} -exportOptionsPlist ${EXPORTOPTIONSPLIST_PATH} -allowProvisioningUpdates -quiet || exit

if [ -e ${IPA_PATH}/${SCHEME_NAME}.ipa ];

then

echo "============Export IPA SUCCESS============"

open ${IPA_PATH}

else

echo "============Export IPA FAIL============"

fi

# 删除Archive文件，可根据各自情况选择是否保留

# rm -r ${ARCHIVE_PATH}

### 上传过程 ###

## 上传app store

ALTOOL_PATH="/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool"

# 将-u 后面的XXX替换成自己的AppleID的账号，-p后面的XXX替换成自己的密码

# "$ALTOOL_PATH" --validate-app -f ${IPA_PATH}/${SCHEME_NAME}.ipa -u XXX -p XXX -t ios --output-format xml

# "$ALTOOL_PATH" --upload-app -f ${IPA_PATH}/${SCHEME_NAME}.ipa -u  XXX -p XXX -t ios --output-format xml

## 上传到蒲公英

echo "============Upload PGYER Begin============"

## 具体参数可见 http://www.pgyer.com/doc/view/api#uploadApp

PGYER_UPLOAD_RESULT=`curl \

-F "file=@${IPA_PATH}/${SCHEME_NAME}.ipa" \

-F "buildInstallType=1" \

-F "buildPassword=" \

-F "buildUpdateDescription=${build_update_description}" \

-F "_api_key=xxx" \

https://www.pgyer.com/apiv2/app/upload`

echo "============Upload PGYER SUCCESS============"

## 返回结果码，其中0为成功上传，因为返回结果中带回来的有中文显示乱码，无法利用jq解析

四.关于xcodebuild构建过程中遇到的问题：

1、jenkins 无法上传keychain：

我搜索到的文章得到的结论是：大概率是jenkins的版本bug，有两个办法可以解决：

（1）替换jenkins版本

终端中输入：

qci_worker stop 停止进程

找到 config 目录，默认在 ~/codingci/tools/jenkins.war 替换成你想要的 jenkins.war版本，我使用的是2.263版本

终端中输入：

qci_worker up -d 启动进程

（2）shell脚本中绕过Mac的keychain机制

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

以上两种方式我都操作了，以确保打包不会报关于：Xcode couldn't find any iOS App Development provisioning profiles matching ‘xxx’ 或者 There are no accounts registered with Xcode. Add your developer account to Xcode 之类的错误。

2、关于xcodebuild 版本问题：

在做CI之前我先用xcodebuild命令在终端上操作了一下，看一下使用命令行打包这一步是否完全正确。但是不凑巧的是我参考coder大神的命令行怎么也走不通，搜索了大量文章后发现，是每个版本的xcode对应的xcodebuild命令也不一样。我目前的xcode版本号为13.0，新增了一些参数：

（1）-allowProvisioningUpdates //自动管理证书

（2）-destination 'generic/platform=iOS' //设置平台为iOS

---

以上方式仅供参考

0人点赞

iOS

CI

持续集成