共用方式為

vcpkg_from_git

  • 發行項

從 git 下載並擷取專案。

此協助程式會 git 重複使用 CLI 認證。 請參閱 驗證 以設定私人 Git 主機的認證。

如果 Git 存放庫裝載於 BitBucket、GitHub 或 GitLab 上，則應該使用其特定函式，而不是此函式：

使用方式

vcpkg_from_git(
    OUT_SOURCE_PATH <SOURCE_PATH>
    URL <https://android.googlesource.com/platform/external/fdlibm>
    REF <59f7335e4d...>
    [HEAD_REF <ref>]
    [PATCHES <patch1.patch> <patch2.patch>...]
    [LFS [<url>]]
)

參數

OUT_SOURCE_PATH

指定將包含擷取位置的 out 變數。

這應該依照慣例設定為 SOURCE_PATH 。

URL

Git 存放庫的 URL。

REF

要下載的認可 git sha。

FETCH_REF

要以非 HEAD 模式擷取的 git 分支。 擷取此項目之後， REF 就會取出。當 Git 伺服器不允許簽出未公告的物件時，這非常有用。

HEAD_REF

要求從最新來源建置套件時使用的 git 分支。

範例：main、、 developHEAD

補丁

要套用至擷取來源的修補程序清單。

相對路徑是以埠目錄為基礎。

Lfs

在 vcpkg 2022.11.14 版中新增

啟用使用 Git LFS 儲存的擷取檔案。 只會擷取 所指向的 REF 檔案。

這可讓 Git LFS 強制用於埠。 如果未安裝擴充功能，則為嚴重錯誤。

在 vcpkg 2023.01.23 版中新增

如果指定， <url> 將會使用 ，而不是 LFS 的原始 Git URL。

備註

OUT_SOURCE_PATH必須指定、 REF與 URL 。

範例

來源

scripts/cmake/vcpkg_from_git.cmake