ほとんどの vcpkg コマンドは、ツールの横断的な側面を制御する一般的なオプションのグループを受け入れます。 すべてのオプションがすべてのコマンドに影響を与えるわけではありません。 たとえば、ファイルをダウンロードしないコマンドは、ダウンロード ディレクトリを変更しても影響を受けません。
オプション
--x-asset-sources=<config>
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
Asset Caching のキャッシュ構成を指定します。
--binary-cache-compression-level=<0-9>
バイナリ キャッシュ ZIP アーカイブの圧縮レベルを設定します。 値は、 0 から 9までの 1 桁である必要があります。 0 圧縮なしでファイルを格納し、 1 は最速の圧縮を要求し、 9 は最大圧縮を要求します。
中間レベルは、アーカイブサイズの圧縮時間を交換します。正確な結果はアーカイブ ツールによって異なります。
このオプションは、
VCPKG_BINARY_CACHE_COMPRESSION_LEVEL 環境変数。 どちらの設定も指定しない場合、vcpkg はアーカイブ ツールの既定の圧縮レベルを使用します。
空の値を含む無効な値は、バイナリ キャッシュの初期化時に拒否されます。
vcpkg install zlib --binary-cache-compression-level=1
この設定は、vcpkg の ZIP 作成を使用するすべての バイナリ キャッシュ プロバイダー に適用されます。 NuGet パッケージは影響を受けません。 圧縮レベルを変更しても、パッケージ ABI ハッシュは変更されず、既存のキャッシュ エントリは無効になりません。
--binarysource=<config>
Binary Caching のソースを追加します。
このオプションは複数回指定できます。複数のバイナリ ソースが対話する方法については、バイナリ キャッシュに関するドキュメントを参照してください。
--x-buildtrees-root=<path>
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
オブジェクトやアンパックされたソース コードなど、中間ビルド ファイルを格納する一時パスを指定します。
既定では、vcpkg ルート フォルダーの下に buildtrees/ します。
--classic
manifest ファイル検出された場合でもクラス モードを強制します。
--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
--debugger内など、アップストリーム ビルド システムのCMakeLists.txt内で CMake のvcpkg_cmake_configureを有効にします。
<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]
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
トリプレット ファイル (--debugger など) やx64-windows.cmake ファイルなどの直接呼び出された CMake スクリプトを実行しているときに、CMake のportfile.cmakeを有効にします。
<debugger-pipe>値は、CMake コマンド ラインで--debugger-pipeとして渡されます。
セミコロンで区切られたポートリストがある場合、デバッガーはそのリスト内のポートにのみ使用されます。 それ以外の場合は、すべてのポートに使用されます。
注: vcpkg の出力で Waiting for debugger client to connect... を確認でき、デバッガーが接続されるまで実行が停止する場合は、デバッガーをアタッチできます。
--downloads-root=<path>
ダウンロードしたツールとソース コード アーカイブを保存する場所を指定します。
既定値は VCPKG_DOWNLOADS 環境変数です。 これが設定されていない場合、既定では vcpkg ルート フォルダーの下に downloads/ されます。
--feature-flags=<flag1>,...
この変数は、試験的な動作にオプトインする機能フラグの一覧に設定できます。
--host-triplet=<triplet>
ホスト tripletを指定します。
既定値は VCPKG_DEFAULT_HOST_TRIPLET 環境変数です。 これが設定されていない場合は、ホスト アーキテクチャとオペレーティング システムに基づいて値が推定されます。
--x-install-root=<path>
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
インストールされているパッケージをレイアウトするパスを指定します。
Classic モードでは、既定では vcpkg ルート フォルダーの下にinstalled/されます。
Manifest モードでは、既定ではマニフェスト フォルダーの下にvcpkg_installed/されます。
--x-manifest-root=<path>
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
vcpkg.jsonを含むディレクトリを指定します。
既定では、現在の作業ディレクトリから最も近い vcpkg.jsonを検索します。
--overlay-ports=<path>
overlay ポート、またはそれ自体がオーバーレイ ポートであるサブディレクトリを指定します。
<path>がCONTROLまたはvcpkg.jsonを含むディレクトリである場合、そのディレクトリはオーバーレイ ポート ディレクトリとして扱われ、サブディレクトリ追加のオーバーレイ ポートと見なされることはありません。
このオプションは複数回指定できます。ポートは最初の一致に解決されます。
--overlay-triplets=<path>
overlay トリプレットを含むディレクトリを指定します。
このオプションは、複数のディレクトリを追加するために複数回指定できます。トリプレットは名前によって最初の一致に解決されます。
--x-packages-root=<path>
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
最終インストールの前に中間パッケージ ファイルをステージングするための一時的なパスを指定します。
既定では、vcpkg ルート フォルダーの下に packages/ します。
--triplet=<triplet>
ターゲット architecture triplet を指定します。
既定値は VCPKG_DEFAULT_TRIPLET 環境変数です。 これが設定されていない場合は、ホスト アーキテクチャとオペレーティング システムに基づいて推測されます。
Windows オペレーティング システムでは、従来の理由から、アーキテクチャは常に x86 として推定されます。
Note
2023 年 9 月以降に行われたすべてのリリースは、既定で x86-windows ではなく Windows 上のホスト トリプレットになります。
--vcpkg-root=<path>
vcpkg ルート フォルダーを指定します。
既定値は、vcpkg プログラムを含むディレクトリです。 ディレクトリは、git cloneのhttps://github.com/microsoft/vcpkgなど、有効な vcpkg インスタンスである必要があります。 このオプションを使用すると、ビルド フォルダーから直接ツールのカスタムビルド コピーを実行できます。
応答ファイル (@<file>)
vcpkg コマンド ラインは、改行区切りのコマンド ライン パラメーターを含むテキスト ファイルを受け入れます。
ツールは、ファイル内の項目が @ 参照の代わりにコマンド ラインにスプライシングされたかのように動作します。 応答ファイルに追加の応答ファイルを含めることはできません。
vcpkg