영어로 읽기

다음을 통해 공유


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

매니페스트에 쓸 버전이 순서가 없는 '문자열' 버전임을 나타냅니다.

의미 체계. 자세한 내용은 버전 관리 참조를 참조하세요.

예제

참고

vcpkg new 는 메타데이터 및 vcpkg.json vcpkg-configuration.json 파일을 생성합니다. 여기에는 실험적 아티팩트 환경과의 통합이 포함됩니다. 특히, 레지스트리 "kind": "artifact" 는 실험적 vcpkg-artifacts 기능을 위한 것입니다.

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