開源播放器CicadaPlayer單元測試之Googletest和cmake

CicadaPlayer

在Mac和Linux下使用Googletest結合cmake進行單元測試，并且可以在Travis伺服器上進行單元測試，下面我們就來介紹一下如何實作

使用cmake整合googletest

首先呢，我們需要“安裝”Googletest，這裡呢，我們直接使用cmake的FetchContent功能，直接使用，無需手動安裝

我們可以建立一個cmake檔案，比如

GoogleTest.cmake

此檔案參考

cmake-cookbook

為了工程上使用友善，我做了一下提煉

include(FetchContent)

FetchContent_Declare(
        googletest
        GIT_REPOSITORY https://github.com/google/googletest.git
        GIT_TAG release-1.8.0
)

FetchContent_GetProperties(googletest)

if (NOT googletest_POPULATED)
    FetchContent_Populate(googletest)

    # Prevent GoogleTest from overriding our compiler/linker options
    # when building with Visual Studio
    set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
    # Prevent GoogleTest from using PThreads
    set(gtest_disable_pthreads ON CACHE BOOL "" FORCE)

    # adds the targers: gtest, gtest_main, gmock, gmock_main
    add_subdirectory(
            ${googletest_SOURCE_DIR}
            ${googletest_BINARY_DIR}
    )

    # Silence std::tr1 warning on MSVC
    if (MSVC)
        foreach (_tgt gtest gtest_main gmock gmock_main)
            target_compile_definitions(${_tgt}
                    PRIVATE
                    "_SILENCE_TR1_NAMESPACE_DEPRECATION_WARNING"
                    )
        endforeach ()
    endif ()
endif ()

set(CMAKE_CXX_FLAGS "-fprofile-instr-generate -fcoverage-mapping")      

引用googletest

在需要使用的地方直接

include(GoogleTest.cmake)      

就可以了，而一般情況下一個工程都會有很多的單元測試，一般的做法呢，我們建立一個根CMakeLists檔案，在這個根CMakeLists檔案中引用這個Googletest.cmake檔案即可，如

...
include(GoogleTest.cmake)
add_subdirectory(dataSource)
#add_subdirectory(render)
add_subdirectory(demuxer)
add_subdirectory(decoder)
...      

這樣每個子目錄下的測試檔案都可以直接使用googletest了

如

...
enable_testing()

add_test(
        NAME dataSourceTest
        COMMAND $<TARGET_FILE:dataSourceTest>
)
...      

這樣就添加了一個單元測試

為ctest優化CMakeLists

如果你在每個子目錄的CMakeLists中添加自己的單元測試，當然是沒有問題，這樣的好處是，在你新添加子目錄後，隻需要在這個根CMakeLists中 add_subdirectory就可以了，不需要其他修改。但是如果你準備使用ctest做單元測試，那麼你就需要先進入每一個子目錄下，然後再執行，如果執行完單元測試後還需要做些别的，如覆寫率統計，那麼整個流程就比較複雜了。并且最麻煩的是不能多任務執行了。

我在這裡選的是另外一種方法，add_test寫在根CMakeLists中，這樣在這個根目錄下執行ctest就可以了，并且支援多任務并行執行

可參考

CMakeLists.txt

project(frameworkUintTest)
cmake_minimum_required(VERSION 3.15)


include(GoogleTest.cmake)
add_subdirectory(dataSource)
#add_subdirectory(render)
add_subdirectory(demuxer)
add_subdirectory(decoder)

enable_testing()

add_test(
        NAME dataSourceTest
        COMMAND $<TARGET_FILE:dataSourceTest>
)

#add_test(
#        NAME renderTest
#        COMMAND $<TARGET_FILE:renderTest>
#)

add_test(
        NAME demuxerUnitTest
        COMMAND $<TARGET_FILE:demuxerUnitTest>
)

add_test(
        NAME decoderUnitTest
        COMMAND $<TARGET_FILE:decoderUnitTest>
)      

如在Travis伺服器上

https://github.com/alibaba/CicadaPlayer/blob/develop/.travis.yml

- cd mediaPlayer/tests/
  - ctest -j8 --output-on-failure      

如此就可以了

愛詞霸

劃詞翻譯

自動發聲

自動添加生詞本