LIB 任务
注意
仅当使用 C++ 生成系统时,此任务才可用。
包装 Microsoft 32 位库管理器工具 (lib.exe) 。 库管理器创建并管理通用对象文件格式 (COFF) 对象文件的库。 库管理器还可以创建导出文件和导入库,以便引用导出的定义。 有关详细信息,请参阅 LIB 参考和运行 LIB。
参数
下表介绍了 LIB 任务的参数。 大多数任务参数都对应于命令行选项。
参数 | 说明 |
---|---|
AdditionalDependencies | 可选 String [] 参数。 指定要添加到命令行的附加项。 |
AdditionalLibraryDirectories | 可选 String [] 参数。 重写环境库路径。 指定目录名。 有关详细信息,请参阅 /LIBPATH(附加的 Libpath)。 |
AdditionalOptions | 可选 String 参数。 在命令行上指定的 lib.exe 选项列表 。 例如 /<option1> /<option2> /<option#>。 此参数用于指定无法由其他任何 LIB 任务参数表示的 lib.exe 选项 。 有关详细信息,请参阅运行 LIB。 |
DisplayLibrary | 可选 String 参数。 显示有关输出库的信息。 指定一个文件名,以便将信息重定向到该文件。 指定“CON”或不指定任何内容,以便将信息重定向到该控制台。 此参数对应于 lib.exe 的 /LIST 选项 。 |
ErrorReporting | 可选 String 参数。 指定如果 lib.exe 在运行时失败,如何向 Microsoft 发送内部错误信息 。 指定以下值之一,其中每个值对应于一个命令行选项。 - NoErrorReport - /ERRORREPORT:NONE - PromptImmediately - /ERRORREPORT:PROMPT - QueueForNextLogin - /ERRORREPORT:QUEUE - SendErrorReport - /ERRORREPORT:SEND 有关详细信息,请参阅运行 LIB 中的 /ERRORREPORT 命令行选项。 |
ExportNamedFunctions | 可选 String [] 参数。 指定要导出的一个或多个函数。 此参数对应于 lib.exe 的 /EXPORT: 选项 。 |
ForceSymbolReferences | 可选 String 参数。 强制 lib.exe 包括对指定符号的引用 。 此参数对应于 lib.exe 的 /INCLUDE: 选项 。 |
IgnoreAllDefaultLibraries | 可选 Boolean 参数。如果为 true ,则在解析外部引用时从 lib.exe 搜索的库列表中删除所有默认库 。此参数对应于 lib.exe 的无参数形式 /NODEFAULTLIB 选项 。 |
IgnoreSpecificDefaultLibraries | 可选 String [] 参数。 解析外部引用时,从 lib.exe 搜索的库列表中删除指定的库 。 此形参对应于使用 library 实参的 lib.exe 的 /NODEFAULTLIB 选项。 |
LinkLibraryDependencies | 可选 Boolean 参数。如果为 true ,指定自动链接项目依赖项中的库输出。 |
LinkTimeCodeGeneration | 可选 Boolean 参数。如果为 true ,指定链接时代码生成。此参数对应于 lib.exe 的 /LCTG 选项 。 |
MinimumRequiredVersion | 可选 String 参数。 指定子系统所需的最低版本。 指定范围在 0 到 65535 之间且以逗号分隔的十进制数字列表。 |
ModuleDefinitionFile | 可选 String 参数。 指定模块定义文件 (.def) 的名称 。 此形参对应于使用 filename 实参的 lib.exe 的 /DEF 选项。 |
Name | 可选 String 参数。 生成导入库时,指定正在为其生成导入库的 DLL 的名称。 此形参对应于使用 filename 实参的 lib.exe 的 /NAME 选项。 |
OutputFile | 可选 String 参数。 重写 lib.exe 所创建程序的默认名称和位置 。 此形参对应于使用 filename 实参的 lib.exe 的 /OUT 选项。 |
RemoveObjects | 可选 String [] 参数。 忽略输出库中的指定对象。 Lib.exe 通过组合所有对象(无论位于对象文件中还是库中),然后删除此选项指定的任何对象,来创建输出库。 此形参对应于使用 membername 实参的 lib.exe 的 /REMOVE 选项。 |
Sources | 必选 ITaskItem[] 参数。指定用空格分隔的源文件列表。 |
SubSystem | 可选 String 参数。 为可执行文件指定环境。 子系统的选择会影响的入口点符号或入口点函数。 指定以下值之一,其中每个值对应于一个命令行选项。 - 控制台 - /SUBSYSTEM:CONSOLE - Windows - /SUBSYSTEM:WINDOWS - Native - /SUBSYSTEM:NATIVE - EFI Application - /SUBSYSTEM:EFI_APPLICATION - EFI Boot Service Driver - /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER - EFI ROM - /SUBSYSTEM:EFI_ROM - EFI Runtime - /SUBSYSTEM:EFI_RUNTIME_DRIVER - WindowsCE - /SUBSYSTEM:WINDOWSCE - POSIX - /SUBSYSTEM:POSIX 有关详细信息,请参阅 /SUBSYSTEM(指定子系统)。 |
SuppressStartupBanner | 可选 Boolean 参数。 如果为 true ,则在任务开始时阻止显示版权和版本号消息。有关详细信息,请参阅运行 LIB 中的 /NOLOGO 选项。 |
TargetMachine | 可选 String 参数。 指定程序或 DLL 的目标平台。 指定以下值之一,其中每个值对应于一个命令行选项。 - MachineARM - /MACHINE:ARM - MachineEBC - /MACHINE:EBC - MachineIA64 - /MACHINE:IA64 - MachineMIPS - /MACHINE:MIPS - MachineMIPS16 - /MACHINE:MIPS16 - MachineMIPSFPU -/MACHINE:MIPSFPU - MachineMIPSFPU16 - /MACHINE:MIPSFPU16 - MachineSH4 - /MACHINE:SH4 - MachineTHUMB - /MACHINE:THUMB - MachineX64 - /MACHINE:X64 - MachineX86 - /MACHINE:X86 有关详细信息,请参阅 /MACHINE(指定目标平台)。 |
TrackerLogDirectory | 可选 String 参数。 指定跟踪器日志的目录。 |
TreatLibWarningAsErrors | 可选 Boolean 参数。 若为 true ,LIB 任务不会在 lib.exe 生成警告时生成输出文件 。 如果为 false ,则生成输出文件。有关详细信息,请参阅运行 LIB 中的 /WX 选项。 |
UseUnicodeResponseFiles | 可选 Boolean 参数。 如果为 true ,则指示在生成库管理器时,项目系统生成 UNICODE 响应文件。 当项目中的文件具有 UNICODE 路径时,指定 true 。 |
Verbose | 可选 Boolean 参数。 如果为 true ,则显示有关会话进度的详细信息;这包括正在添加的 .obj 文件的名称 。 信息被发送到标准输出,并可重定向到文件。有关详细信息,请参阅运行 LIB 中的 /VERBOSE 选项。 |