使用 vcpkg x-add-version 搭配 Git 或目錄結構工具，自動建立與維護本地 vcpkg registry

你可以使用 vcpkg x-add-version 搭配 Git 或目錄結構工具，自動建立與維護本地 vcpkg registry。以下是推薦工具與流程：

🧰 常用工具與方法

用法：

vcpkg x-add-version --all --verbose \
  --x-builtin-ports-root=./ports \
  --x-builtin-registry-versions-dir=./versions

建立 registry 結構：

mkdir vcpkg-registry
cd vcpkg-registry
mkdir ports versions
echo "{ \"default\": {} }" > versions/baseline.json
git init

若你有大量 ports 或需要版本比對、hash 計算，可用 Python 腳本自動：
- 掃描 ports/ 資料夾。
- 產生 vcpkg.json 與 portfile.cmake 模板。
- 呼叫 x-add-version。
可整合 Git tag、CI/CD pipeline。

自動在 push 時執行：

steps:
  - run: vcpkg x-add-version --all --verbose ...
  - run: git commit -am "Update registry versions"
  - run: git push

階段	工具	功能
建立 registry 結構	Git + mkdir	建立 `ports/` 與 `versions/`
新增 port	手動或腳本	放入 `vcpkg.json` 與 `portfile.cmake`
建立版本資料庫	`x-add-version`	自動產生 `versions/*.json`
baseline 管理	`baseline.json` + Git	控制預設版本
自動化更新	CI/CD + CLI	確保版本一致性

如果你希望我幫你寫一份 可重複使用的 .bat 或 .sh 腳本，自動建立 registry 結構、加入 port、執行版本更新，我可以幫你整理一份模組化範本，適合團隊使用。要不要我幫你寫出來？

File8	File	Last Modified
vcpkg-local-how-to	vcpkg-local-how-to	1:22 AM - December 07, 2025
vcpkg_checker	vcpkg_checker	1:22 AM - December 07, 2025
vcpkg 指令總覽表	vcpkg 指令總覽表	1:22 AM - December 07, 2025
模組化開發-用 CMake + VCpkg 封裝並重用 C++ 函式庫	模組化開發-用 CMake + VCpkg 封裝並重用 C++ 函式庫	8:20 PM - December 06, 2025
模組化開發-VCpkg工具	模組化開發-VCpkg工具	8:20 PM - December 06, 2025
查詢目前vcpkg registry所在路徑	查詢目前vcpkg registry所在路徑	8:20 PM - December 06, 2025
本地 `src` vs. `vcpkg_from_git`	本地 `src` vs. `vcpkg_from_git`	8:20 PM - December 06, 2025
如何產生 git-tree	如何產生 git-tree	8:20 PM - December 06, 2025