作者：京東零售?吳滔

本教程將使用北汽登錄模塊為例，一步一步和大家一起搭建單元測(cè)試用例，并在Bamboo上跑起來，最終測(cè)試結(jié)果和代碼覆蓋率會(huì)Bamboo上匯總。

模塊名稱：BQLoginModule,是通過iBiu創(chuàng)建的一個(gè)模塊工程

一 建立單元測(cè)試Bundle

ProductName: BQLoginTests

二 測(cè)試代碼編寫

1 配置文件同步

如果我們要在測(cè)試代碼使用我們?cè)赑od里的類，需要同步 Targets Support Files/Pods-BQLoginTests/Pods-BQLoginTests.debug.xcconfig 文件的內(nèi)容到 Targets Support Files/Pods-BQLoginUITests/Pods-BQLoginUITests.debug.xcconfig,直接內(nèi)容copy就成了，只是每次用iBiu安裝過后都要做這個(gè)操作，后續(xù)使用腳本實(shí)現(xiàn)同步：

2 測(cè)試代碼編寫

具體的編寫我這里就過多介紹了，網(wǎng)上教程一大篇，這里就不多說了，如果沒有做性能測(cè)試，這里可以把自動(dòng)生成的 testPerformanceExample 屏蔽掉。

三 運(yùn)行單元測(cè)試

用 command+u，或者菜單（product->test)執(zhí)行，就能獲得結(jié)果

結(jié)果在這里看：

完成以上操作，基本的單元測(cè)試就OK了

下面我們用命令行來跑下單元測(cè)試，首先進(jìn)入工程目錄：

cd BQLoginModule/Example

執(zhí)行如下命令：

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

請(qǐng)大家注意將 workspace/scheme /模擬器信息 修改為自己工程對(duì)應(yīng)信息，就可以看到結(jié)果

四 代碼覆蓋率

1 單元覆蓋率

在XCode打開覆蓋率統(tǒng)計(jì)，我們只打開我們的庫做代碼覆蓋就成了，Xcode 12.4在如下地方：

在Pod里面BQLoginModule設(shè)置 BuildSettings 查找 "cov" ,把 以下2項(xiàng)都設(shè)置為YES；

然后我們跑下單元測(cè)試，就可以看到覆蓋率結(jié)果了：

2 Bamboo報(bào)告

因?yàn)槲覀冃枰贐amboo上匯總覆蓋率報(bào)告，這里我們使用iBiu的一個(gè)高級(jí)特性：用 Podfile.custom 文件加載通用cocoapods的外網(wǎng)庫來使用，具體見圖：

這里我們引入2個(gè)庫： OCMock（單元測(cè)試必備的Mock庫) XcodeCoverage(覆蓋率統(tǒng)計(jì)的庫）

加入這個(gè)文件后，需要使用 iBou重新安裝下組件

做如下設(shè)置：

這個(gè)命令主要是生成XcodeCoverage的環(huán)境依賴 env.sh 我們打開文件看下，文件路徑如下

env.sh內(nèi)容如下：

這里 OBJECT_FILE_DIR_normal 和 SRCROOT指向的是我們Example工程，我們是需要對(duì)Pods里的BQLoginModule里的代碼做單元覆蓋，這2個(gè)環(huán)境變量修改如下：

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目錄，并運(yùn)行命令:

./getcov -x -s -o xmlout 

可以得到如下結(jié)果：

還可以查看哪些代碼沒被覆蓋，和Bamboo結(jié)果對(duì)齊：

完成以上步驟，就完成了本地用命令號(hào)完成單元測(cè)試的所有步驟，下面我們接著來看要在Bamboo上輸出報(bào)告需要怎么做。

五 Bamboo操作

1 創(chuàng)建應(yīng)用

這里要確保對(duì)應(yīng)庫和依賴的庫 ，給 xn_testdev_ci賬號(hào)開權(quán)限

2 新建流水線

選擇 “從零開始創(chuàng)建”

3 配置流水線

基礎(chǔ)信息里面的選擇如下

需要用到以下四個(gè)原子：

“下載代碼”--大家可先配置使用“下載代碼-iBiu”這個(gè)原子,我用這個(gè)一直使用不成功，所以直接用“下載代碼”來手動(dòng)配置：

“自定義腳本”--因?yàn)楝F(xiàn)在iOS的單元測(cè)試還沒有對(duì)應(yīng)的原子操作，所有我們通過自己寫腳本來完成：

“單元測(cè)試”--你沒看錯(cuò)，就是用java的單元測(cè)試原子，我們輸出的結(jié)果和這個(gè)原子匹配，所以選他就成了

“GCC代碼覆蓋率”

其中“單元測(cè)試”和“代碼覆蓋率”的路徑是可以修改的，這個(gè)可以根據(jù)自己的實(shí)際路徑修改

4 自定義腳本

說明：

1 下載代碼和配置iBiu都是自己的命令行來做的，但是需要開始配置下git用戶信息

2 開始我用命令行寫全部命令，但是Bamboo的命令行規(guī)則會(huì)導(dǎo)致一些的shell指令的失效，所以我采用把 shell命令 寫到文件上傳到git倉庫，然后執(zhí)行的方式來完成

3 結(jié)果轉(zhuǎn)換會(huì)還會(huì)用到 ocunit2junit 和 xcpretty 這2個(gè)命令，如果這2個(gè)命令出錯(cuò)，請(qǐng)聯(lián)系Bamboo同事協(xié)助安裝下

4 大家在寫shell命令時(shí)，不知道文件是否生成，可以多用 ls 來看目錄下的文件

5 重點(diǎn)：

• 為了手動(dòng)安裝iBiu配置，請(qǐng)將本機(jī) ~/Library/Application Support/iBiu/BQLoginModule/下的2個(gè)文件 spec_sources 和 pod_setup 上傳到git，我是copy到 Example/BQLoginModule/Resource目錄下然后上傳到git倉庫，這個(gè)目錄可以修改，然后修改對(duì)應(yīng)shell 命令的目錄就成了
• iBiu建的git倉庫默認(rèn)會(huì)過濾一些內(nèi)容，修改 BQLoginModule 工程目錄下的 .gitignore 文件，需要上傳xcworkspacedata內(nèi)容

• 代碼覆蓋率設(shè)置，XcodeCoverage的說明強(qiáng)調(diào)了不要用于AppStore的工程，為了避免線上事故，我們通過命令來設(shè)置，不直接在工程里設(shè)置：

所以修改xcode的構(gòu)建命令新加 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結(jié)果

覆蓋率下載地址：

六 腳本匯集

1 本地腳本

以BQLoginModule為例，最終本地腳本命令如下，大家可以重新找到本地目錄執(zhí)行查看效果：

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部分，一個(gè)是在Bamboo上執(zhí)行的腳本

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倉庫來執(zhí)行，大家做的時(shí)候注意修改變量名稱：

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

七 錯(cuò)誤速查

這里匯集了在寫腳本時(shí)的一些錯(cuò)誤，方便大家查看

1 不能在測(cè)試工程引用自己的代碼

請(qǐng)參看 二--1 ”配置文件同步“ 解決

2 在Bamboo上的Pods文件夾，沒有拉到iBiu的其他配置信息

請(qǐng)參看 五--4 ”自定義腳本“的重點(diǎn) 1 來解決

3 “No coverage data in result bundle”

請(qǐng)參看 五--4 ”自定義腳本”的重點(diǎn) 2 來解決

4 使用命令行跑單元測(cè)試時(shí)，一直提示不能找到模擬器

-destination 'platform=iOS Simulator,name=iPhone 8,OS=13.2.2' 改為 -destination 'id=xxxxxxxxxx' 這種格式，id為屏幕提示

5 Bamboo Shell里提示 “未設(shè)置原子執(zhí)行條件”

因?yàn)锽amboo的Shell對(duì)字符拼接，變量的處理有限制，所以一部分shell命令最好放在文件執(zhí)行

6 在本地測(cè)試時(shí)，Pods/XXXXModule的設(shè)置項(xiàng)在每次iBiu安裝后都會(huì)重置

請(qǐng)注意手動(dòng)修改，或者直接使用腳本運(yùn)行

7 在本地測(cè)試時(shí)，代碼覆蓋率只包含了一部分源碼文件，不是全部

請(qǐng)清空 ~/Library/Developer/Xcode/DerivedData 目錄再測(cè)試一次

8 在Bamboo上發(fā)現(xiàn)有些庫拉不下來

請(qǐng)確保 對(duì)應(yīng) 庫給xn_testdev_ci開了權(quán)限

9 覆蓋率文件生成不了

請(qǐng)確保XXXTests的版本信息和主工程的XXXXModule_Example的版本信息一致文章來源地址http://www.zghlxwxcb.cn/news/detail-438640.html

到了這里，關(guān)于在Bamboo上怎么使用iOS的單元測(cè)試的文章就介紹完了。如果您還想了解更多內(nèi)容，請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！