一般的なコマンド オプション

ほとんどの vcpkg コマンドは、ツールの横断的な側面を制御する一般的なオプションのグループを受け入れます。 すべてのオプションがすべてのコマンドに影響を与えるわけではありません。 たとえば、ファイルをダウンロードしないコマンドは、ダウンロード ディレクトリを変更しても影響を受けません。

[オプション]

--x-asset-sources=<config>

Note

このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。

資産キャッシュのキャッシュ構成を 指定します。

--binarysource=<config>

バイナリ キャッシュのソースを 追加します。

このオプションは複数回指定できます。複数のバイナリ ソースが対話する方法については、バイナリ キャッシュに関するドキュメントを参照してください。

--x-buildtrees-root=<path>

Note

このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。

オブジェクトやアンパックされたソース コードなど、中間ビルド ファイルを格納する一時パスを指定します。

既定では、 buildtrees/ vcpkg ルート フォルダーの下に設定されます。

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

Note

このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。

CMake の--debuggerアップストリーム ビルド システム内 (内部などvcpkg_cmake_configure) をCMakeLists.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]

Note

このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。

--debuggerトリプレット ファイル (例: x64-windows.cmake) やportfile.cmakeファイルなどの直接呼び出された CMake スクリプトの実行中に 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>

ホスト トリプレットを指定します。

既定値は環境変数です VCPKG_DEFAULT_HOST_TRIPLET 。 これが設定されていない場合は、ホスト アーキテクチャとオペレーティング システムに基づいて値が推定されます。

--x-install-root=<path>

Note

このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。

インストールされているパッケージをレイアウトするパスを指定します。

クラシック モードでは、既定では vcpkg ルート フォルダーの下にinstalled/設定されます。

マニフェスト モードでは、既定ではマニフェスト フォルダーの下にvcpkg_installed/設定されます。

--x-manifest-root=<path>

Note

このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。

を含むディレクトリを vcpkg.json指定します。

既定では、現在の作業ディレクトリから最も近いもの vcpkg.jsonを検索します。

--overlay-ports=<path>

オーバーレイ ポートを含むディレクトリを指定します。

このオプションは複数回指定できます。ポートは最初の一致に解決されます。

--overlay-triplets=<path>

オーバーレイトリプレットを含むディレクトリを指定します。

このオプションは、複数のディレクトリを追加するために複数回指定できます。トリプレットは名前によって最初の一致に解決されます。

--x-packages-root=<path>

Note

このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。

最終インストールの前に中間パッケージ ファイルをステージングするための一時的なパスを指定します。

既定では、 packages/ vcpkg ルート フォルダーの下に設定されます。

--triplet=<triplet>

ターゲット アーキテクチャトリプレットを指定します。

既定値は環境変数です VCPKG_DEFAULT_TRIPLET 。 これが設定されていない場合は、ホスト アーキテクチャとオペレーティング システムに基づいて推測されます。

Windows オペレーティング システムでは、従来の理由から、アーキテクチャは常に x86 として推定されます。

Note

2023 年 9 月以降に行われたすべてのリリースは、既定で x86-windows ではなく Windows 上のホスト トリプレットになります。

--vcpkg-root=<path>

vcpkg ルート フォルダーを指定します。

既定値は、vcpkg プログラムを含むディレクトリです。 ディレクトリは、次のようなgit clonehttps://github.com/microsoft/vcpkg有効な vcpkg インスタンスである必要があります。 このオプションを使用すると、ビルド フォルダーから直接ツールのカスタムビルド コピーを実行できます。

応答ファイル (@<file>)

vcpkg コマンド ラインは、改行区切りのコマンド ライン パラメーターを含むテキスト ファイルを受け入れます。

このツールは、ファイル内の項目が参照の代わりに @ コマンド ラインにスプライシングされたかのように動作します。 応答ファイルに追加の応答ファイルを含めることはできません。