LIB (tâche)
Remarque
Cette tâche est disponible uniquement lors de l’utilisation du système de génération C++.
Inclut dans un wrapper l’outil Gestionnaire de bibliothèques 32 bits de Microsoft, lib.exe. Le gestionnaire de bibliothèques crée et gère une bibliothèque de fichiers objets COFF (Common Object File Format). Il peut également créer des fichiers d'exportation et des bibliothèques d'importation pour référencer des définitions exportées. Pour plus d’informations, consultez Informations de référence sur LIB et Exécution de LIB.
Paramètres
Le tableau ci-dessous décrit les paramètres de la tâche LIB. La plupart des paramètres de tâche correspondent à une option de ligne de commande.
| Paramètre | Description |
|---|---|
| AdditionalDependencies | Paramètre String[] facultatif. Spécifie les éléments supplémentaires à ajouter à la ligne de commande. |
| AdditionalLibraryDirectories | Paramètre String[] facultatif. Substitue le chemin d’accès de la bibliothèque d’environnement. Spécifiez un nom de répertoire. Pour plus d’informations, consultez l’article /LIBPATH (Autre chemin de bibliothèque). |
| AdditionalOptions | Paramètre String facultatif. Liste des options lib.exe comme indiqué sur la ligne de commande. Par exemple, /<option1> /<option2> /<option#>. Utilisez ce paramètre pour spécifier des options lib.exe qui ne sont pas représentées par un autre paramètre de tâche LIB. Pour plus d’informations, consultez Exécution de LIB. |
| DisplayLibrary | Paramètre String facultatif. Affiche des informations sur la bibliothèque de sortie. Spécifiez un nom de fichier pour rediriger les informations vers un fichier. Spécifiez « CON » ou ne spécifiez rien pour rediriger les informations vers la console. Ce paramètre correspond à l’option /LIST de lib.exe. |
| ErrorReporting | Paramètre String facultatif. Spécifie comment envoyer des informations d’erreur interne à Microsoft si lib.exe échoue au moment de l’exécution. Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande. - NoErrorReport - /ERRORREPORT:NONE - PromptImmediately - /ERRORREPORT:PROMPT - QueueForNextLogin - /ERRORREPORT:QUEUE - SendErrorReport - /ERRORREPORT:SEND Pour plus d’informations, consultez l’option de ligne de commande /ERRORREPORT dans Exécution de LIB. |
| ExportNamedFunctions | Paramètre String[] facultatif. Spécifie une ou plusieurs fonctions à exporter. Ce paramètre correspond à l’option /EXPORT: de lib.exe. |
| ForceSymbolReferences | Paramètre String facultatif. Force lib.exe à inclure une référence au symbole spécifié. Ce paramètre correspond à l’option /INCLUDE: de lib.exe. |
| IgnoreAllDefaultLibraries | Paramètre Boolean facultatif.Si la valeur est true, supprime toutes les bibliothèques par défaut de la liste des bibliothèques dans lesquelles lib.exe recherche quand il résout des références externes.Ce paramètre correspond à la forme sans paramètre de l’option /NODEFAULTLIB de lib.exe. |
| IgnoreSpecificDefaultLibraries | Paramètre String[] facultatif. Supprime les bibliothèques spécifiées de la liste des bibliothèques dans lesquelles lib.exe recherche quand il résout des références externes. Ce paramètre correspond à l’option /NODEFAULTLIB de lib.exe qui prend un argument library. |
| LinkLibraryDependencies | Paramètre Boolean facultatif.Si la valeur est true, spécifie que les sorties de bibliothèque émanant des dépendances du projet sont automatiquement liées. |
| LinkTimeCodeGeneration | Paramètre Boolean facultatif.Si la valeur est true, spécifie la génération du code durant l'édition de liens.Ce paramètre correspond à l’option /LCTG de lib.exe. |
| MinimumRequiredVersion | Paramètre String facultatif. Spécifie la version minimale requise du sous-système. Spécifiez la liste, délimitée par des virgules, de nombres décimaux compris entre 0 et 65535. |
| ModuleDefinitionFile | Paramètre String facultatif. Spécifie le nom du fichier de définition de module (.def). Ce paramètre correspond à l’option /DEF de lib.exe qui prend un argument filename. |
| Nom | Paramètre String facultatif. Lors de la génération d'une bibliothèque d'importation, spécifie le nom de la DLL pour laquelle la bibliothèque d'importation est générée. Ce paramètre correspond à l’option /NAME de lib.exe qui prend un argument filename. |
| OutputFile | Paramètre String facultatif. Remplace le nom et l’emplacement par défaut du programme que lib.exe crée. Ce paramètre correspond à l’option /OUT de lib.exe qui prend un argument filename. |
| RemoveObjects | Paramètre String[] facultatif. Omet l'objet spécifié de la bibliothèque de sortie. Lib.exe crée une bibliothèque de sortie en combinant tous les objets (qu’ils se trouvent dans des fichiers objets ou des bibliothèques), puis en supprimant tous les objets spécifiés par cette option. Ce paramètre correspond à l’option /REMOVE delib.exe qui prend un argument membername. |
| Sources | Paramètre ITaskItem[] requis.Spécifie la liste des fichiers sources séparés par des espaces. |
| SubSystem | Paramètre String facultatif. Spécifie l'environnement pour l'exécutable. Le choix du sous-système affecte le symbole de point d'entrée ou la fonction de point d'entrée. Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande. - Console - /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 Pour plus d’informations, consultez l’article /SUBSYSTEM (Spécifier le sous-système). |
| SuppressStartupBanner | Paramètre Boolean facultatif. Si la valeur est true, empêche l'affichage du message de copyright et de numéro de version quand la tâche démarre.Pour plus d’informations, consultez l’option /NOLOGO dans Exécution de LIB. |
| TargetMachine | Paramètre String facultatif. Spécifie la plateforme cible du programme ou de la DLL. Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande. - 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 Pour plus d’informations, consultez /MACHINE (Spécifier la plateforme cible). |
| TrackerLogDirectory | Paramètre String facultatif. Spécifie le répertoire du journal de Tracker. |
| TreatLibWarningAsErrors | Paramètre Boolean facultatif. Si la valeur est true, empêche la tâche LIB de générer un fichier de sortie si lib.exe génère un avertissement. Si la valeur est false, un fichier de sortie est généré.Pour plus d’informations, consultez l’option /WX dans Exécution de LIB. |
| UseUnicodeResponseFiles | Paramètre Boolean facultatif. Si la valeur est true, indique au système de projet de générer des fichiers réponse UNICODE quand le générateur de bibliothèques est créé dynamiquement. Spécifiez true quand les fichiers du projet ont des chemins d'accès UNICODE. |
| Verbose | Paramètre Boolean facultatif. Si la valeur est true, affiche des détails sur la progression de la session ; ceux-ci incluent les noms des fichiers .obj en cours d’ajout. Les informations sont envoyées vers la sortie standard et peuvent être redirigées vers un fichier.Pour plus d’informations, consultez l’option /VERBOSE dans Exécution de LIB. |