次の方法で共有

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

マニフェストに書き込むバージョンが 'date' バージョンであることを示します。 日付バージョンは ISO 8601 日付です (例: "YYYY-MM-DD")。 詳細については、 バージョン管理のリファレンス を参照してください。

--version-string

マニフェストに書き込むバージョンが、順序のない 'string' バージョンであることを示します

セマンティクス。 詳細については、 バージョン管理のリファレンス を参照してください。

例

Note

vcpkg newでは、メタデータがvcpkg-configuration.jsonファイルにvcpkg.json生成されます。 これには、実験成果物エクスペリエンスとの統合が含まれます。 特に、レジストリ "kind": "artifact" は試験的な vcpkg-artifacts 機能用です。

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

With --name and --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"
    }
  ]
}