BSCMAKE 选项

警告

虽然安装 Visual Studio 时仍会安装 BSCMAKE,但 IDE 将不再使用它。 从 Visual Studio 2008 起,浏览信息和符号信息自动存储在解决方案文件夹的 SQL Server .sdf 文件中。

本节介绍可用于控制 BSCMAKE 的选项。 多个选项通过排除或包含特定信息来控制浏览信息文件的内容。 排除选项可以允许 BSCMAKE 更快地运行,并可能会产生较小的 .bsc 文件。 选项名称区分大小写(/HELP/NOLOGO 除外)。

/NOLOGO/o 仅在 Visual Studio 开发环境中可用。 有关详细信息,请参阅在 Visual Studio 中设置 C++ 编译器和生成属性

选项

/Ei (filename ... )
从浏览信息文件中排除一个或多个指定 filename 包含文件的内容。 若要指定多个文件,请使用空格分隔名称,并将列表括在括号中。 如果只指定一个 filename,则不需要括号。 将 /Ei/Es 选项一起使用可排除 /Es 未排除的文件。

/El
排除本地符号。 默认值是包含本地符号。 有关本地符号的详细信息,请参阅创建 .sbr 文件

/Em
在宏主体中排除符号。 使用 /Em 可仅将宏的名称包含在浏览信息文件中。 默认值是同时包含宏名称和宏扩展的结果。

/Er (symbol ... )
从浏览信息文件中排除一个或多个指定 symbol 符号。 若要指定多个符号名称,请使用空格分隔名称,并将列表括在括号中。 如果只指定一个 symbol,则不需要括号。

/Es
排除使用绝对路径指定或是在 INCLUDE 环境变量中指定的绝对路径中的每个包含文件。 (通常,这些文件是系统包含文件,其中包含在浏览信息文件中可能不需要的许多信息。)此选项不排除在未使用路径的情况下指定、使用相对路径指定或是在 INCLUDE 中的相对路径中的文件。 可以将 /Ei 选项与 /Es 选项一起使用以排除 /Es 未排除的文件。 如果要仅排除某些文件,请使用 /Ei 而不是 /Es,并列出要排除的文件。

/errorreport:[ none | prompt | queue | send ]
此选项已弃用。 在 Windows Vista 及更高版本中,错误报告由 Windows 错误报告 (WER) 设置控制。

/HELP
显示 BSCMAKE 命令行语法的摘要。

/Iu
包含未引用的符号。 默认情况下,BSCMAKE 不会记录已定义但未引用的任何符号。 如果 .sbr 文件已打包,则此选项对输入文件没有影响,因为编译器已移除了未引用的符号。

/n
强制进行非增量生成。 使用 /n 可强制完全生成浏览信息文件(无论 .bsc 文件是否存在)并防止 .sbr 文件被截断。 有关详细信息,请参阅 BSCMAKE 如何生成 .bsc 文件

/NOLOGO
禁止显示 BSCMAKE 版权消息。

/o filename
filename 选项参数指定浏览信息文件的名称。 默认情况下,BSCMAKE 为浏览信息文件提供第一个 .sbr 文件的基名称和 .bsc 扩展名。

/S (filename ... )
告知 BSCMAKE 在首次遇到每个指定 filename 包含文件时进行处理,否则将其排除。 当文件(例如 .c.cpp 源文件的头文件 (.h))包含在多个源文件中,但每次都由预处理指令保持不变时,使用此选项可节省处理时间。 如果文件的更改方式对所创建的浏览信息文件不重要,请使用此选项。 若要指定多个文件,请使用空格分隔名称,并将列表括在括号中。 如果只指定一个 filename,则不需要括号。 如果要在文件每次被包含时进行排除,请使用 /Ei/Es 选项。

/v
提供详细输出,其中包括所处理的每个 .sbr 文件的名称以及有关完整 BSCMAKE 运行的信息。

/?
显示 BSCMAKE 命令行语法的简短摘要。

示例

以下命令行告知 BSCMAKE 通过三个 .sbr 文件完整生成 main.bsc。 它还告知 BSCMAKE 排除重复的 toolbox.h 实例:

BSCMAKE /n /S toolbox.h /o main.bsc file1.sbr file2.sbr file3.sbr

另请参阅

BSCMAKE 参考