vcpkg nouveau

Synopsis

vcpkg new --application

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

Crée un fichier manifeste (vcpkg.json) et un fichier de configuration par défaut (vcpkg-configuration.json) prêt à être utilisé dans votre projet dans le répertoire de travail actuel.

Utilisez l’indicateur --application si votre projet est une application utilisateur final.

Si ce n’est pas le --applicationcas, --name et --version si elles sont requises. --version-date, --version-relaxedou --version-string peut forcer la sélection d’un format de version particulier. Pour plus d’informations sur les formats de contrôle de version, consultez référence du contrôle de version.

Options

Toutes les commandes vcpkg prennent en charge un ensemble d’options courantes.

--application

Crée un manifeste adapté à une utilisation dans les applications, en supprimant la nécessité de fournir le nom et la version.

--name

Nom à écrire dans le manifeste.

--version

Indique la version à écrire dans le manifeste. Si aucun des autres commutateurs de format de version n’est passé, déduit le formulaire approprié à utiliser en fonction de la forme de l’entrée.

--version-relaxed

Indique que la version à écrire dans le manifeste est une version « détendue ». Les versions assouplies obéissent au format du contrôle de version sémantique, mais autorisent un nombre quelconque de valeurs numériques. Pour plus d’informations, consultez les informations de référence sur le contrôle de version.

--version-date

Indique que la version à écrire dans le manifeste est une version « date ». Les versions de date sont une date ISO 8601 (par exemple, « AAAA-MM-DD »). Pour plus d’informations, consultez les informations de référence sur le contrôle de version.

--version-string

Indique que la version à écrire dans le manifeste est une version de « chaîne » sans classement

Sémantique. Pour plus d’informations, consultez les informations de référence sur le contrôle de version.

Exemples

Remarque

vcpkg newgénère des métadonnées dans et vcpkg-configuration.json des vcpkg.json fichiers. Cela inclut l’intégration à l’expérience d’artefacts expérimentaux. En particulier, les registres avec "kind": "artifact" utilisant sont destinés à la fonctionnalité vcpkg-artifacts expérimentale.

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

Avec --name et --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"
    }
  ]
}

Avec la sélection de format de version explicite

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