Určení vlastních sestavovacích nástrojů
Nástroj pro vlastní sestavení poskytuje systém sestavení s informacemi potřebnými k vytvoření určitých vstupních souborů.Nástroj pro vlastní sestavení určuje příkaz, který bude spuštěn, seznam vstupních souborů, seznam výstupních souborů vytvořených pomocí příkazu a volitelný popis nástroje.
Obecné informace o nástroji pro vytváření vlastních sestavení a vlastních kroků sestavení naleznete v tématu Seznámení s kroky vlastního sestavení a s událostmi sestavení.
Určit nástroj pro vlastní sestavení
Otevřete dialogové okno projektu Stránky vlastností.Další informace naleznete v tématu Nastavení vlastností projektu jazyka Visual C++.
Klikněte na tlačítko Vlastnosti konfigurace k povolení pole Konfigurace.V poli Konfigurace vyberte konfiguraci, pro kterou chcete určit nástroj pro vlastní sestavení.
V Průzkumníku řešení vyberte vstupní soubor pro nástroj pro vlastní sestavení.
Pokud se složka Nástroj pro vlastní sestavení nezobrazí, přípona souboru, který jste vybrali, je přidružena k výchozímu nástroji.Například, výchozí nástroj pro soubory .c a .cpp je kompilátor.Chcete-li přepsat výchozí nastavení nástroje, v uzlu Vlastnosti konfigurace ve složce Obecné ve vlastnosti Typ položky klikněte na tlačítko Nástroj pro vlastní sestavení.Klikněte na tlačítko Použít a uzel Nástroj pro vlastní sestavení se zobrazí.
V uzlu Nástroj pro vlastní sestavení ve složce Obecné určete vlastnosti spojené s nástrojem pro vlastní sestavení:
V Další závislosti určete libovolné další soubory než ten, pro něhož je definován nástroj pro vlastní sestavení (soubor přidružen k nástroji pro vlastní sestavení se implicitně považuje za vstup do nástroje).Mít další vstupní soubory není požadavek pro nástroj pro vlastní sestavení.Pokud máte více než jeden další vstup, oddělujte je středníkem.
Pokud je datum souboru některé Další závislosti pozdější, než vstupního souboru, potom je spuštěn nástroj pro vlastní sestavení.Pokud všechny soubory Další závislosti jsou starší než vstupní souboru a vstupní soubor je starší než vlastnost souboru Výstupy, pak nástroj pro vlastní sestavení není spuštěn.
Předpokládejme například, že máte nástroj pro vlastní sestavení, který vezme MyInput.x jako vstup a vygeneruje MyInput.cpp, a pak MyInput.x zahrne soubor hlaviček MyHeader.h.MyHeader.h můžete zadat jako vstupní závislost na MyInput.x a systém sestavení bude sestavovat MyInput.cpp, když je zastaralé s ohledem na MyInput.x nebo MyHeader.h.
Vstupní závislosti mohou rovněž zajistit, že vaše nástroje pro vlastní sestavení jsou spouštěny v pořadí, v jakém je třeba.V předchozím příkladu předpokládejme, že MyHeader.h je skutečně výstup nástroje pro vlastní sestaveníVzhledem k tomu, že MyHeader.h je závislost na MyInput.x, systém sestavení nejprve vytvoří Myheader.h před spuštěním nástroje pro vlastní sestavení na MyInput.x.
V Příkazové řádce zadejte příkaz, jako kdyby jste jej zadávali příkazovém řádku.Zadejte platný příkaz nebo dávkový soubor a libovolný požadovaný vstupní nebo výstupní soubor.Určete příkaz dávky call před názvem dávkového soubor k zaručení, že všechny následné příkazy budou provedeny.
Více vstupních a výstupních souborů může být zadáno symbolicky s makry MSBuild.Další informace o specifikuje umístění souborů nebo názvy sad souborů, viz Makra pro příkazy a vlastnosti sestavení.
Protože znak "%" je rezervován nástrojem MSBuild, pokud určíte proměnné prostředí nahradit každý % řídicí znak s %25 řídicí sekvencí v šestnáctkové soustavě.Například nahraďte %WINDIR% s %25WINDIR%25.Nástroj MSBuild nahradí každou číselnou sekvenci %25 znakem % dříve, než přistoupí k proměnné prostředí.
V Popisu zadejte popisnou zprávu o tomto nástroji pro vlastní sestavení.Zpráva je vytisknuta do okna Výstup, kde systém sestavení zpracovává tento nástroj.
Ve Výstupy zadejte název výstupního souboru.Toto je požadovaná položka; bez hodnoty této vlastnosti se nástroj pro vlastní sestavení nespustí.Pokud má nástroj pro vlastní sestavení více než jeden výstup, oddělte názvy souborů středníkem.
Název výstupního souboru by měl být stejný, jak je zadán ve vlastnosti Příkazový řádek.Systém sestavení projektu vyhledá soubor a zkontroluje jeho datum.Pokud je výstupní soubor novější než vstupní soubor nebo výstupní soubor nebyl nalezen, je nástroj pro vlastní sestavení spuštěn.Pokud všechny soubory Další závislosti jsou starší než vstupní souboru a vstupní soubor je starší než soubor zadán ve vlastnosti Výstupy, pak nástroj pro vlastní sestavení není spuštěn.
Pokud chcete, aby systém sestavení pracoval na výstupním souboru generovaném nástrojem pro vlastní sestavení, je třeba jej ručně přidat do projektu.Nástroj pro vlastní sestavení bude aktualizovat soubor během sestavení.
Příklad
Předpokládejme, že chcete zahrnout do projektu soubor s názvem parser.l.Chcete lexikální analyzátor zpracovávat parser.l k vytvoření .c souboru, který má stejný základní název (parser.c).
Nejprve přidejte parser.l a parser.c do projektu.Pokud soubory dosud neexistují, jen přidejte odkaz na soubory.Vytvořili jste nástroj pro vlastní sestavení pro parser.l a zadejte následující do vlastnosti Příkazy:
lexer %(FullPath) .\%(Filename).c
Tento příkaz bude spouštět lexikální analyzátor parser.l a výstup parser.c do adresáře projektu.
Ve vlastnosti Výstupy zadejte následující:
.\%(Filename).c
Při sestavení projektu systém sestavení porovná časová razítka souborů parser.l a parser.c.Pokud je novější parser.l nebo parser.c neexistuje, spustí systém sestavení hodnotu vlastnosti Příkazové řádky tak, aby parser.c byl aktuální.Vzhledem k tomu, že parser.c byl také přidán do projektu, systém sestavení pak zkompiluje parser.c.
Viz také
Referenční dokumentace
Řešení potíží s přizpůsobením sestavení