vcpkg yeni

Özet

vcpkg new --application

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

Geçerli çalışma dizinindeki projenizde kullanıma hazır bir bildirim dosyasıvcpkg.json () ve varsayılan yapılandırma dosyası (vcpkg-configuration.json) oluşturur.

Projeniz bir son kullanıcı uygulamasıysa bayrağını --application kullanın.

kullanılmıyorsa --application--name ve --version gereklidir. --version-date, --version-relaxedveya --version-string belirli bir sürüm biçiminin seçilmesini zorlayabilir. Sürüm oluşturma biçimleri hakkında daha fazla bilgi için bkz . Sürüm oluşturma başvurusu.

Seçenekler

Tüm vcpkg komutları bir dizi ortak seçeneği destekler.

--application

Uygulamalarda kullanıma uygun bir bildirim oluşturarak ad ve sürüm sağlama gereksinimini ortadan kaldırır.

--name

Bildirime yazacak ad.

--version

Bildirime yazacak sürümü gösterir. Diğer sürüm biçimi anahtarlarından hiçbiri geçirilmezse, girişin biçimine göre kullanılacak uygun formu çıkarsar.

--version-relaxed

Bildirime yazacak sürümün 'gevşek' bir sürüm olduğunu gösterir. Gevşek sürümler anlamsal sürüm oluşturmanın biçimine uyar, ancak herhangi bir sayıda sayısal değere izin verir. Daha fazla bilgi için bkz . sürüm oluşturma başvurusu .

--version-date

Bildirime yazacak sürümün bir 'date' sürümü olduğunu gösterir. Tarih sürümleri bir ISO 8601 tarihidir (örn. "YYYY-AA-GG"). Daha fazla bilgi için bkz . sürüm oluşturma başvurusu .

--version-string

Bildirime yazılması gereken sürümün, sıralama içermeyen bir 'dize' sürümü olduğunu gösterir

Semantiği. Daha fazla bilgi için bkz . sürüm oluşturma başvurusu .

Örnekler

Dekont

vcpkg newve vcpkg-configuration.json dosyalarında vcpkg.json meta veriler oluşturur. Bu, deneysel yapıtlar deneyimiyle tümleştirmeyi içerir. Özellikle ile kayıt defterleri "kind": "artifact" deneysel vcpkg-artifacts özelliğine yöneliktir.

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

ve ile --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"
    }
  ]
}

Açık sürüm biçimi seçimiyle

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