プロジェクトを開く

プロジェクトを開くには、そのプロジェクトの設定ファイルを開きます：

• CMakeLists.txt またはCMakeCache.txt （CMake）
• .pro (qmake)
• .qbs (Qbs)
• meson.build (Meson)
• pyproject.toml (Python)
• BUILD.gn (Ninjaの生成 (GN))
• Makefile.am (Autotools、実験的)

一部サポートされているプロジェクトの種類

一部のプロジェクトタイプはサポートが限定的です。それらを開くには、対応する拡張機能を有効にしてください。Qt Creator では、プロジェクトを初めて開く際に、必要な拡張機能を提案します。

部分的にサポートされているプロジェクトを開くには、そのプロジェクトの設定ファイルを開いてください:

• build.xml (Ant)
• cargo.toml (Cargo)
• .csproj (.NET/C#)
• .gradle または.gradle.kts (Gradle)
• Package.swift (Swift)

これらのプロジェクトをビルドおよび実行するには、Qt Creator が自動的に作成するカスタム設定を使用するか、独自のビルドおよび実行設定を設定するか、Qt Creator 以外の場合と同じようにターミナルを使用してください。

プロジェクトファイルを開く

プロジェクトは、以下の方法で開くことができます。

• 「File 」 > 「Open Project 」を選択します。
• 「Welcome 」モードの「Projects 」タブで、「Open Project 」（1）を選択します。

  

• 「Projects 」タブで、最近開いたプロジェクトのリストからプロジェクトを選択します（2）。
• Welcome モードの [Overview ] タブで、[Recent Projects] から最近開いたプロジェクトを選択します。
• 「Projects」ビューで右クリックしてコンテキストメニューを開き、「Load Project 」を選択して「Open Project 」ダイアログを開き、そこでプロジェクトファイルを選択します。

  

• 現在選択されているモードに応じて、以下のキーボードショートカットを使用します。
  • すべてのモードで、Ctrl+O（macOS ではCmd+O）を押して「Open File 」ダイアログを開き、プロジェクトファイルを選択します。
  • Windows および Linux では、「Help 」モードを除くすべてのモードで、Ctrl+Shift+Oを押すと「Open Project 」ダイアログが開き、プロジェクトファイルを選択できます。
  • 「Welcome 」モードの「Projects 」タブでは、Ctrl+Shift+数字（macOSではCmd+Shift+数字）を押します。ここで、数字は最近開いたプロジェクトのリスト（3）にあるプロジェクトの番号です。

ディレクトリをプロジェクトとして開く

ディレクトリをプロジェクトとして開くには、[File ] > [Open Workspace] を選択します。

Qt Creator はデフォルトのキットを使用して、ワークスペースのビルド構成を自動的に追加します。プロジェクト名やファイル除外フィルターを設定するためのディレクトリ内に、.qtcreator/project.json プロジェクトファイルを生成します。このファイルには、JSONスキーマで定義されているとおりに、ビルドおよび実行設定を追加できます。

次回プロジェクトを開く際には、JSONファイルまたはワークスペースのいずれかを開くことができます。

ディレクトリにファイルを追加したり、そこからファイルを削除したりすると、「プロジェクト」ビューの内容が自動的に更新されます。

ワークスペースにビルド構成を追加するには：

1. [Projects ] > [Build Settings] に移動します。
2. 「Add 」>「Build 」を選択します。
3. ビルド設定を指定します。

ワークスペースのデプロイ設定を指定するには、[Projects ] > [Deploy Settings] に移動します。

ワークスペースの実行設定を指定するには、[Projects ] > [Run Settings] に移動します。

プロジェクトの再構成

Qt Creator は、プロジェクトをビルドするために必要な情報を.user ファイルに保存します。既存のプロジェクトを開いたときにQt Creator がそのファイルを見つけられない場合、情報の入力を求められます。

別のQt Creator インスタンスを使用してプロジェクトを作成した場合、Qt Creator は古い設定を使用するかどうかを尋ねます。設定は開発環境ごとに固有のものであるため、ある環境から別の環境へコピーすべきではありません。したがって、「No 」を選択し、「Configure Project 」タブで情報を再度入力することをお勧めします。

プロジェクトの設定を再構成するには：

1. 「Configure Project 」で、プロジェクトのビルドおよび実行に使用するキットを選択します。

   

2. 各キットについて、プロジェクト用に作成するビルド構成を選択します。
3. 「Configure Project 」を選択します。

Configure Project には、コンピュータにインストールされ、「Preferences 」>「Kits 」で設定されたキットのリストが表示されます。

プロジェクトをビルドする予定がない場合でも、C++ および QML コードモデルでは、コード補完機能を利用するために Qt のバージョンとコンパイラが必要です。これらを指定するには、[Preferences ] リンクを選択するか、[Preferences ] > [Kits] を選択します。

Qt for Python プロジェクトは、コード補完、ハイライト表示、その他の便利な機能を実現するために、言語サーバークライアントに依存しています。

Qt Creator が特定のキットに対する既存のビルドを見つけられない場合、ゼロから開始し、指定されたディレクトリに新しいデバッグおよびリリースビルド構成を作成します。「Qt Creator 」では、ディレクトリの名前と場所が提案されますが、これらは変更可能です。

ビルドのインポート

以前にそのプロジェクトをビルドしたことがある場合、Qt Creator は既存のビルド構成を使用して、まったく同じビルドを利用できるようにすることができます。ビルドをインポートするには、[Configure Project ] タブの [Import Build From ] セクションでディレクトリを指定し、[Import] を選択します。

ビルド構成は後で編集できます。詳細については、「ビルド構成の編集」を参照してください。

進行状況情報の表示

Qt Creator は、プロジェクト内のすべてのソースファイルを解析し、セマンティック解析を実行して、ナビゲーションや使用箇所の検索などの機能に必要な情報を構築します。解析中は進行状況バーが表示されます。

詳細な進行状況情報を表示または非表示にするには、[Toggle Progress Details ] (1) を選択します。

進行状況バーは別の位置にドラッグして移動できます。その位置は後で再利用できるよう保存されます。「 」（Pin ）を選択すると、進行状況バーをトグルボタンに固定できます。