CLion 2019.3ヘルプ

プロジェクト

CLionで何をしても、プロジェクトのコンテキストでそれを行います。プロジェクトは、完全なソフトウェアソリューションを表す組織単位です。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基盤として機能します。

CLionは、CMake、JSONコンパイルデータベース、Gradleの3つのプロジェクトフォーマットをサポートしています(詳細はプロジェクト・フォーマットを参照)。

プロジェクト・ファイル

CLionのプロジェクトはディレクトリーベースのフォーマットで表されます。プロジェクトディレクトリーには、.idea ディレクトリー(プロジェクトツールウィンドウのプロジェクトビューには表示されません)と次のファイルが含まれています。

  • プロジェクト構造を記述する.iml ファイル。

  • workspace.xml ファイルを開きます。

  • 多数の xml ファイル。各 xml ファイルは、projectCodeStyle.xml , encodings.xml , vcs.xmlという名前で認識できる、独自の設定セットを担当します。

    たとえば、新しい実行/デバッグ設定を追加してエンコーディングを変更すると、2つの異なる xml ファイルに影響します。これにより、プロジェクト設定がバージョン管理システムに格納され、異なるチームメンバーによって変更されたときのマージの競合を回避できます。

ローカル設定を保存する workspace.xmlを除いて、.idea ディレクトリー内の設定ファイルはすべてバージョン管理下に置く必要があります。 workspace.xml ファイルは、VCSによって無視されるものとしてマークする必要があります。

プロジェクト・ルート・ディレクトリー

CLion内のプロジェクトは、プロジェクトディレクトリー内にカプセル化されている必要があります。プロジェクトディレクトリーには、プロジェクトルートディレクトリーと呼ばれるルートディレクトリーがあり、プロジェクトに関連する設定、データ、ソース、その他のファイルを含むすべてのプロジェクトファイルとサブディレクトリー。

プロジェクトルートディレクトリーには、プロジェクト記述の1つ以上のファイル(CMakeまたはGradleの場合はビルドシステムへの入力でもあります)が含まれます。CMakeの場合はCMakeLists.txt、Gradleの場合は build.gradle、compilation databaseの場合は compile_commands.json です。

パス変数

パス変数は、プロジェクトにリンクされたリソースへのパスを表すプレースホルダーです。コンピューター上の固定された場所を参照する必要がないため、共有の柔軟性が提供されます。

パス変数は、たとえば、プロジェクトまたはモジュールレベルで定義されたサードパーティライブラリーがあり、プロジェクトディレクトリーまたはモジュールコンテンツ・ルート(VCSを介して共有されるプロジェクト用)の外部に保存されている場合に役立ちます。このようなライブラリーはその絶対パスによって参照され、このパスがチームメイトのコンピューター上で同じであるという保証はありません。パス変数を使用する場合、各コンピューター上で各変数が個別に構成されるため、パスを相対にします。

CLionにはいくつかの事前定義された変数があります:

  • $USER_HOME$ : ホームディレクトリーを表します。

  • $PROJECT_DIR$ : プロジェクトが保存されているディレクトリーを表します。

  • $MODULE_DIR$ : モジュール設定ファイル IMLを保持するディレクトリーを表します。

パス変数を構成するには、設定/環境設定ダイアログ Ctrl+Alt+S外観 & 振る舞い | パス変数を選択します。

Path Variables dialog

サンプル: 新しいパス変数を作成する

例:プロジェクトディレクトリーに保存されていないサードパーティのライブラリーがあります。VCSからプロジェクトを更新した後にチームメイトのコンピューターでパスが正しいことを確認したい場合は、新しい変数を作成することができます。

  1. 設定/環境設定ダイアログ Ctrl+Alt+S外観 & 振る舞い | パス変数を選択し、Add ボタンをクリックします。

  2. 新しい変数の名前(たとえば、PATH_TO_LIB)と、ディスク上のライブラリーの場所を示す値を入力します。

  3. IML ファイルをバージョン管理システムで共有します。

  4. チームメイトがVCSからプロジェクトをアップデートした後、PATH_TO_LIB の変数値がコンピューター上のライブラリーの場所を指すように変更されます。

パス変数を無視する

プロジェクトを開くと、CLionは未解決のパス変数があるかどうかを確認します。IDEが何かを検出すると、それらの値を定義するように求められます。何らかの理由でこれを行いたくない場合(たとえば、未解決のパス変数を持つファイルまたはディレクトリーを使用しない場合)、無視される変数のリストに追加できます。

たとえば、実行/デバッグ構成でJVMに渡されるプログラム・パラメーターが内部 ($SOME_STRING$) パス変数と同じ形式である場合は、無視される変数のリストを使用することもできます。この場合、混乱を避けるために、無視された変数のリストにこのパラメータを追加することができます。パス変数ダイアログの無視される変数フィールドに SOME_STRING と入力します。

最終更新日: 2019年12月6日

関連ページ:

プロジェクト・フォーマット

CLionには、インクルードファイル、コンパイラフラグ、リンカオプションなど、多くのプロジェクトレベルの情報に依存する一連のスマート機能が組み込まれています。これらの詳細により、CLionは解析/解決を正しく実行し、エラーのない便利な方法でコードのハイライト、自動補完、インスペクション、ナビゲートを...

プロジェクトツールウィンドウ

このツールウィンドウを使用すると、プロジェクトをさまざまな観点から見て、新しい項目(ディレクトリー、ファイル、クラスなど)の作成、エディターでのファイルの開き、目的のコードフラグメントへの移動などのタスクを実行できます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニュー...

バージョン管理を有効にする

CLionは2つのレベルでバージョン管理統合をサポートします。IDEレベルでは、デフォルトで有効になっているバンドルされたプラグインのセットによってVCS統合が提供されます。プロジェクトレベルでは、プロジェクトフォルダーを1つまたは複数のバージョン管理システムと関連付けることで、VCS統合が有効にな...

CMakeLists.txt

CMakeLists.txtファイルには、プロジェクトのソースファイルとターゲット(実行可能ファイル、ライブラリー、またはその両方)を記述する指示文と命令のセットが含まれています。新しいプロジェクトを作成すると、CLionは自動的にCMakeLists.txtファイルを生成してプロジェクトのルートデ...