共用方式為

如何：組織組建的專案輸出檔案

  • 發行項

本主題描述組織專案輸出檔的最佳做法。 當您不正確地設定專案輸出檔時，可能會發生建置錯誤。 本主題也會概述組織專案輸出檔之每個替代方案的優缺點。

參考 CLR 組件

使用 #using 參考組件

  1. 您可以使用 #using 指示詞，直接從您的程式碼參考組件，例如 #using <System.Data.dll>。 如需詳細資訊，請參閱 #using 指示詞。

    指定的檔案可以是 .dll、.exe、.netmodule 或.obj，只要是以 MSIL 撰寫即可。 您可以使用任何語言建置參考的元件。 使用此選項，您將可以存取 IntelliSense，因為系統會從 MSIL 擷取中繼資料。 指定的檔案必須位於專案的路徑中；否則，專案不會編譯，且無法使用 IntelliSense。 判斷檔案是否在路徑中的一個簡單方法是以滑鼠右鍵按一下 #using 行，然後選擇 [開啟文件] 命令。 如果找不到檔案，系統會通知您。

    如果您不想要放入檔案的完整路徑，您可以使用 /AI 編譯器選項，編輯 #using 參考的搜尋路徑。 如需詳細資訊，請參閱 /AI (指定中繼資料目錄)。

使用 /FU 參考組件

  1. 您不必直接從程式碼檔參考組件 (如上所述)，您可以使用 /FU 編譯器選項。 這個方法的優點是，您不需要將個別 #using 陳述式新增至每個參考指定組件的檔案。

    若要設定此選項，請開啟專案的 [屬性頁]。 展開 [組態屬性] 節點，然後展開 [C/C++] 節點並選取 [進階]。 將所需的組件新增至 Force #using 旁。 如需詳細資訊，請參閱 /FU (指定強制的 #using 檔)。

使用 [新增參考] 參考組件

  1. 這是使用 CLR 組件的最簡單方法。 首先，確定使用 /clr 編譯器選項編譯專案。 然後，以滑鼠右鍵按一下 [方案總管] 中的專案，然後選取 [新增]、[參考]。 [屬性頁] 對話方塊隨即出現。

  2. 從 [屬性頁] 對話方塊，選取 [新增參考]。 這會顯示一個對話方塊，其中列出所有 .NET、COM 及目前專案中可用的其他組件。 選取所需的組件，然後按一下 [確定]。

    設定專案參考之後，即會自動處理對應的相依性。 此外，由於中繼資料是組件的一部分，因此不需要新增標頭檔或為要從受控組件使用的項目設計原型。

參考原生 DLL 或靜態程式庫

參考原生 DLL 或靜態程式庫

  1. 使用 #include 指示詞參考您程式碼中的適當標頭檔。 標頭檔必須在 Include 路徑中，或是目前專案的一部分。 如需詳細資訊，請參閱 #include 指示詞 (C/C++)。

  2. 您也可以設定專案相依性。 設定專案相依性可確保兩件事。 首先，它會確保專案依正確順序建置，因此專案一可以找到所需的相依檔案。 其次，它會隱含地將相依專案的輸出目錄新增至路徑，以便在連結時間輕鬆找到檔案。

  3. 若要部署應用程式，您必須將 DLL 放在適當的位置。 這個權限可以是下列其中一項：

    1. 與可執行檔相同的路徑。

    2. 系統路徑 (path 環境變數) 中的任何位置。

    3. 在並存組件中。 如需詳細資訊，請參閱建置 C/C++ 並存組件。

使用多個專案

根據預設，建置專案時，會在專案目錄的子目錄中建立所有輸出檔。 目錄會根據組建組態命名 (例如偵錯或發行)。 為了讓同層級專案彼此參考，每個專案必須明確地將其他專案輸出目錄新增至其路徑，連結才能成功。 這會在您設定專案相依性時自動完成。 不過，如果您未使用相依性，則必須謹慎處理，因為組建可能會變得難以管理。 例如，當專案具有偵錯和發行組態，並包含同層級專案中的外部程式庫時，則應該根據要建置的組態，使用不同的程式庫檔。 因此，硬式編碼這些路徑可能很困難。

所有基本輸出檔 (例如可執行檔、累加連結器檔案和 PDB 檔案) 都會複製到通用方案目錄中。 因此，使用含有數個組態相同之 C++ 專案的方案時，會將所有輸出檔集中在一起，以簡化連結和部署。 若將這些檔案保存在一起，您就可以確定其應用程式/程式庫會如預期般運作 (因為檔案一定會在路徑中)。

部署至生產環境時，輸出檔的位置可能是主要問題。 在 IDE 中執行專案時，內含程式庫的路徑不一定會與生產環境相同。 例如，如果您的程式碼中有 #using "../../lib/debug/mylib.dll"，但接著將 mylib.dll 部署到不同的相對位置，則應用程式會在執行階段失敗。 為了避免這個問題，您應該避免在程式碼的 #include 陳述式中使用相對路徑。 您最好確保必要檔案在專案建置路徑中，並同樣地確保對應的生產檔案位置正確。

如何指定輸出檔位置

  1. 您可以在專案的 [屬性頁] 中找到專案輸出設定的位置。 展開 [組態屬性] 旁的節點，然後選取 [一般]。 在 [輸出目錄] 旁指定輸出位置。 如需詳細資訊，請參閱一般屬性頁 (專案)。

另請參閱

Visual Studio 中的 C++ 專案類型