Vcpkg の統合

vcpkg をインストールする

1. メインメニューから表示 | ツールウィンドウ | Vcpkg を選択して、Vcpkg ツールウィンドウを開きます。

2. をクリックします。

   

3. Vcpkg を追加ダイアログでインストール設定を指定します。

   

   • vcpkg リポジトリの名前と URL。

   • インストールディレクトリ (または既定値を使用)。vcpkg がすでにインストールされている場合は、このフィールドにその場所へのパスを指定します。

   • vcpkg 統合を既存の CMake プロファイルに追加する

     CLion は、CMake ツールチェーンファイルを使用して vcpkg と統合します。ツールチェーンファイルをリンクする CMake プロファイルを選択します。

     インストール後、CMAKE_TOOLCHAIN_FILE 変数を介して、選択したプロファイルの CMake のオプションに追加されたツールチェーンファイルを見つけることができます。

4. OK をクリックして、インストールが完了するまで待ちます。

   パッケージのリストが中央のペインに表示されます。右側のペインには、選択したパッケージの説明とアクションが表示されます。

   

パッケージを参照してインストールする

1. 特定のパッケージを見つけるには、検索フィールドにその名前を入力し始めます。

   

2. パッケージを選択して Enter を押すか、右側のペインでインストールをクリックします。

3. クラシックモードでは、パッケージが正常にインストールされた場合、CLion はそれを vcpkg.json に追加してマニフェストモードに切り替えるように求めるプロンプトを表示します。

   

4. インストールされたパッケージはインストール済み | クラシックモードまたは追加済み | マニフェストモードにあります。

   

   

マニフェストモードに切り替える

1. マニフェストモードに切り替えるボタンをクリックします:

   

2. vcpkg.json に追加するパッケージを選択します。

   

3. CLion は vcpkg.json ファイルを作成し、パッケージを追加して、プロジェクトをマニフェストモードに切り替えます。

   

コンソール出力を調査する

コンソール: vcpkg は、すべての vcpkg コマンドと完全な出力を表示する読み取り専用タブです。

• パッケージのインストール中などにエラーが発生すると、CLion は通知メッセージを表示します。出力を表示をクリックしてコンソールタブを開き、問題を調査します。

  

• vcpkg の使用中はいつでもコンソールタブに切り替えることができます。このタブには、コンソールの表示ボタンからもアクセスできます。

  

複数のパッケージのインストール / 削除

1. ツリー内の複数のパッケージを選択します。

2. 次のショートカットを使用します。

   • vcpkg.json をインストールまたは追加するには、Enter を押します。

   • 削除するには、Alt+Delete / ⌘⌫を押します。

パッケージの使用を開始する

パッケージは CMakeLists.txt に追加する必要があります。ほとんどのパッケージでは、vcpkg は CMake スクリプトに含めるコードを提供します。

1. vcpkg からのヒントがある場合は、通知にパッケージを CMakeLists.txt に追加するオプションが表示されます。

   

2. 提案されたコードを CMakeLists.txt ファイルにコピーします。必要に応じて、ターゲットリンク名 (デフォルトでは main) を、パッケージをリンクしたい名前に変更します。

   

vcpkg とパッケージを更新する

更新とアップグレードには、次のツールウィンドウアクションを使用します。

• すべて更新は、vcpkg Git リポジトリを最新バージョンに更新し、利用可能なパッケージ更新をチェックします。

  

• すべてアップグレードは、vcpkg Git リポジトリを最新バージョンに更新してから、インストールされているすべてのパッケージを最新バージョンに更新します。

  

• アップデートの確認 ( メニュー) は、vcpkg Git リポジトリの新しいバージョンがあるかどうかを確認します。

• リポジトリの更新 ( メニュー) は、vcpkg Git リポジトリの現在のバージョンをチェックして、利用可能なパッケージの更新を確認します。

• リポジトリのアップグレード ( メニュー) は、vcpkg Git リポジトリの現在のバージョンで利用可能なパッケージの更新を確認し、インストールします。

• Vcpkg リポジトリの更新 ( メニュー) は、vcpkg Git リポジトリを最新バージョンに更新します。

リポジトリの自動更新

• ツールバーの をクリックし、IDE の再起動時にリポジトリを自動更新するを選択して、CLion が IDE を再起動するたびにリポジトリの更新をチェックできるようにします。

  

クイックフィックスを使用して不足しているパッケージを追加する

• まだインストールされていないパッケージのヘッダーを含めると、ファイルが見つからないというエラーでコンパイルが失敗します。エラーメッセージの横にある修復をクリックします。

  

  CLion は不足しているパッケージのインストールを提案します:

  

• インストールの候補が複数ある場合は、修復メニューからリストを開きます。

  

  ダイアログでインストールするパッケージを選択します。

  

システム CMake と Ninja の使用を強制する

プロファイル環境から vcpkg に CMake と Ninja を強制的に使用させることができます。

1. 左側のペインで「vcpkg の編集」ボタンをクリックします。

   

2. 詳細設定セクションを展開し、システムバイナリを使用するチェックボックスを設定します。