このトピックでは、新しいプラットフォーム・ポートをインストールし、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 Manual > Connecting MCUsのトピックで説明されているように、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.1）を含むディレクトリです。

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

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 CreatorMcu Support Applicationプロジェクトを作成した場合は、新しいキットを使用してQt Quick Ultralite アプリケーションをビルドし、プラットフォーム・ライブラリにリンクします。

フラッシュ・ターゲットの作成で説明したようにフラッシュ・ターゲットをセットアップしたと仮定して、Qt Creator のRun ボタンを押してターゲット・ハードウェア上でアプリケーションを実行してください。