このトピックでは、新しいプラットフォームポートをインストールし、Qt Creator でそれを使用する方法について説明します。

これまでの移植ガイドでは、開発者向けビルドを行ってきました。これは、移植作業がまだ進行中の場合に実用的であり、アプリケーションに対して変更点を迅速にテストするのに役立ちます。

Qt Creator でこれを使用し、アプリケーションの開発を開始するには、プラットフォームポートを独立した場所にインストールしてください。

インストール済みビルド

プラットフォームビルドをインストールするには、開発者向けビルド用の CMake オプションに加えて、CMAKE_INSTALL_PREFIX オプションを使用します。以下の CMake コマンドでは、CMAKE_INSTALL_PREFIX を、ポートをインストールしたいパスに設定してください。

ホストツールは、このカスタムビルドのインストールには含まれていません。完全に使用可能なパッケージを得るためには、あらかじめ既存のQt Quick Ultraliteインストールを、カスタムインストール先にコピーしておく必要があります。

CMAKE_TOOLCHAIN_FILE およびQUL_TARGET_TOOLCHAIN_DIR の値は、開発者向けビルドと同じままにします。

cmake $QUL_ROOT -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=$QUL_TOOLCHAIN_FILE -DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain -DQUL_GENERATORS=$QUL_ROOT/lib/cmake/Qul/QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=~/dev/qul-example-platform
cmake --build .
cmake --build . --target install

cmake %QUL_ROOT% -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_TARGET_TOOLCHAIN_DIR=c:\path\to\the\toolchain -DQUL_GENERATORS=%QUL_ROOT%\lib\cmake\Qul\QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=C:\dev\qul-example-platform
cmake --build .
cmake --build . --target install

Qt Creator 統合

Qt Creator でビルドに使用するキットを作成するには、続行する前に Qt Creator のキットファイルを作成してください。

『Qt Creator マニュアル』の「MCU の接続」の項に記載されている手順に従って、MCU プラグインを使用してQt Creator の開発環境を設定してください。

Qt Creator 統合用のプラットフォームポートをビルドするには、次の 2 つの環境変数を設定してください：

• CMAKE_INSTALL_PREFIX Qt for MCUs のインストールディレクトリに設定します。これは、 の オプションで設定された のバージョンと一致している必要があります。Qt Creator Edit > Preferences > Devices > MCU Qt for MCUs
• QUL_VERSION を対応するバージョン番号に設定してください。たとえば、Qt Creator がC:\Qt\QtMCUs\<VERSION> を使用するように設定されている場合、<VERSION> は、使用しているQt Quick Ultraliteバージョン（例：2.12.2）が含まれるディレクトリです。

これらの変数を設定した後、以下のコマンドを使用してプラットフォームポートの設定とインストールを行ってください：

export QUL_VERSION=<VERSION>
cmake $QUL_ROOT -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=$QUL_TOOLCHAIN_FILE -DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain -DQUL_GENERATORS=$QUL_ROOT/lib/cmake/Qul/QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=~/dev/qul-example-platform -DQUL_VERSION=$QUL_VERSION -DQUL_BUILD_DEMOS=off -DQUL_BUILD_EXAMPLES=off
cmake --build .
cmake --build . --target install

set QUL_VERSION=<VERSION>
cmake %QUL_ROOT% -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_TARGET_TOOLCHAIN_DIR=c:\path\to\the\toolchain -DQUL_GENERATORS=%QUL_ROOT%\lib\cmake\Qul\QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=C:\dev\qul-example-platform -DQUL_VERSION=%QUL_VERSION% -DQUL_BUILD_DEMOS=off -DQUL_BUILD_EXAMPLES=off
cmake --build .
cmake --build . --target install

Qt Creator との統合には必要ないため、デモやサンプルコードのビルドを無効にすることができます。

Qt for MCUs の評価版を使用している場合、またはフレームワークを再ビルドしたくない場合は、前述のコマンドに以下のCMakeオプションを追加してください：

-DQul_ROOT=$QUL_ROOT -DQUL_BUILD_FRAMEWORK=OFF

-DQul_ROOT=%QUL_ROOT% -DQUL_BUILD_FRAMEWORK=OFF

インストールが完了したら、Qt Creator の「Edit > Preferences > Devices > MCU 」オプションを使用して、プラットフォームポート用のキットを作成してください。ターゲット用にすでにキットが設定されている場合は、新しいキットを作成する前に、そのキットを削除してください。

これで、Qt Creator 内で、お使いのプラットフォーム用のキットが使用可能になりました。Mcu Support Applicationプロジェクトを作成した場合は、この新しいキットを使用して、Qt Quick Ultralite アプリケーションを、お使いのプラットフォームライブラリに対してビルドおよびリンクしてください。

「フラッシュターゲットの作成」の説明に従ってフラッシュターゲットを設定済みであることを前提として、Qt Creator 内の「Run 」ボタンを押して、ターゲットハードウェア上でアプリケーションを実行します。