vcpkg nowy
Streszczenie
vcpkg new --application
vcpkg new --name hello --version 1.0 [--version-relaxed | --version-date | --version-string]
Tworzy plik manifestu () i domyślny plik konfiguracji (vcpkg.json
vcpkg-configuration.json
) gotowy do użycia w projekcie w bieżącym katalogu roboczym.
Użyj flagi --application
, jeśli projekt jest aplikacją użytkownika końcowego.
Jeśli nie używasz elementu --application
, --name
i --version
są wymagane. --version-date
, --version-relaxed
lub --version-string
może wymusić wybranie określonego formatu wersji.
Aby uzyskać więcej informacji na temat formatów przechowywania wersji, zobacz Informacje o wersji.
Opcje
Wszystkie polecenia vcpkg obsługują zestaw typowych opcji.
--application
Tworzy manifest odpowiedni do użycia w aplikacjach, usuwając wymaganie podania nazwy i wersji.
--name
Nazwa do zapisania w manifeście.
--version
Wskazuje wersję do zapisania w manifeście. Jeśli żaden z innych przełączników formatu wersji nie zostanie przekazany, wywnioskuje odpowiedni formularz do użycia na podstawie formularza danych wejściowych.
--version-relaxed
Wskazuje, że wersja do zapisu w manifeście jest wersją "zrelaksowaną". Złagodzone wersje przestrzegają formatu semantycznego przechowywania wersji, ale zezwalają na dowolną liczbę wartości liczbowych. Aby uzyskać więcej informacji, zobacz dokumentację dotyczącą przechowywania wersji.
--version-date
Wskazuje, że wersja do zapisu w manifeście jest wersją "date". Wersje dat to data ISO 8601 (np. "RRRR-MM-DD"). Aby uzyskać więcej informacji, zobacz dokumentację dotyczącą przechowywania wersji.
--version-string
Wskazuje, że wersja do zapisu w manifeście jest wersją "string" bez zamawiania
Semantyka. Aby uzyskać więcej informacji, zobacz dokumentację dotyczącą przechowywania wersji.
Przykłady
Uwaga
vcpkg new
generuje metadane w plikach vcpkg.json
i .vcpkg-configuration.json
Obejmuje to integrację z eksperymentalnym środowiskiem artefaktów. W szczególności rejestry z "kind": "artifact"
programem są przeznaczone dla eksperymentalnej funkcji vcpkg-artifacts.
Z --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"
}
]
}
Z i --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"
}
]
}
Z jawnym wyborem formatu wersji
$ 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"
}
]
}