vcpkg install

構文

• クラシック モード

vcpkg install [options] <package>...

• マニフェスト モード

vcpkg install [options]

説明

ポート パッケージをビルドしてインストールします。

クラシック モード

クラシック モードでは、この動詞は、インストールされているディレクトリ内の既存のセットにポート パッケージをinstalled/追加します (既定では vcpkg ルートの下)。 これにより、既存のパッケージの削除と再構築が必要になり、失敗する可能性があります。

パッケージ構文

portname[feature1,feature2]:triplet

トリプレットのないパッケージ参照は、既定のターゲット トリプレットによって自動的に修飾されます。 明示的に一覧表示 core されないパッケージ参照は、すべての既定の機能を意味すると見なされます。

マニフェスト モード

マニフェスト モードでは、このコマンドは、インストールされているディレクトリをマニフェスト ファイルでvcpkg.json指定された状態に設定し、必要に応じてパッケージを追加、削除、または再構築します。

[オプション]

すべての vcpkg コマンドでは、一連の 一般的なオプションがサポートされています。

--allow-unsupported

サポートされていないポートで停止するのではなく、警告を続けます。

既定では、vcpkg は、句外のトリプレットのポート インストールを含むインストール プランの実行を "supports" 拒否します。 パッケージの句は "supports" 、パッケージがビルド可能であると予想されるプラットフォームの完全なセットを記述します。 このフラグは、ビルドが停止するのではなく失敗することが予想されることを警告するように vcpkg に指示します。

--clean-after-build

各パッケージをビルドした後、ビルドツリー、パッケージ、およびダウンロードをクリーンアップします。

このオプションは、渡す --clean-buildtrees-after-build、 --clean-downloads-after-buildおよび --clean-packages-after-build.

--clean-buildtrees-after-build

各パッケージをビルドした後、ビルドツリーの一時サブフォルダーからすべてのサブディレクトリをクリーンアップします。

ビルドツリーサブフォルダー内のすべての最上位ファイル (例: buildtrees/zlib/config-x64-windows-out.log) が保持されます。 すべてのサブディレクトリが削除されます。

--clean-downloads-after-build

各パッケージをビルドした後、フォルダーからすべての未トレースアセットを downloads/ クリーンアップします。

フォルダー内 downloads/ のすべての最上位ファイルが削除されます。 抽出されたツールは保持されます。

--clean-packages-after-build

各パッケージをビルドした後、パッケージの一時サブフォルダーをクリーンアップします。

ビルドされたパッケージのパッケージ サブフォルダー (たとえば) は、 packages/zlib_x64-windowsインストール後に削除されます。

--dry-run

インストール 計画を印刷しますが、パッケージを削除したりインストールしたりしないでください。

インストール 計画には、インストールされるすべてのパッケージと機能、および削除して再構築する必要があるその他のパッケージが一覧表示されます。

--editable

• クラシック モードのみ

コマンド ラインで、直接参照されているすべてのパッケージに対して編集可能なビルドを実行します。

vcpkg はポートをビルドするときに、毎回ソース コードを消去して再抽出し、入力が正確であることを確認します。 これは、マニフェスト モードでインストールされている内容を正確に更新し、バイナリ キャッシュでキャッシュされたコンテンツが正しいことを確認するために必要です。

フラグを --editable 渡すと、この動作は無効になります。フォルダー内の抽出されたソースに対する編集は buildtrees/ 保持されます。 これにより、変更ごとにファイルを書き込む必要がないように、パッチをすばやく開発できます。

編集可能なビルド中に抽出されたソースは、ディレクトリ名にサフィックスを付 .clean/ けず、以降の編集不可能なビルドではクリアされません。

--enforce-port-checks

ポートで問題が検出された場合、または非推奨の機能を使用しようとすると、インストールが失敗します。

既定では、vcpkg はビルドされたパッケージで複数のチェックを実行し、問題が検出された場合は警告を出力します。 このフラグは、これらの警告をエラーにアップグレードします。

--x-feature=<feature>

Note

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

• マニフェスト モードのみ

依存関係をインストールする追加機能vcpkg.jsonを指定します。

既定では、依存関係"default-features"のみが"dependencies"インストールされます。

--head

• クラシック モードのみ

ビルド時に使用可能な最新のソースをフェッチするには、コマンド ラインで明示的に参照されているすべてのパッケージを要求します。

このフラグは、一時的なテストのみを目的としており、運用環境や長期的な使用を目的としたものではありません。 vcpkg ではすべての入力を正確に追跡できないため、明示的に参照されているすべてのパッケージとその依存パッケージのバイナリ キャッシュが無効になります。

--keep-going

最初の障害が発生した後、インストール計画を続行します。

既定では、vcpkg は最初のパッケージ ビルドエラーで停止します。 このフラグは、失敗したパッケージに依存しないインストール 計画の他の部分のビルドとインストールを継続するように vcpkg に指示します。

--x-no-default-features

Note

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

• マニフェスト モードのみ

最上位レベルのマニフェストから既定の機能をインストールしないでください。

マニフェスト モードで使用 install する場合、既定では、一覧表示されている "default-features" 機能のすべての依存関係がインストールされます。 このフラグは、明示的に有効になっている機能のみがインストールされるように、その動作を --x-feature 無効にします。

--no-downloads

パッケージをビルドするときに、ビルド中にポートが新しいアセットをダウンロードできないようにします。

既定では、ポートはインターネットからオンデマンドでソース コードとツールを取得します (資産キャッシュの対象)。 このパラメーターは、ダウンロードをブロックし、以前にダウンロードされ、コンピューターにキャッシュされた資産のみにポートを制限します。

--only-downloads

ビルドを実行せずに、インストール 計画に必要なすべての資産のダウンロードを試みます。

このオプションを渡すと、vcpkg は、最初の非ダウンロード外部プロセス呼び出しを行うまで、プラン内の各ビルドを実行します。 ほとんどのポートでは、最初の外部プロセス呼び出し (通常はビルド システム) の前にすべてのダウンロードが実行されるため、この手順では必要なすべての資産がダウンロードされます。 この手順に従わないポートでは、資産は事前にダウンロードされません。

--only-binarycaching

ビルドの実行を拒否します。 バイナリ キャッシュからの みパッケージを復元します。

このフラグは、vcpkg が必要に応じてビルドを実行するのをブロックし、バイナリ キャッシュにパッケージが見つからない場合は失敗します。

--recurse

• クラシック モードのみ

パッケージの再構築を必要とするインストール 計画を承認します。

インストールされているパッケージの機能セットを変更するには、vcpkg がそのパッケージを削除して再構築する必要があります。 これにより、ユーザーが開始したパッケージよりも少ないパッケージでインストール ツリーが失敗して残される可能性があるため、ユーザーはこのフラグを渡してパッケージを再構築するプランを承認する必要があります。

--x-use-aria2

Note

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

ダウンロード タスクを実行するには、aria2 を使用します。

--x-write-nuget-packages-config

Note

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

バイナリ キャッシュで使用する NuGet packages.config形式のファイルを書き込みます。

このオプションを組み合わせて --dry-run 使用すると、パッケージをビルドまたはインストールすることなく、バイナリ キャッシュから必要な NuGet パッケージの一覧を取得できます。 これにより、代替プロトコルを使用してファイルを取得するなど、高度なシナリオで NuGet コマンド ラインを個別に .nupkg 呼び出すことができます。

--no-print-usage

インストールの終了時に印刷される使用テキストの生成を抑制します。