英語で読む

次の方法で共有


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

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

[オプション]

--x-asset-sources=<config>

注意

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

Asset Caching のキャッシュ構成を指定します。

--binarysource=<config>

Binary Caching のソースを追加します。

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

--x-buildtrees-root=<path>

注意

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

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

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

--classic

manifest ファイル検出された場合でもクラス モードを強制します。

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

注意

このセクションでは、いつでも変更または削除できる 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 をビルド システムとして実際に使用するポートに主に役立ちます。

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

注意

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

トリプレット ファイル (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 環境変数です。 これが設定されていない場合、既定では vcpkg ルート フォルダーの下に downloads/ されます。

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

この変数は、試験的な動作にオプトインする機能フラグの一覧に設定できます。

--host-triplet=<triplet>

ホスト tripletを指定します。

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

--x-install-root=<path>

注意

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

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

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

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

--x-manifest-root=<path>

注意

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

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

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

--overlay-ports=<path>

overlay ポート、またはそれ自体がオーバーレイ ポートであるサブディレクトリを指定します。 <path>CONTROLまたはvcpkg.jsonを含むディレクトリである場合、そのディレクトリはオーバーレイ ポート ディレクトリとして扱われ、サブディレクトリ追加のオーバーレイ ポートと見なされることはありません。

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

--overlay-triplets=<path>

overlay トリプレットを含むディレクトリを指定します。

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

--x-packages-root=<path>

注意

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

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

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

--triplet=<triplet>

ターゲット architecture triplet を指定します。

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

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

注意

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

--vcpkg-root=<path>

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

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

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

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

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