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