Parasoft C/C++ test 自動(dòng)化用戶指南（五）：命令行選項(xiàng)

---

Parasoft C/C++test針對C/C++開發(fā)的專業(yè)白盒自動(dòng)化測試方案，能有效提高軟件開發(fā)效率和代碼質(zhì)量。C++test 可以進(jìn)行靜態(tài)分析，全面代碼審查，運(yùn)行時(shí)錯(cuò)誤檢測，并在單元測試和組件測試中集成覆蓋率分析。

---

命令行選項(xiàng)

配置測試配置

-config <config_url>

此選項(xiàng)允許您指定將用于分析的測試配置。該選項(xiàng)后面必須跟有內(nèi)置、用戶定義或 DTP 托管的測試配置的名稱。例子：

• cpptestcli -config "builtin://MISRA C"
• cpptestcli -config "user://My_Config"
• cpptestcli -config "dtp://New_Rules"

-listconfigs

此選項(xiàng)打印可用測試配置的列表，可用于獲取您可以通過該-config選項(xiàng)傳遞的有效測試配置名稱。

配置編譯器

-compiler <name|path>

此選項(xiàng)指定用于代碼分析和檢測的編譯器配置名稱。編譯器配置名稱需要是受支持的編譯器名稱之一。

-list-compilers

 此選項(xiàng)打印支持的編譯器列表，可用于獲取您可以通過該-compiler選項(xiàng)傳遞的有效編譯器 ID 。

-detect-compiler

此選項(xiàng)根據(jù)您指定的帶或不帶路徑的編譯器命令（可執(zhí)行文件名稱）檢測編譯器。您可以提供帶有分號(hào)分隔列表的編譯器命令列表，并使用此選項(xiàng)獲取有效的編譯器 ID 以與該-compiler選項(xiàng)一起傳遞。例子：

• -detect-compiler gcc

配置輸入范圍

 -trace <build command>

此選項(xiàng)指定啟動(dòng)構(gòu)建過程以編譯要測試的文件的構(gòu)建命令。有關(guān)構(gòu)建過程的信息和構(gòu)建期間收集的輸入范圍數(shù)據(jù)存儲(chǔ)在cpptest.bdf文件中。必須在 之前指定 C/C++test 特定的選項(xiàng)-trace，因?yàn)楹竺娴乃兄?trace都將被解釋為構(gòu)建命令。例子：

• cpptestcli -config "builtin://Recommended Rules" -compiler gcc_3_4 -trace make clean all

-input <build data file|project file>

此選項(xiàng)指定現(xiàn)有構(gòu)建數(shù)據(jù)文件 (.bdf) 或另一個(gè)項(xiàng)目定義文件的路徑以收集輸入范圍。

 構(gòu)建數(shù)據(jù)文件：您可以-trace使用選項(xiàng)或使用獨(dú)立cpptestscan或cpptesttrace實(shí)用程序創(chuàng)建構(gòu)建數(shù)據(jù)文件；

項(xiàng)目定義文件： C/C++ 支持以下文件類型：

• Microsoft Visual Studio 項(xiàng)目和解決方案（.vcproj、.vcxproj、.sln）。在指定 Microsoft Visual Studio 項(xiàng)目或解決方案時(shí)，您可以提供配置和平臺(tái)來收集 <PROJECT_FILE>@<CONFIGURATION>|<PLATFORM> 的數(shù)據(jù)。
• 由 CMake 構(gòu)建系統(tǒng)生成的 JSON 格式 (.json) 文件。

例子：

• -input cpptest.bdf
• -input MyProject.vcproj
• -input MySolution.sln
• -input "MySolution.sln@Release|Win32"
• -input compile_commands.json

-- <compile command

用于從編譯命令收集輸入范圍的開關(guān)。確保編譯命令完整并包含編譯器可執(zhí)行文件、編譯器標(biāo)志和源文件。

C/C++test 特定的選項(xiàng)必須在-- switch之前指定，因?yàn)閟witch之后的所有值--都將被解釋為編譯器命令。例子：

• cpptestcli -config "builtin://Recommended Rules" -compiler gcc_3_4 -- gcc -I include Bank.cxx

-module [<module name>=]<module root directory>

此選項(xiàng)指定模塊根目錄并將其與模塊關(guān)聯(lián)。如果未指定模塊名稱，C/C++test 將使用目錄名稱作為模塊名稱。

此選項(xiàng)允許您為 .bdf 文件中包含的 C/C++test 文件定義模塊化結(jié)構(gòu)：

• 位于指定模塊根目錄（或其子目錄）中的源文件屬于關(guān)聯(lián)模塊
• 位于指定模塊根目錄（或其子目錄）中的頭文件屬于相關(guān)模塊
• 包含在測試源文件中的頭文件僅在它與源文件屬于同一模塊時(shí)才被測試

 您可以多次指定此選項(xiàng)以定義多個(gè)模塊 - 例如，包含在一個(gè) .bdf 文件中的文件可以分為不同的模塊。

 Microsoft Visual Studio 項(xiàng)目/解決方案（.vcproj、.vcxproj、.sln）不支持此選項(xiàng)。

例子：

• -module MyProject=/home/project/src
• -module ../Module1
• -module .

-resource <path|file name>

此選項(xiàng)縮小了輸入范圍。您可以指定以下選項(xiàng)之一：

• 文件路徑 - 測試選定的文件
• 目錄的路徑 - 測試所選目錄中包含的文件
• 文件名 - 僅測試與指定名稱匹配的文件
• .lst列出要分析的資源的文件路徑（文件中的 ech 行將被視為單個(gè)條目）

例子：

• -resource /home/cpptest/examples/ATM/ATM.cxx
• -resource /home/cpptest/examples/ATM
• -resource ATM.cxx
• -resource c:/resource.lst

-include <absolute path> and -exclude <absolute path>

這些選項(xiàng)包括或排除與指定模式匹配的文件進(jìn)入/退出檢測范圍?？梢远啻沃付ㄟx項(xiàng)。最終過濾僅在所有包含/排除條目按其規(guī)范順序指定后確定。

提供文件的絕對路徑（您可以*用作通配符）。例子：

• -include /home/project/src/ATM.cxx
• -exclude /home/project/src/*.cxx
• -exclude /home/project/MyExcludes.lst

或者，您可以在.lst文件中指定模式列表，  并使用-include或-exclude開關(guān)傳遞文件。?文件中的ACH線將被視為一個(gè)單一的入口。

報(bào)告

-report <path>

此選項(xiàng)指定將創(chuàng)建報(bào)告的目錄的路徑。

-publish

此選項(xiàng)將結(jié)果發(fā)送到 DTP。

自定義配置

 -settings <path>, -localsettings <path>, and -ls <path>

此選項(xiàng)指定包含以下格式的自定義設(shè)置的自定義 .properties 文件的路徑：（key=value例如，report.format=pdf）。您可以多次使用此選項(xiàng)來指定多個(gè) .properties 文件。具有相同密鑰的條目將被覆蓋。例子：

• -settings Project1Config.properties

-property <key>=<value>

此選項(xiàng)允許您直接在命令行中配置單個(gè)設(shè)置。使用以下格式：key=value.

您可以多次使用此選項(xiàng)在同一命令行上配置多個(gè)設(shè)置。具有相同密鑰的較早條目將被覆蓋。例子：

• -property session.tag=sa_linux -property report.dtp.publish=true -property techsupport.create.on.exit=true

-showsettings

此選項(xiàng)打印當(dāng)前設(shè)置和自定義。

-psrc <path|name>

此選項(xiàng)指定 Parasoft 支持提供的高級配置文件。例子：

• -psrc advanced_options.psrc

其他選項(xiàng)

-machineId

此選項(xiàng)打印您的機(jī)器 ID。

-encodepass <your password>

此選項(xiàng)打印可在 .properties 配置文件中使用的編碼密碼。

-workspace <path>

此選項(xiàng)指定要在代碼分析和檢測期間使用的工作區(qū)目錄。工作空間位置用于存儲(chǔ) C/C++test 數(shù)據(jù)文件（如cpptest.bdf）和增量數(shù)據(jù)目錄（.cpptest）。如果未指定，C/C++test 將使用您的工作目錄進(jìn)行存儲(chǔ)。例子：

• -workspace /home/qa/workspace_for_project1

每個(gè)工作區(qū)只能運(yùn)行一個(gè) C/C++test 實(shí)例。

-showdetails

此選項(xiàng)會(huì)增加控制臺(tái)的詳細(xì)程度以顯示進(jìn)度詳細(xì)信息。

-fail

如果報(bào)告違規(guī)或設(shè)置問題，此選項(xiàng)會(huì)通過返回非零退出代碼使命令失敗。

-version

此選項(xiàng)打印有關(guān)您正在使用的 Parasoft 工具版本的信息。

-help

此選項(xiàng)打印命令行幫助。