CLion 2024.1 ヘルプ

実行 / デバッグ構成

CLion は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。

実行 / デバッグ構成には 2 つのタイプがあります。

  • 一時的 — テスト、テストスイート、フィクスチャ、main() エントリを実行 / デバッグするたびに作成され、ガターアイコン / を使用します。

  • 永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除するまでプロジェクトの一部として残ります。

コードを実行 / デバッグまたはテストするときはいつでも、CLion は既存の永続的な実行 / デバッグ構成を使用するか、新しい一時的な構成を作成します。

永続的な構成のアイコンは不透明ですが、一時的な構成のアイコンは半透明です。構成アイコン上の赤い十字は、構成設定にエラーがあることを示します。

一時構成の最大数は 5 です。新しい構成が追加されると、古い構成は自動的に削除されます。必要に応じて、設定 | 詳細設定 | 実行 / デバッグ | 一時的な構成の制限でこの制限を増やすことができます。

Permanent and temporary configurations have different icons

永続的な実行 / デバッグ構成を作成する

CLion は、永続的な実行 / デバッグ構成を作成する次の方法を提供します。

一時的な構成を永続的なものとして保存する

  • 実行 / デバッグ構成スイッチャーで一時構成を選択し、 をクリックして、構成の保存を選択します。

    Saving a temporary configuration using the configuration switcher
  • または、実行 / デバッグ構成ダイアログで一時構成を選択し、ツールバーの Save をクリックします。

    Saving a temporary configuration

CLion は、さまざまな言語、ツール、フレームワーク用の実行 / デバッグ構成テンプレートを提供します。使用可能なテンプレートのリストは、インストールされているプラグインと有効になっているプラグインによって異なります。

テンプレートから実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成ダイアログで、ツールバーの をクリックするか、Alt+Insert を押します。リストには、実行 / デバッグ構成テンプレートが表示されます。

    New run/debug configuration
  3. 名前フィールドに実行 / デバッグ構成名を指定します。この名前は、使用可能な実行 / デバッグ構成のリストに表示されます。

  4. 構成の複数のインスタンスを同時に実行できるようにする場合は、複数のインスタンスを許可するを選択します。このオプションが無効になっている場合、構成を再実行しようとすると、アクティブなセッションが終了します。

  5. 選択したテンプレートに応じて、構成設定を入力します。例: CMake アプリケーションカスタムビルドアプリケーションGradle/Gradle ネイティブアプリケーション

  6. 起動前セクションで、アプリケーションを起動する前に特定のアクションを実行するかどうかを定義します。たとえば、実行前に外部ツールまたは別のビルド構成を起動します。ビルド段階をスキップするには、起動前リストからビルドを削除します。

  7. 構成をすぐに実行することも、構成を保存して後で実行することもできます。

    • OK をクリックして、後で使用するために実行構成を保存し、ダイアログを閉じます。

    • 構成をすぐに実行するには、「実行」をクリックします。

実行 / デバッグ構成を共有する

チームで作業している場合は、実行 / デバッグ構成を共有して、チームメイトが同じ構成を使用してアプリケーションを実行したり、実行中のプロセスにリモートで接続したりできるようにすることができます。

これらの目的のために、CLion は、実行 / デバッグ構成をプロジェクトファイルとして保存し、VCS を通じて共有するためのメカニズムを提供します。同じメカニズムは、構成をファイルとして他の人に送信する場合にも使用できます。これにより、実行 / デバッグ構成が洗練されることがあり、手動で同期を維持するのは面倒でエラーが発生しやすくなるため、多くの時間を節約できます。

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 共有する実行 / デバッグ構成を選択し、プロジェクトファイルとして保存オプションを有効にして、構成ファイルを保存する場所を指定します。

    CLion 2019.3 以前との互換性が必要でない限り、任意の場所を設定できます。これらのバージョンとの互換性を保つには、推奨される場所にファイルを保存してください。

    Store the configuration file
  3. (オプション) .idea ディレクトリが VCS 無視ファイルに追加された場合、.idea/runConfigurations サブフォルダーも無視されます。プロジェクトに Git を使用する場合は、.gitignore を次のように変更することで、.idea/runConfigurations のみを共有し、.idea を無視したままにすることができます。

    /.idea/* !/.idea/runConfigurations

実行 / デバッグ構成テンプレート

すべての実行 / デバッグ構成は、スタートアップロジックを実装し、パラメーターのリストとそのデフォルト値を定義するテンプレートに基づいています。使用可能なテンプレートのリストはインストールで事前定義されており、プラグインを介してのみ拡張できます。ただし、各テンプレートのデフォルトのパラメーター値を編集して、新しい実行 / デバッグ構成のセットアップを合理化することができます。

テンプレートのデフォルト値を構成する

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成ダイアログの左側のペインで、構成テンプレートの編集をクリックします。

  3. 開いた実行 / デバッグ構成テンプレートダイアログで、構成タイプを選択します。

  4. 必要なデフォルトパラメーターを指定し、OK をクリックしてテンプレートを保存します。

    Editing a configuration template

環境変数とプログラム引数

プログラム引数と環境変数を適切な実行 / デバッグ構成に追加することで、アプリの実行時の動作に影響を与えることができます。

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 開いた実行 / デバッグ構成ダイアログで、引数を渡す構成を選択し、環境変数を追加します。

  3. プログラム引数フィールドに引数を入力します。引数はスペースまたは改行で区切る必要があります。

    the Expand field icon 」をクリックしてテキストフィールドを展開すると、引数をリストとして表示および編集できます。

  4. 環境変数」フィールドに、変数名と値「 <name>=<value> 」を入力します。複数の変数を追加する場合は、セミコロンで区切る必要があります。

    または、the Environment variables icon をクリックして、変数名と値をユーザー環境変数リストに追加します。

    Adding environment variables

    開いたダイアログには、使用可能なシステム環境変数のリストも表示されます。選択した構成にシステム環境変数を使用しない場合は、システム環境変数チェックボックスをオフにします。

    $VAR$ 構文を使用して、親環境変数を含む既存の変数を参照できます。このような参照では大文字と小文字が区別されることに注意してください。たとえば、Linux/macOS の場合は PATH=xxx:$PATH$、Windows の場合は Path=xxx;$Path$ です。既存の変数の参照は、現在リモートツールチェーン (CPP-15693(英語)) では利用できません。

  5. ファイルから変数をロードするフィールドを使用して、CLion が環境を構成するスクリプトを指すようにします。このオプションは、CMakeMakefileGradle ネイティブカスタムビルド、テスト構成(Boost.TestCatchGoogle TestDoctestCTest)で使用できます。

    Loading environment variables from a file

    スクリプトで変数を設定するには、次の構文を使用します。

    set VAR=value

    export VAR=value

    スクリプトによって作成された環境は、対応する構成の 1 回の起動にのみ適用され、カスタム値よりも優先されることに注意してください。

    指定されたスクリプトは、すべての起動前ステップの後に実行されます。

実行 / デバッグ構成フォルダー

同じ種類の実行 / デバッグ構成が多数ある場合、フォルダーにグループ化すると、視覚的に区別しやすくなります。

グループ化すると、実行 / デバッグ構成が対応するフォルダーのリストに表示されます。

Grouped run configurations

実行 / デバッグ構成用のフォルダーを作成する

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成ダイアログで、構成タイプを選択し、ツールバーの the New Folder icon をクリックします。選択したタイプの新しい空のフォルダーが作成されます。

  3. 右側のテキストフィールドにフォルダー名を指定するか、デフォルトの名前を受け入れます。

  4. 目的の実行 / デバッグ構成を選択し、ターゲットフォルダーに移動します。

    Create run/debug configuration folders
  5. 変更を適用します。フォルダーが空の場合、保存されません。

フォルダーが不要になった場合は、Delete を削除できます。このフォルダーにグループ化された実行 / デバッグ構成は、対応する実行 / デバッグ構成タイプのルートに移動されます。

関連ページ:

実行 / デバッグ構成: CMake アプリケーション

この構成テンプレートを使用して、CMake ターゲットを実行またはデバッグします。共通設定:実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。名前実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。複数のインスタンスを許可するこの実行構成の複数のインスタンスを並行して実行できるようにします。デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、CLion は実行中の...

実行 / デバッグ構成: ネイティブアプリケーション

この構成テンプレートを使用して、Makefile および中間子アプリケーションを実行またはデバッグします。共通設定:実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。名前実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。複数のインスタンスを許可するこの実行構成の複数のインスタンスを並行して実行できるようにします。デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、...

カスタムビルドのターゲットとアプリケーション

カスタムビルドターゲットは、特定のビルドシステムやプロジェクトモデルに依存しません。CLion は、ソースのビルドとビルドアーティファクトのクリーニングに選択した外部ツールを使用します。カスタムターゲットは、compilation database プロジェクトで特に役立ちます。compile_commands.json 自体にはアプリケーションの構築と実行に必要な情報が不足していますが、カスタムターゲットとカスタム実行 / デバッグ構成はこの制限を回避できます。次の例では、compilation...

実行 / デバッグ構成ダイアログ

このダイアログを使用して、実行 / デバッグ構成を作成、編集、調整、削除したり、新しく作成されたすべての実行 / デバッグ構成に適用されるデフォルトのテンプレートを構成したりします。既存の実行 / デバッグ構成は、構成タイプごとにグループ化されています。新しい構成を作成するためのテンプレートは編集可能であり、ダイアログの左側のペインにある構成テンプレートの編集リンクから利用できます。共通設定:実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。名...

プラグイン

プラグインは CLion のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケットプレ...

クイック CMake チュートリアル

このチュートリアルでは、CLion で単純な CMake プロジェクトを作成および開発するプロセスを説明します。段階的に、ビルドシステムとしての CMake の基本と、CMake 固有の IDE 設定とアクションを学習します。1. シンプルな CMake プロジェクト:CMake は、CMakeLists と呼ばれるスクリプトを使用して、特定の環境用のビルドファイル (Unix マシンのメイクファイルなど) を生成するメタビルドシステムです。CLion で新しい CMake プロジェクトを作成すると、...