共用方式為

概念：埠

  • 發行項

vcpkg 中的埠是產生一組檔案的版本化配方。 執行埠會藉由產生新的標頭或二進位檔，來影響安裝圖形。 埠可能與其他埠有相依性，而且在啟用特定功能時可能需要額外的相依性。 這些相依性必須反映在埠元數據中。 連接埠至少包含：

  • 套件的相關元數據：名稱、版本、支援的功能、相依性等。
  • 取得、視需要建置及安裝套件的指示。

此外，埠可能包括：

  • 要套用至套件原始程式碼的修補程式
  • 與專案建置系統整合的指示

Portfile （portfile.cmake）

所有埠都必須包含 portfile （名為 portfile.cmake的檔案）。 portfile 是腳本，其中包含如何在 vcpkg 環境中建置及安裝套件的指示。 portfiles 所執行的一些常見工作如下：

  • 下載套件的原始程式碼。
  • 使用上游組建系統建置套件。
  • 將組建輸出複製到 vcpkg 安裝樹狀結構。
  • 安裝組建系統整合檔案。

vcpkg.json

檔案 vcpkg.json 描述 vcpkg 埠中所含套件的相關元數據。 此檔案會定義屬性，例如套件的名稱、版本、描述、相依性、支援的功能和平臺等。若要深入瞭解， vcpkg.json 請參閱檔案參考。

CONTROL 檔案

警告

CONTROL 檔案已被取代，且只會保留回溯相容性。

CONTROL vcpkg 中的檔案可作為元數據檔案，指定 vcpkg 可以安裝之套件的詳細數據或「埠」。 這些檔案已被取代，而且基本上已由 vcpkg.json 新埠的指令清單檔取代。 不過，它們會保留為回溯相容性。 如需詳細資訊，請參閱 control-files 。

修補程式檔案

在某些情況下，埠可能包含修補程序檔案。 這些檔案會修改連結庫的原始程式碼，這對於修正現有問題或維護與其他元件的相容性至關重要。 建置程序開始之前，修補程式會套用為 portfile 所執行之步驟的一部分，以方便順暢且無錯誤的連結庫整合。 如需深入瞭解， 請參閱維護者指南 。

埠類別

埠類別是維護者用來表達 vcpkg 內不同埠所扮演角色的口述詞彙。 雖然這些類別有助於描述一般功能，但值得注意的是，任何指定的埠都可以根據其功能和使用案例，屬於多個類別或完全不屬於任何類別。

標準埠

標準埠可作為從來源建置連結庫的配方，或提供僅限標頭連結庫的頭檔。 其中包含取得、建置及安裝連結庫所需的指示和元數據。 策展登錄中絕大多數的連結庫都是標準埠。

中繼埠

中繼埠可用來在安裝圖形上施加條件約束，而不需要有自己的組建檔案。 這些埠通常用來將一組相關連結庫分組為單一名稱，或做為可取代元件的間接層。 例如，是一個中繼埠， boost 會將各種 Boost 連結庫分組在單一名稱下，以便更輕鬆地進行相依性管理。

腳本埠

腳本埠包含公用程式腳本，主要適用於 vcpkg 內的內部工作，或供其他埠取用。 這些埠會啟用公用程式腳本的版本控制，藉此維護相容性和標準化。 例如， vcpkg-cmake 是公開協助程式函式的 vcpkg_cmake_configure() 腳本埠。

下一步

本檔提供 vcpkg 中的埠概觀，詳細說明其基本元素和各種類別。 如需更進階的主題和詳細指南，請參閱下列內容：