vcpkg new
vcpkg new --application
vcpkg new --name hello --version 1.0 [--version-relaxed | --version-date | --version-string]
建立指令清單檔 (vcpkg.json
) 和預設組態檔 (vcpkg-configuration.json
) 準備在目前工作目錄中的專案中使用。
--application
如果您的項目是使用者應用程式,請使用旗標。
如果未使用 --application
, --name
則需要 和 --version
。 --version-date
、 --version-relaxed
或 --version-string
可以強制選取特定版本格式。
如需版本設定格式的詳細資訊,請參閱 版本控制參考。
所有 vcpkg 命令都支援一組 常見的選項。
建立適合在應用程式中使用的指令清單,移除提供名稱和版本的需求。
要寫入指令清單的名稱。
表示要寫入指令清單的版本。 如果未傳遞其他版本格式參數,請根據輸入的格式推斷要使用的適當表單。
表示要寫入指令清單的版本是「寬鬆」版本。 寬鬆版本會遵守語意版本設定的格式,但允許任意數目的數值。 如需詳細資訊,請參閱 版本控制參考 。
表示要寫入指令清單的版本是「日期」版本。 日期版本是 ISO 8601 日期(例如 “YYYY-MM-DD”。 如需詳細資訊,請參閱 版本控制參考 。
表示要寫入指令清單的版本是沒有排序的 『string』 版本
語義。 如需詳細資訊,請參閱 版本控制參考 。
注意
vcpkg new
在和 vcpkg-configuration.json
檔案中vcpkg.json
產生元數據。 這包括與實驗成品體驗的整合。 特別是,具有 "kind": "artifact"
的登錄適用於實驗 vcpkg-artifacts 功能。
$ vcpkg new --application
$ type vcpkg.json
{}
$ type .\vcpkg-configuration.json
{
"default-registry": {
"kind": "git",
"baseline": "64adda19c86e89526b5e27703a193c14477cce07",
"repository": "https://github.com/microsoft/vcpkg"
},
"registries": [
{
"kind": "artifact",
"location": "https://github.com/microsoft/vcpkg-ce-catalog/archive/refs/heads/main.zip",
"name": "microsoft"
}
]
}
$ vcpkg new --name hello --version 2023-07-05
$ type vcpkg.json
{
"name": "hello",
"version-date": "2023-07-05"
}
$ type .\vcpkg-configuration.json
{
"default-registry": {
"kind": "git",
"baseline": "64adda19c86e89526b5e27703a193c14477cce07",
"repository": "https://github.com/microsoft/vcpkg"
},
"registries": [
{
"kind": "artifact",
"location": "https://github.com/microsoft/vcpkg-ce-catalog/archive/refs/heads/main.zip",
"name": "microsoft"
}
]
}
$ vcpkg new --name hello --version 1.0 --version-date
error: `1.0` is not a valid date version. Dates must follow the format YYYY-MM-DD and disambiguators must be dot-separated positive integer values without leading zeroes.
$ vcpkg new --name hello --version 1.0 --version-string
$ type vcpkg.json
{
"name": "hello",
"version-string": "1.0"
}
$ type .\vcpkg-configuration.json
{
"default-registry": {
"kind": "git",
"baseline": "64adda19c86e89526b5e27703a193c14477cce07",
"repository": "https://github.com/microsoft/vcpkg"
},
"registries": [
{
"kind": "artifact",
"location": "https://github.com/microsoft/vcpkg-ce-catalog/archive/refs/heads/main.zip",
"name": "microsoft"
}
]
}