nový vcpkg

Synopse

vcpkg new --application

vcpkg new --name hello --version 1.0 [--version-relaxed | --version-date | --version-string]

Vytvoří soubor manifestu (vcpkg.json) a výchozí konfigurační soubor (vcpkg-configuration.json) připravený k použití v projektu v aktuálním pracovním adresáři.

--application Příznak použijte, pokud je projekt aplikací koncového uživatele.

Pokud nepoužíváte --application, --name a --version jsou vyžadovány. --version-date, --version-relaxednebo --version-string může vynutit, aby byl vybrán určitý formát verze. Další informace o formátech správy verzí najdete v referenčních informacích k správě verzí.

Možnosti

Všechny příkazy vcpkg podporují sadu běžných možností.

--application

Vytvoří manifest vhodný pro použití v aplikacích, čímž se odebere požadavek na zadání názvu a verze.

--name

Název pro zápis do manifestu.

--version

Označuje verzi, která se má do manifestu zapisovat. Pokud se nepředá žádný z dalších přepínačů formátu verze, odvodí příslušný formulář, který se použije na základě formuláře vstupu.

--version-relaxed

Označuje, že verze pro zápis do manifestu je "uvolněná" verze. Uvolněné verze dodržují sémantický formát správy verzí, ale umožňují libovolný počet číselných hodnot. Další informace najdete v referenčních informacích k správě verzí.

--version-date

Označuje, že verze, která se má zapisovat do manifestu, je "date" verze. Date versions are an ISO 8601 date (např. "YYYY-MM-DD"). Další informace najdete v referenčních informacích k správě verzí.

--version-string

Označuje, že verze pro zápis do manifestu je "řetězcová" verze bez řazení.

Sémantika. Další informace najdete v referenčních informacích k správě verzí.

Příklady

Poznámka:

vcpkg new generuje metadata v vcpkg.json souborech a vcpkg-configuration.json souborech. To zahrnuje integraci s experimentálním prostředím artefaktů. Konkrétně jsou registry "kind": "artifact" určené pro experimentální funkci vcpkg-artifacts.

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

S --name a --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"
    }
  ]
}

Výběr formátu explicitní verze

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