Qt バージョンの追加

開発用 PC に複数のバージョンの Qt をインストールし、プロジェクトのビルドに使用することができます。例えば、デバイスメーカーは、デバイス用のアプリケーションを開発するための特別な Qt バージョンを提供しています。

インストールされている Qt のバージョンを表示するには、[Preferences] > [Kits ] > [Qt Versions] を選択します。

各 Qt バージョンの詳細情報を表示するには、リストで Qt バージョンを選択し、Qt version for セクションでDetails を選択します。

無効な Qt バージョンを削除するには、Clean Up を選択します。

インストールされた Qt バージョンの登録

インストールされた Qt にリンクすることができます。 Qt Online Installerにリンクして、インストールされている Qt のバージョンを自動的に検出することができます。ただし、Linux ディストリビューションや macOS の brew、Windows の Chocolatey など、システムが他のパッケージマネージャでインストールした Qt や、自作の Qt にはリンクできません。そのような場合は、Qt Versions タブでAdd を選択し、Set up new Qt versions で説明されているように、Qt のバージョンを手動で追加してください。

Qt インストールにリンクするには

1. 環境設定>Kits >Qt Versions >Link with Qt を選択します。

   

2. Qt installation path フィールドに、Qt をインストールしたディレクトリへのパスを入力します。
3. Qt インストール・ディレクトリに Qt のバージョンとキットを自動的に登録するには、Link with Qt を選択します。
4. Qt Creator を再起動するにはRestart Now を選択します。

自動的に検出された Qt バージョンをリストから削除するには、Remove Link を選択します。

Qt Versions タブで Qt バージョンがAuto-detected の下に表示されない場合は、手動で設定してください。

プロジェクトのビルドと実行に使用する Qt のバージョンは、[環境設定] > [Kits] でキットごとに指定します。

新しい Qt バージョンの設定

Qt バージョンを登録するには、その Qt バージョンの qmake またはqtpaths 実行ファイルを含むディレクトリへのパスを設定します。

Qt バージョンを追加するには

1. Preferences>Kits >Qt Versions >Add を選択してください。

   リモート Linux デバイスまたは Docker で Qt バージョンを追加するには、Shift を選択し、Add を選択します。

2. 追加する Qt バージョンの qmake またはqtpaths 実行ファイルを選択します。
3. Qt バージョンを選択して、表示および編集します。
4. Name フィールドで、Qt Creator が提案する Qt バージョンの名前を編集します。
5. qmake path フィールドでは、qmake またはqtpaths の場所を変更できます。
6. Qt バージョンが QNX 用の場合は、QNX SDK フィールドに QNX SDK へのパスを入力します。

手動で追加した Qt バージョンを削除するには、Manual リストでその Qt バージョンを選択し、Remove を選択します。

ドキュメントの登録

デフォルトでは、Qt Creator は、インストールされている各 Qt モジュールのドキュメンテーションのうち、利用可能な最新バージョンのみを登録します。

インストールされている Qt の全バージョンのドキュメントを登録するには、Register documentation リストからAll を選択します。Qt ドキュメントをまったく登録しない場合は、None を選択してください。デフォルトの動作はHighest Version Only です。

Qt インストールのトラブルシューティング

Qt Creator が Qt バージョンのインストールで問題を検出した場合、リストの Qt バージョン名の横に警告とエラーが表示されます。Qt のバージョンを選択すると、問題の詳細と解決方法が表示されます。

特定の Qt バージョンがインストールされていることを確認するために、Qt Creator はqmake -query を呼び出し、出力で参照されているディレクトリが存在することを確認します。Qt Online Installer を使用して Qt をインストールした場合は、Qt Maintenance Tool を実行して、アップデートの確認や Qt バージョンの再インストールを行ってください。

自作の Qt バージョン

自作の Qt バージョンでプロジェクトをビルドするには、「新しい Qt バージョンのセットアップ」の説明に従って追加します。

Qt は以下の最小要件を満たしている必要があります：

• qmake は-query コマンドライン引数を理解する実行ファイルです。
• bin とinclude ディレクトリが存在する必要があります。Qt Creator はqmake -query を実行することでこれらのディレクトリを取得します。

Qt バージョンのキットを追加し、CMake 用に設定します。

Qt Creator がない場合は警告が表示されます：

• libQtCore.so が見つからない場合、Qt Creator は ABI を検出できません。
• toolchain.cmake が欠落している場合に警告を表示します。例えば、x86 プラットフォーム用に-static オプションを使用して Qt をビルドしたとします。

以下を試してください：

• ビルドディレクトリでmake install を実行して、Qt を設定された場所にインストールします。
• Preferences>Kits >Kits >CMake Configuration のCMAKE_PREFIX_PATH 変数の値を Qt をインストールした場所に設定します。