閱讀英文

共用方式為


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 命令都支援一組 常見的選項

--application

建立適合在應用程式中使用的指令清單,移除提供名稱和版本的需求。

--name

要寫入指令清單的名稱。

--version

表示要寫入指令清單的版本。 如果未傳遞其他版本格式參數,請根據輸入的格式推斷要使用的適當表單。

--version-relaxed

表示要寫入指令清單的版本是「寬鬆」版本。 寬鬆版本會遵守語意版本設定的格式,但允許任意數目的數值。 如需詳細資訊,請參閱 版本控制參考

--version-date

表示要寫入指令清單的版本是「日期」版本。 日期版本是 ISO 8601 日期(例如 “YYYY-MM-DD”。 如需詳細資訊,請參閱 版本控制參考

--version-string

表示要寫入指令清單的版本是沒有排序的 『string』 版本

語義。 如需詳細資訊,請參閱 版本控制參考

範例

注意

vcpkg new在和 vcpkg-configuration.json 檔案中vcpkg.json產生元數據。 這包括與實驗成品體驗的整合。 特別是,具有 "kind": "artifact" 的登錄適用於實驗 vcpkg-artifacts 功能。

使用 --application

$ 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"
    }
  ]
}

使用 --name--version

$ 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"
    }
  ]
}