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 选项。

另请参阅