【iOS】(干货篇)命令行执行单元测试，execute XCTest in command line

写在前面

之前的文章因为是一边操作一边记录的，所以有点乱，信息比较多。这里主要是说操作流程以及配置方法。
你需要具备的是：会写XCTest框架下的单元测试，会配置Jenkins，看得懂Python。
！！！相关脚本都是xcode11的，老的xcode版本生成的测试结果文件我没试过。
我们假设你已经写好了UT，启动模拟器的时候，本地通过command + U 是可以执行全部单元测试或者UI用例的，且执行通过。如果你才刚写了一个，或者执行全部用例会失败，那我们就先执行一个UT即可
-only-testing "${SCHEME_NAME}/GMDeviceTests/testExample"这个就是只执行target名为”SCHEME_NAMEGM -->DeviceTests类中testExample这一个用例。如果执行全部，就去掉脚本中的这个参数即可。

参考JerryChu 的文章和源码,感谢！！！

干货

FRAMEWORK_NAME='DemoDraven'
SCHEME_NAME='DemoDravenTests'
SIMULATOR='platform=iOS Simulator,name=iPhone 11 Pro,OS=13.3'

#进入到test.sh所在的目录,执行本文件
#Author:DravenLu
project_path=$(cd `dirname $0`; pwd)
TEST_PATH="${project_path}/TestScript"
echo ${TEST_PATH}

####最简单版执行所有的UT,编译文件,执行的结果什么的都是默认的路径
#-only-testing "${SCHEME_NAME}/GMDeviceTests/testExample"  执行某一个用例,执行全部去掉这个参数即可
#xcodebuild test -only-testing "${SCHEME_NAME}/GMDeviceTests/testExample" -project ${FRAMEWORK_NAME}.xcodeproj -scheme ${SCHEME_NAME} -destination 'platform=iOS Simulator,name=iPhone 11 Pro,OS=13.3'


####
####进阶版 编译 执行分开的,并且可以拿到测试结果


##如果输出目录存在，即移除该目录，再创建该目录。目的是为了清空输出目录。
DerivedDataPath="${TEST_PATH}/DerivedPath"

if [ -d ${DerivedDataPath} ]; then
rm -rf ${DerivedDataPath}
fi
mkdir -p ${DerivedDataPath}

ResultBundlePath="${TEST_PATH}/CoverageJSON"

if [ -d ${ResultBundlePath} ]; then
rm -rf ${ResultBundlePath}
fi
#这里不创建ResultBundlePath,不然 -resultBundlePath 这一行会报错,详情看-resultBundlePath参数的描述


##build-for-testing  在一个destination里只会创建一个xctestrun文件,所以-xctestrun参数的值,不用写死,写成变量
#xcodebuild build-for-testing -project ${FRAMEWORK_NAME}.xcodeproj -scheme ${SCHEME_NAME} -destination "${SIMULATOR}" -derivedDataPath "${DerivedDataPath}"
#
##xcodebuild test-without-building -xctestrun "${TEST_PATH}/DerivedPath/Build/Products/DemoDravenTests_iphonesimulator13.2-x86_64.xctestrun" -destination "${SIMULATOR}" -resultBundlePath /Users/Draven/Desktop/CheckReport
#XctestrunFilePath=`ls ${TEST_PATH}/DerivedPath/Build/Products/*xctestrun`
#
##上面注释的这一行优化成这样
#xcodebuild test-without-building -xctestrun "${XctestrunFilePath}" -destination "${SIMULATOR}" -resultBundlePath "${ResultBundlePath}"
##但是,我本地这样写不行,老是报找不到.xctestconfiguration(此处记为BUG1)
##Unable to load configuration data from specified path XXX.xctestconfiguration; error: The file “XXX.xctestconfiguration” couldn’t be opened because there is no such file.

####
####于是改成下面这样
xcodebuild test -only-testing "${SCHEME_NAME}/GMDeviceTests/testExample" -project ${FRAMEWORK_NAME}.xcodeproj -scheme ${SCHEME_NAME} -destination "${SIMULATOR}" -derivedDataPath "${DerivedDataPath}"
#去掉了resultBundlePath 参数,反正在derivedDataPath里面也能看到执行的结果

XctestResultFilePath="${DerivedDataPath}/Logs/Test/*xcresult"
XctestResultJSONPath="${ResultBundlePath}"

echo "分析测试结果中...."
echo ${XctestResultFilePath}

ruby "${TEST_PATH}/unitTestInfo.rb" --xcresult-path="${XctestResultFilePath}" --output-file="TestScript/test-result.txt"

xcrun xccov view --report --json ${XctestResultFilePath} > ${XctestResultJSONPath}

ruby "${TEST_PATH}/targetCoverage.rb" --cov-json-path="${XctestResultJSONPath}" --output-file="TestScript/test-coverage-result.html"

##参考JerryChu 的文章,感谢
##https://github.com/JerryChu/UnitTestParser

##测试结果覆盖率不满足直接exit,哈哈哈,大概就是这样

上面贴的是符合我项目的test.sh的脚本
目录如下图

1591082067840_A72AC96B-4855-451B-BA36-845AEED8957B.png

其他的几个.rb文件可以在前面提到的JerryChu的github上找到

操作

配置好了之后，Jenkins里面在加一个脚本，拿到覆盖率之后，条件判断下是否让这次构建成功。
也可以本地命令行里面，直接.../.../test.sh 就可以了。

命令行里面的执行效果

1591082829705_679222E1-5705-410E-8C1E-77F4A3209F31.png

html显示的覆盖率结果

1591082743148_A3587EDA-6A39-4A81-B1EE-E3C50A5EA693.png

总结

其实吧，如果是要说效率，还是直接搞fastlane方便。
但是自己把这里面的一行行脚本，写成自己需要的样子，总归是好的。工具是好了，开始老老实实的补充UT去了，好在我的项目没有UI，所以只需要关注逻辑代码的UT即可。