Sdílet prostřednictvím


Jak: uspořádání výstupní soubory projektu pro sestavení

Toto téma popisuje doporučené postupy pro uspořádání výstupních souborů projektu.Při nesprávném uspořádání výstupních souboru může dojít k chybě sestavení.Toto téma také popisuje výhody a nevýhody všech možností uspořádání výstupních souborů projektu.

Odkazování na sestavení CLR

Odkazování na sestavení pomocí #using

  • Na sestavení lze odkazovat přímo z kódu pomocí direktivy #using, například #using <System.Data.dll>. Další informace naleznete v tématu # použití směrnice (C++).

    Odkazovaným souborem může být .DLL, .EXE, .netmodule, nebo .OBJ pokud je v jazyku MSIL.Odkazovaná komponenta může být sestavena v libovolném jazyce.Využitím této možnosti budete mít přístup k IntelliSense, jelikož metadata budou extrahovány z jazyka MSIL.Dotyčný soubor musí být v umístění pro projekt, jinak projekt nepůjde kompilovat a IntelliSense nebude k dispozici.Snadný způsob zjištění, zda soubor je v umístění pro projekt, je kliknutí pravým tlačítkem myši na #using a kliknutí na příkaz Open document.Pokud se soubor nepodaří najít, budete upozorněni.

    Pokud nechcete vkládat úplnou cestu k souboru, můžete použít možnost kompilátoru /AI pro úpravu vyhledávací cesty odkazů #using. Další informace naleznete v tématu /AI (zadat metadat adresáře).

Odkazování na sestavení pomocí /FU

  • Namísto odkazování na sestavení přímo ze souboru kódu, jak je popsáno výše, můžete použít možnost kompilátoru /FU. Výhodou této metody je, že nepotřebujete přidat samostatný příkaz #using pro každý soubor, který odkazuje na dané sestavení.

    Pro nastavení této možnosti otevřete Stránky vlastností pro projekt.Rozbalte uzel Vlastnosti konfigurace a dále rozbalte uzel C/C++ a zvolte Upřesnit.Přidejte požadované sestavení k Force #using.Další informace naleznete v tématu /FU (název vynucené # pomocí souboru).

Odkazování na sestavení pomocí Přidat nový odkaz

  1. Toto je nejjednodušší způsob použití sestavení CLR.Nejprve se přesvědčte, zda je projekt kompilován s možnosti kompilátoru /clr. Pravým tlačítkem myši klikněte na projekt v Průzkumníku řešení a zvolte Odkazy.Zobrazí se dialogové okno Stránky vlastností.

  2. V dialogu Stránky vlastností zvolte Přidat nový odkaz.Zobrazí se dialog se seznamem všech sestavení .NET, COM, a jiných sestavení dostupných v aktuálním projektu.Vyberte požadované sestavení a klikněte na tlačítko OK.

    Po nastavení projektového odkazu jsou automaticky zpracovány odpovídající závislosti.Vzhledem k tomu, že metadata jsou součástí sestavení, není nutné přidat soubory hlaviček nebo spravovat prvky, které jsou používány ze sestavení.

Odkazování nativních knihoven DLL nebo statických knihoven

Odkazování nativních knihoven DLL nebo statických knihoven

  1. Odkažte na příslušný soubor hlaviček v kódu pomocí direktivy #include.Soubor hlaviček musí být v zahrnutém umístění, nebo část aktuálního projektu.Další informace naleznete v tématu # include směrnice (C/C++).

  2. Můžete také nastavit závislosti projektu.Nastavení závislostí projektu zaručuje dvě věci.Za prvé zajišťuje správné pořadí sestavení projektů, takže projekt může vždy najít závislé soubory, které potřebuje.Za druhé implicitně přidá výstupní adresář závislého projektu k cestě, takže soubory lze snadno nalézt v době propojení.

  3. Pro nasazení aplikace je třeba umístit knihovnu DLL do správného umístění.To může být následující:

    1. Stejné jako umístění spustitelného souboru.

    2. Kdekoli v systémových cestách (proměnná prostředí path).

    3. V souběžně sdíleném sestavení.Další informace naleznete v tématu Budovy C/C++-souběžně sdílená sestavení.

Práce s více projekty

Ve výchozím nastavení jsou projekty sestaveny tak, že všechny výstupní soubory jsou vytvořeny v podadresáři adresáře projektu.Pojmenování tohoto adresáře závisí na konfiguraci sestavení (napříkladLadit nebo Vydaná verze).Pokud projekty na stejné úrovni odkazují navzájem na sebe, pro úspěšné propojení musí každý projekt explicitně přidat výstupní adresáře ostatních projektů do svých cest.Toto se provádí automaticky při nastavení závislostí projektu.Pokud nevyužíváte závislostí, je toto nutné pečlivě zpracovat, protože sestavení se může stát velmi obtížně na správu.Pokud má například projekt konfiguraci Ladit a Vydaná verze, a zahrnuje externí knihovnu z projektu na stejné úrovni, měl by použít různé soubory knihovny v závislosti na tom, jaká konfigurace je sestavovaná.Proto mohou být pevně zakódované cesty záludné.

Všechny základní výstupní soubory (například spustitelné soubory, soubory přírůstkového linker a PDB) jsou zkopírovány do adresáře společné řešení.Proto při práci s řešením, které obsahuje několik projektů C++ se stejnou konfigurací, jsou všechny výstupní soubory centralizované pro zjednodušené propojení a nasazení.Můžete si být jisti, že jejich aplikace/knihovna bude fungovat podle očekávání, pokud tyto soubory zůstanou pohromadě (vzhledem k tomu, že soubory jsou zaručeně v cestě).

Umístění výstupních souborů může být závažný problém při nasazování do provozního prostředí.Při běhu projektů v integrovaném vývojovém prostředí nemusí být cesty k načítaným knihovnám nutně stejné, jako v provozním prostředí.Pokud například máte v kódu #using "../../lib/debug/mylib.dll", ale poté nasadíte mylib.DLL do jiného relativního umístění, aplikace selže v době běhu. Chcete-li tomu zabránit, neměli byste v kódu používat relativní cesty pro příkaz #include.Je lépe zajistit, aby nezbytné soubory byly v cestě sestavení projektu, a podobně zajistit, aby odpovídající provozní soubory byly správně umístěny.

Určení umístění výstupních souborů

  • Nastavení umístění výstupu projektu lze nalézt v projektových Stránkách vlastností.Rozbalte uzel Vlastnosti konfigurace a zvolte Obecné.Umístění výstupu je určeno pomocí Výstupní adresář.Další informace naleznete v tématu Na stránce vlastností General (projekt).

Viz také

Koncepty

Typy projektů Visual C++