关于ios:在Bamboo上怎么使用iOS的单元测试-京东云技术团队

2次阅读

共计 7470 个字符,预计需要花费 19 分钟才能阅读完成。

作者:京东批发 吴滔

本教程将应用北汽登录模块为例,一步一步和大家一起搭建单元测试用例,并在 Bamboo 上跑起来,最终测试后果和代码覆盖率会 Bamboo 上汇总。

模块名称:BQLoginModule, 是通过 iBiu 创立的一个模块工程

一 建设单元测试 Bundle

ProductName: BQLoginTests

二 测试代码编写

1 配置文件同步

如果咱们要在测试代码应用咱们在 Pod 里的类,须要同步 Targets Support Files/Pods-BQLoginTests/Pods-BQLoginTests.debug.xcconfig 文件的内容到 Targets Support Files/Pods-BQLoginUITests/Pods-BQLoginUITests.debug.xcconfig, 间接内容 copy 就成了,只是每次用 iBiu 装置过后都要做这个操作,后续应用脚本实现同步:

2 测试代码编写

具体的编写我这里就过多介绍了,网上教程一大篇,这里就不多说了,如果没有做性能测试,这里能够把主动生成的 testPerformanceExample 屏蔽掉。

三 运行单元测试

用 command+u,或者菜单(product->test) 执行,就能取得后果

后果在这里看:

实现以上操作,根本的单元测试就 OK 了

上面咱们用命令行来跑下单元测试,首先进入工程目录:

cd BQLoginModule/Example

执行如下命令:

xcodebuild test -UseModernBuildSystem=NO -configuration=Debug -workspace './BQLoginModule.xcworkspace' -scheme "BQLoginModule_Example" -destination 'platform=iOS Simulator,name=iPhone 8,OS=13.2.2' 

请大家留神将 workspace/scheme / 模拟器信息 批改为本人工程对应信息,就能够看到后果

四 代码覆盖率

1 单元覆盖率

在 XCode 关上覆盖率统计,咱们只关上咱们的库做代码笼罩就成了,Xcode 12.4 在如下中央:

在 Pod 外面 BQLoginModule 设置 BuildSettings 查找 “cov” , 把 以下 2 项都设置为 YES;

而后咱们跑下单元测试,就能够看到覆盖率后果了:

2 Bamboo 报告

因为咱们须要在 Bamboo 上汇总覆盖率报告,这里咱们应用 iBiu 的一个高级个性:用 Podfile.custom 文件加载通用 cocoapods 的外网库来应用,具体见图:

这里咱们引入 2 个库:OCMock(单元测试必备的 Mock 库 ) XcodeCoverage(覆盖率统计的库)

退出这个文件后,须要应用 iBou 重新安装下组件

做如下设置:

这个命令次要是生成 XcodeCoverage 的环境依赖 env.sh 咱们关上文件看下,文件门路如下

env.sh 内容如下:

这里 OBJECT\_FILE\_DIR_normal 和 SRCROOT 指向的是咱们 Example 工程,咱们是须要对 Pods 里的 BQLoginModule 里的代码做单元笼罩,这 2 个环境变量批改如下:

export OBJECT_FILE_DIR_normal ="/Users/cdwutao3/Library/Developer/Xcode/DerivedData/BQLoginModule-fvrzeicgcswucwfgjqweugauzxia/Build/Intermediates.noindex/Pods.build/Debug-iphonesimulator/BQLoginModule.build/Objects-normal"

export SRCROOT="/Users/cdwutao3/Desktop/ut/BQLoginModule/BQLoginModule/Classes"

而后在 Pods/XcodeCoverage 目录新建 xmlout 目录,并运行命令:

./getcov -x -s -o xmlout 

能够失去如下后果:

还能够查看哪些代码没被笼罩,和 Bamboo 后果对齐:

实现以上步骤,就实现了本地用命令号实现单元测试的所有步骤,上面咱们接着来看要在 Bamboo 上输入报告须要怎么做。

五 Bamboo 操作

1 创立利用

这里要确保对应库和依赖的库,给 xn\_testdev\_ci 账号开权限

2 新建流水线

抉择“从零开始创立”

3 配置流水线

根底信息外面的抉择如下

须要用到以下四个原子:

“下载代码”– 大家可先配置应用“下载代码 -iBiu”这个原子, 我用这个始终应用不胜利,所以间接用“下载代码”来手动配置:

“自定义脚本”– 因为当初 iOS 的单元测试还没有对应的原子操作,所有咱们通过本人写脚本来实现:

“单元测试”– 你没看错,就是用 java 的单元测试原子,咱们输入的后果和这个原子匹配,所以选他就成了

“GCC 代码覆盖率”

其中“单元测试”和“代码覆盖率”的门路是能够批改的,这个能够依据本人的理论门路批改

4 自定义脚本

阐明:

1 下载代码和配置 iBiu 都是本人的命令行来做的,然而须要开始配置下 git 用户信息

2 开始我用命令行写全副命令,然而 Bamboo 的命令行规定会导致一些的 shell 指令的生效,所以我采纳把 shell 命令 写到文件上传到 git 仓库,而后执行的形式来实现

3 后果转换会还会用到 ocunit2junit 和 xcpretty 这 2 个命令,如果这 2 个命令出错,请分割 Bamboo 共事帮助装置下

4 大家在写 shell 命令时,不晓得文件是否生成,能够多用 ls 来看目录下的文件

5 重点:

  • 为了手动装置 iBiu 配置,请将本机 ~/Library/Application Support/iBiu/BQLoginModule/ 下的 2 个文件 spec_sources 和 pod_setup 上传到 git,我是 copy 到 Example/BQLoginModule/Resource 目录下而后上传到 git 仓库,这个目录能够批改,而后批改对应 shell 命令的目录就成了
  • iBiu 建的 git 仓库默认会过滤一些内容,批改 BQLoginModule 工程目录下的 .gitignore 文件,须要上传 xcworkspacedata 内容
  • 代码覆盖率设置,XcodeCoverage 的阐明强调了不要用于 AppStore 的工程,为了防止线上事变,咱们通过命令来设置,不间接在工程里设置:

所以批改 xcode 的构建命令新加 GCC\_INSTRUMENT\_PROGRAM\_FLOW\_ARCS=YES GCC\_GENERATE\_TEST\_COVERAGE\_FILES=YES,命令如下:

xcodebuild -UseModernBuildSystem=NO -enableCodeCoverage=YES -configuration=Debug GCC_INSTRUMENT_PROGRAM_FLOW_ARCS=YES GCC_GENERATE_TEST_COVERAGE_FILES=YES -workspace "./${moduleName}.xcworkspace" -scheme "${moduleName}_Example" -destination 'platform=iOS Simulator,name=iPhone 8,OS=13.2.2' test

5 Bamboo 后果

覆盖率下载地址:

六 脚本会集

1 本地脚本

以 BQLoginModule 为例,最终本地脚本命令如下,大家能够从新找到本地目录执行查看成果:

git clone --depth=1 https://git.jd.com/BQMobileshop/BQLoginModule.git
cd BQLoginModule/Example
pod update


pwd
moduleName="BQLoginModule"
testName="BQLoginTests"


biu -pod install ./
ls
ls ./Pods
rm -f "./Pods/Target Support Files/Pods-${testName}/Pods-${testName}.debug.xcconfig"
cp -f "./Pods/Target Support Files/Pods-${moduleName}_Example/Pods-${moduleName}_Example.debug.xcconfig"  "./Pods/Target Support Files/Pods-${testName}/Pods-${testName}.debug.xcconfig"
cat "./Pods/Target Support Files/Pods-${testName}/Pods-${testName}.debug.xcconfig"


xcodebuild clean -workspace "./${moduleName}.xcworkspace" -scheme "${moduleName}_Example"


xcodebuild  -UseModernBuildSystem=NO -enableCodeCoverage=YES -configuration=Debug GCC_INSTRUMENT_PROGRAM_FLOW_ARCS=YES GCC_GENERATE_TEST_COVERAGE_FILES=YES -workspace "./${moduleName}.xcworkspace" -scheme "${moduleName}_Example" -destination 'platform=iOS Simulator,name=iPhone 8,OS=13.2.2'  test  > utlogfile.txt
cat utlogfile.txt |grep ".xcresult" > utlogpath.txt
logStr=$(cat ./utlogpath.txt)
logPath=${logStr:1}
if [-z "$logPath"]; then
    exit 1
fi


sed "s/${moduleName}.build\/Debug-iphonesimulator\/${moduleName}_Example.build/Pods.build\/Debug-iphonesimulator\/${moduleName}.build/g" ./Pods/XcodeCoverage/env.sh> cov_env1.txt
sed "s/${moduleName}\/Example/${moduleName}\/${moduleName}\/Classes/g" ./cov_env1.txt > cov_env2.txt
cp -f ./Pods/XcodeCoverage/env.sh ./Pods/XcodeCoverage/env_bak.sh
rm -f ./Pods/XcodeCoverage/env.sh
cp ./cov_env2.txt ./Pods/XcodeCoverage/env.sh


cat "./utlogfile.txt"|ocunit2junit
ls test-reports


cp ./cov_env2.txt ./Pods/XcodeCoverage/env.sh
mkdir xmlout
./Pods/XcodeCoverage/getcov -x -o xmlout
ls ./xmlout/lcov


cat "./utlogfile.txt"|xcpretty -t -r html --output testresult/testresult.html
ls te

2 Bamboo 脚本

Bamboo 脚本分成 2 局部,一个是在 Bamboo 上执行的脚本

rm -fr "/Users/admin/Library/Application Support/iBiu/BQLoginModule"
mkdir "/Users/admin/Library/Application Support/iBiu/BQLoginModule"
rm -fr ./BQLoginModule
git clone --depth=1 https://git.jd.com/BQMobileshop/BQLoginModule.git
cd BQLoginModule/Example
cp "./BQLoginModule/Resource/spec_sources" "/Users/admin/Library/Application Support/iBiu/BQLoginModule"
cp "./BQLoginModule/Resource/pod_setup" "/Users/admin/Library/Application Support/iBiu/BQLoginModule"
ls "/Users/admin/Library/Application Support/iBiu/BQLoginModule"
biu -pod install ./


sh UT.sh

脚本剩下局部写入 UT.sh,放在 BQLoginModule/Example 目录下,而后上传到 git 仓库来执行,大家做的时候留神批改变量名称:

pwd
moduleName="BQLoginModule"
testName="BQLoginTests"


ls ./Pods
rm -f "./Pods/Target Support Files/Pods-${testName}/Pods-${testName}.debug.xcconfig"
cp -f "./Pods/Target Support Files/Pods-${moduleName}_Example/Pods-${moduleName}_Example.debug.xcconfig"  "./Pods/Target Support Files/Pods-${testName}/Pods-${testName}.debug.xcconfig"
cat "./Pods/Target Support Files/Pods-${testName}/Pods-${testName}.debug.xcconfig"


xcodebuild clean -workspace "./${moduleName}.xcworkspace" -scheme "${moduleName}_Example"


xcodebuild  -UseModernBuildSystem=NO -enableCodeCoverage=YES -configuration=Debug GCC_INSTRUMENT_PROGRAM_FLOW_ARCS=YES GCC_GENERATE_TEST_COVERAGE_FILES=YES -workspace "./${moduleName}.xcworkspace" -scheme "${moduleName}_Example" -destination 'platform=iOS Simulator,name=iPhone 8,OS=13.2.2'  test  > utlogfile.txt
cat utlogfile.txt |grep ".xcresult" > utlogpath.txt
logStr=$(cat ./utlogpath.txt)
logPath=${logStr:1}
if [-z "$logPath"]; then
    exit 1
fi


sed "s/${moduleName}.build\/Debug-iphonesimulator\/${moduleName}_Example.build/Pods.build\/Debug-iphonesimulator\/${moduleName}.build/g" ./Pods/XcodeCoverage/env.sh> cov_env1.txt
sed "s/${moduleName}\/Example/${moduleName}\/${moduleName}\/Classes/g" ./cov_env1.txt > cov_env2.txt
cp -f ./Pods/XcodeCoverage/env.sh ./Pods/XcodeCoverage/env_bak.sh
rm -f ./Pods/XcodeCoverage/env.sh
cp ./cov_env2.txt ./Pods/XcodeCoverage/env.sh


cat "./utlogfile.txt"|ocunit2junit
ls test-reports


cp ./cov_env2.txt ./Pods/XcodeCoverage/env.sh
mkdir xmlout
./Pods/XcodeCoverage/getcov -x -o xmlout
ls ./xmlout/lcov


cat "./utlogfile.txt"|xcpretty -t -r html --output testresult/testresult.html
ls test

七 谬误速查

这里会集了在写脚本时的一些谬误,不便大家查看

1 不能在测试工程援用本人的代码

请参看 二 –1”配置文件同步“解决

2 在 Bamboo 上的 Pods 文件夹,没有拉到 iBiu 的其余配置信息

请参看 五 –4”自定义脚本“的重点 1 来解决

3“No coverage data in result bundle”

请参看 五 –4”自定义脚本”的重点 2 来解决

4 应用命令行跑单元测试时,始终提醒不能找到模拟器

-destination ‘platform=iOS Simulator,name=iPhone 8,OS=13.2.2’ 改为 -destination ‘id=xxxxxxxxxx’ 这种格局,id 为屏幕提示

5 Bamboo Shell 里提醒“未设置原子执行条件”

因为 Bamboo 的 Shell 对字符拼接,变量的解决有限度,所以一部分 shell 命令最好放在文件执行

6 在本地测试时,Pods/XXXXModule 的设置项在每次 iBiu 装置后都会重置

请留神手动批改,或者间接应用脚本运行

7 在本地测试时,代码覆盖率只蕴含了一部分源码文件,不是全副

请清空 ~/Library/Developer/Xcode/DerivedData 目录再测试一次

8 在 Bamboo 上发现有些库拉不下来

请确保 对应 库给 xn\_testdev\_ci 开了权限

9 覆盖率文件生成不了

请确保 XXXTests 的版本信息和主工程的 XXXXModule_Example 的版本信息统一

正文完
 0