다음을 통해 공유


일반적인 명령 옵션

대부분의 vcpkg 명령은 도구의 교차 절단 측면을 제어하는 일반적인 옵션 그룹을 허용합니다. 모든 옵션이 모든 명령에 영향을 미치는 것은 아닙니다. 예를 들어 파일을 다운로드하지 않는 명령은 다운로드 디렉터리를 변경하여 영향을 받지 않습니다.

옵션

--x-asset-sources=<config>

참고 항목

이 섹션에서는 언제든지 변경하거나 제거할 수 있는 vcpkg의 실험적 기능에 대해 설명합니다.

자산 캐싱에 대한 캐시 구성을 지정합니다.

--binarysource=<config>

이진 캐싱에 대한 원본을 추가합니다.

이 옵션은 여러 번 지정할 수 있습니다. 여러 이진 원본이 상호 작용하는 방법에 대한 이진 캐싱 설명서를 참조하세요.

--x-buildtrees-root=<path>

참고 항목

이 섹션에서는 언제든지 변경하거나 제거할 수 있는 vcpkg의 실험적 기능에 대해 설명합니다.

개체 또는 압축을 풉니다 소스 코드와 같은 중간 빌드 파일을 저장할 임시 경로를 지정합니다.

기본값은 buildtrees/ vcpkg 루트 폴더 아래에 있습니다.

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

참고 항목

이 섹션에서는 언제든지 변경하거나 제거할 수 있는 vcpkg의 실험적 기능에 대해 설명합니다.

CMake의 --debugger 업스트림 빌드 시스템 내(예: )vcpkg_cmake_configureCMakeLists.txt사용하도록 설정합니다.

값은 <debugger-pipe> CMake 명령줄에서와 같이 --debugger-pipe 전달됩니다.

세미콜론으로 구분된 포트 목록이 있는 경우 디버거는 해당 목록의 포트에만 사용됩니다. 그렇지 않으면 모든 포트에 사용됩니다.

삼중 변수 VCPKG_CMAKE_CONFIGURE_OPTIONS 는 내부 CMake 구성 호출에 옵션을 전달하는 데 사용됩니다. 따라서 사용자 지정 삼중자 덮어쓰기 VCPKG_CMAKE_CONFIGURE_OPTIONS에서는 작동하지 않습니다. 디버깅 옵션을 수동으로 전달하거나 대신 옵션을 VCPKG_CMAKE_CONFIGURE_OPTIONS 추가합니다.

달리 --x-cmake-debug 빌드가 디버거가 연결되기를 기다리고 있음을 나타내는 출력은 없습니다. 출력은 단순히 .에서 Configuring <triplet>중단됩니다.

모든 포트는 CMake 도구 체인에서 컴파일 플래그를 가져오기 위해 포트 파일 내에서 CMake를 호출해야 합니다. 이 명령은 기본 실제로 CMake를 빌드 시스템으로 사용하는 포트에 유용합니다.

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

참고 항목

이 섹션에서는 언제든지 변경하거나 제거할 수 있는 vcpkg의 실험적 기능에 대해 설명합니다.

3중 파일(예: x64-windows.cmake) 또는 portfile.cmake 파일과 같이 직접 호출된 CMake 스크립트를 실행하는 동안 CMake --debugger 를 사용하도록 설정합니다.

값은 <debugger-pipe> CMake 명령줄에서와 같이 --debugger-pipe 전달됩니다.

세미콜론으로 구분된 포트 목록이 있는 경우 디버거는 해당 목록의 포트에만 사용됩니다. 그렇지 않으면 모든 포트에 사용됩니다.

참고: vcpkg의 출력에서 관찰할 수 있는 경우 Waiting for debugger client to connect... 디버거를 연결할 수 있으며 디버거가 연결될 때까지 실행이 중지됩니다.

--downloads-root=<path>

다운로드한 도구 및 소스 코드 보관을 보관할 위치를 지정합니다.

기본값은 환경 변수입니다 VCPKG_DOWNLOADS . 설정되지 않은 경우 기본적으로 downloads/ vcpkg 루트 폴더 아래에 있습니다.

--feature-flags=<flag1>,...

이 변수는 실험적 동작에 옵트인할 기능 플래그 목록으로 설정할 수 있습니다.

--host-triplet=<triplet>

호스트 트리플렛을 지정합니다.

기본값은 환경 변수입니다 VCPKG_DEFAULT_HOST_TRIPLET . 설정되지 않은 경우 값은 호스트 아키텍처 및 운영 체제에 따라 추론됩니다.

--x-install-root=<path>

참고 항목

이 섹션에서는 언제든지 변경하거나 제거할 수 있는 vcpkg의 실험적 기능에 대해 설명합니다.

설치된 패키지를 배치하는 경로를 지정합니다.

클래식 모드에서는 기본적으로 installed/ vcpkg 루트 폴더 아래에 있습니다.

매니페스트 모드에서는 기본적으로 vcpkg_installed/ 매니페스트 폴더 아래에 있습니다.

--x-manifest-root=<path>

참고 항목

이 섹션에서는 언제든지 변경하거나 제거할 수 있는 vcpkg의 실험적 기능에 대해 설명합니다.

를 포함하는 디렉터리를 지정합니다 vcpkg.json.

기본적으로 가장 vcpkg.json가까운 작업 디렉터리에서 위쪽으로 검색합니다.

--overlay-ports=<path>

오버레이 포트포함하는 디렉터리를 지정합니다.

이 옵션은 여러 번 지정할 수 있습니다. 포트가 첫 번째 일치 항목으로 확인됩니다.

--overlay-triplets=<path>

오버레이 삼중항을 포함하는 디렉터리를 지정합니다.

이 옵션은 여러 디렉터리를 추가하도록 여러 번 지정할 수 있습니다. 삼중자는 이름으로 첫 번째 일치 항목으로 확인됩니다.

--x-packages-root=<path>

참고 항목

이 섹션에서는 언제든지 변경하거나 제거할 수 있는 vcpkg의 실험적 기능에 대해 설명합니다.

최종 설치 전에 중간 패키지 파일을 스테이징하는 임시 경로를 지정합니다.

기본값은 packages/ vcpkg 루트 폴더 아래에 있습니다.

--triplet=<triplet>

대상 아키텍처 트리플렛을 지정합니다.

기본값은 환경 변수입니다 VCPKG_DEFAULT_TRIPLET . 설정되지 않은 경우 호스트 아키텍처 및 운영 체제에 따라 추론됩니다.

Windows 운영 체제에서 아키텍처는 레거시 이유로 항상 x86으로 추론됩니다.

참고 항목

2023년 9월 이후의 모든 릴리스는 기본적으로 x86-windows 대신 Windows의 호스트 트리플렛으로 설정됩니다.

--vcpkg-root=<path>

vcpkg 루트 폴더를 지정합니다.

기본적으로 vcpkg 프로그램이 포함된 디렉터리로 설정됩니다. 디렉터리가 유효한 vcpkg 인스턴스여야 합니다(예: git clone .) https://github.com/microsoft/vcpkg. 이 옵션은 빌드 폴더에서 직접 도구의 사용자 지정 빌드 복사본을 실행하는 데 사용할 수 있습니다.

응답 파일(@<file>)

vcpkg 명령줄은 줄 바꿈으로 구분된 명령줄 매개 변수를 포함하는 텍스트 파일을 허용합니다.

이 도구는 파일의 항목이 참조 대신 명령줄에 접합된 것처럼 작동합니다 @ . 응답 파일에는 추가 응답 파일이 포함될 수 없습니다.