Qtバージョンの追加

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

インストール済みの Qt XML バージョンを確認するには、[Preferences ] > [Kits ] > [Qt Versions] の順に選択します。

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

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

インストール済みの Qt バージョンを登録する

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

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

1. 「Preferences 」 > 「Kits 」 > 「Qt Versions 」 > 「Link with Qt 」の順に選択します。

   

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

自動的に検出された Qt バージョンのリストを更新するには、[Re-detect] を選択します。

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

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

各キットでプロジェクトのビルドおよび実行に使用する Qt バージョンは、[Preferences ] > [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 ] リストでそのバージョンを選択し、[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 をインストールした場所に設定します。