vcpkg export

개요

vcpkg export [options] {<package>... | --x-all-installed}

Description

설치된 디렉터리에서 독립 실행형 개발자 SDK로 빌드된 패키지를 내보냅니다.

export 는 vcpkg를 별도로 획득하지 않고 다른 컴퓨터에서 사용할 수 있는 독립 실행형 배포 가능 SDK(소프트웨어 개발 키트)를 생성합니다. 여기에는 다음이 포함됩니다.

1. 선택한 패키지에 대해 미리 빌드된 이진 파일
2. 전이적 종속성
3. 통합 파일(예: CMake 도구 체인 또는 MSBuild props/targets)

이 export 명령은 패키지 또는 전이적 종속성을 설치하지 않습니다. 이미 설치된 패키지만 내보냅니다.

자세한 내용은 매니페스트 모드 또는 클래식 모드 를 참조하세요.

클래식 모드

클래식 모드 vcpkg export 에서는 트리플렛 정규화된 패키지 사양 인수를 허용합니다(예: zlib:x64-windows).

명령줄에 인수를 추가하여 <port name>:<triplet> 내보낼 패키지를 지정합니다.

예를 들어 패키지를 내보내려면 x64-linux다음을 sqlitex64-windows 사용합니다.

vcpkg export sqlite:x64-windows sqlite:x64-linux --zip

이 명령은 지정된 패키지를 zip 형식으로 내보냅니다. 둘 다 sqlite:x64-windows 실행 sqlite:x64-linuxvcpkg export하기 전에 설치해야 합니다.

매니페스트 모드

매니페스트 모드에서 명령은 현재 설치된 모든 패키지를 내보냅니다. 설치 디렉터리에는 매니페스트(vcpkg.json)에 선언된 모든 패키지와 전이적 종속성이 포함됩니다. 이 명령을 사용하기 전에 실행 vcpkg install 하여 필요한 모든 패키지가 설치되어 있는지 확인합니다.

이 모드에서는 내보낼 개별 패키지를 지정할 수 없습니다. 이 명령은 매니페스트 파일에 지정된 종속성 및 버전을 기준으로 설치된 전체 상태에서 단일 엔터티로 작동합니다.

또 다른 차이점은 옵션의 요구 사항입니다 --output-dir . 이 옵션은 내보낸 패키지가 저장될 디렉터리를 지정합니다.

예를 들어 매니페스트 디렉터리에서

vcpkg export --zip --output-dir=.\exports

현재 설치된 모든 패키지를 zip 파일의 .\exports 디렉터리로 내보냅니다. 이 --zip 옵션은 내보낸 패키지를 zip 파일로 압축해야 한다고 지정합니다.

표준 통합

대부분의 내보내기 형식에는 표준 통합 파일 집합이 포함되어 있습니다.

• 의 CMake 도구 체인/scripts/buildsystems/vcpkg.cmake
• MSBuild props/targets at /scripts/buildsystems/msbuild/vcpkg.props and and /scripts/buildsystems/msbuild/vcpkg.targets
• 의 설치 트리/

일부 내보내기 형식은 이 표준 집합과 다릅니다. 자세한 내용은 아래의 개별 형식 도움말을 참조하세요.

형식

공식적으로 지원되는 SDK 형식:

• 원시 디렉터리
• Zip
• 7zip
• NuGet

원시 디렉터리

vcpkg export --raw [options] <package>...

에서 압축되지 않은 디렉터리 레이아웃을 만듭니다 <output-dir>/<output>/.

표준 통합 파일을 포함합니다.

압축 파일

vcpkg export --zip [options] <package>...

에서 <output-dir>/<output>.zipzip 압축 디렉터리 레이아웃을 만듭니다.

표준 통합 파일을 포함합니다.

7Zip

vcpkg export --7zip [options] <package>...

에서 7zip 디렉터리 레이아웃 <output-dir>/<output>.7z을 만듭니다.

표준 통합 파일을 포함합니다.

누겟

vcpkg export --nuget [options] <package>...

에서 NuGet 패키지를 만듭니다 <output-dir>/<nuget-id>.<nuget-version>.nupkg.

NuGet 패키지 관리자를 통해 MSBuild C++ 프로젝트(.vcxproj)에 포함을 지원하기 위한 추가 MSBuild 통합뿐만 아니라 표준 통합 파일을 포함합니다. 함께 생성된 export 여러 NuGet 패키지를 혼합할 수 없습니다. 패키지 중 하나만 사용됩니다. 라이브러리를 추가하려면 전체 종속성 집합을 사용하여 새 내보내기를 만들어야 합니다.

특정 옵션 서식 지정:

• --nuget-id
• --nuget-version
• --nuget-description

IFW

IFW 내보내기가 제거되었습니다.

Chocolatey

초콜릿 수출이 제거되었습니다.

조립식 가옥

프리팹 내보내기가 제거되었습니다.

Options

모든 vcpkg 명령은 일반적인 옵션 집합을 지원합니다.

<package>

SDK에 포함될 최상위 빌드 패키지 목록입니다. 결과 SDK가 자체 포함되도록 이러한 패키지의 모든 종속성도 포함됩니다.

패키지 구문

<port name>:<triplet>

트리플렛이 없는 패키지 참조는 기본 대상 트리플렛에 의해 자동으로 정규화됩니다. 참고: <port name>:<triplet> 매니페스트 모드에서는 인수를 사용할 vcpkg export 수 없습니다.

--x-all-installed

설치된 모든 패키지를 내보냅니다. 이 옵션은 매니페스트 모드에서 사용할 vcpkg export 때 암시됩니다.

--dereference-symlinks

symlinks를 내보낸 결과의 일반 파일 및 디렉터리로 복사합니다.

--dry-run

내보내기를 수행하지 않고 내보내기 계획만 인쇄합니다.

--nuget-description=

NuGet .nupkg 파일에 대한 출력 설명을 지정합니다.

기본값은 "Vcpkg NuGet 내보내기"입니다.

--nuget-id=

NuGet .nupkg 파일의 출력 ID를 지정합니다.

이 옵션은 NuGet 내보내기 전용 옵션을 재정 --output 의합니다. 기본값은 참조 --output 하세요.

--nuget-version=

NuGet .nupkg 파일의 출력 버전을 지정합니다.

기본값은 1.0.0입니다.

--output=

출력 기본 이름을 지정합니다.

각 SDK 형식은 이 기본 이름을 사용하여 특정 출력 파일을 확인합니다. 자세한 내용은 위의 SDK 관련 설명서를 참조하세요.

기본값은 vcpkg-export-<date>-<time>입니다. 스크립틱된 사용은 export 항상 결정적 출력을 보장하기 위해 이 플래그를 전달해야 합니다.

--output-dir=

출력 디렉터리를 지정합니다.

모든 최상위 SDK 파일이 이 디렉터리에 생성됩니다. 이 옵션은 매니페스트 모드에서 필요합니다. 클래식 모드에서는 선택 사항이며 기본적으로 vcpkg 루트 디렉터리로 설정됩니다.