このページでは

C

開発用ホストの設定

Qt for MCUs LinuxおよびWindowsのホスト環境に対応しています。以下の各サブセクションでは、これらのホストプラットフォームの設定方法について説明します。

前提条件

Qt for MCUs に加えて、以下の前提条件をインストールしてください。Qt for MCUs は、QtアカウントページからダウンロードできるQt Online Installer を使用してインストールできます。

  • CMake 3.21.1 以降(Qt Online Installer を使用してインストールできます)
  • GNU Make

デスクトップ上でアプリケーションをテストするためにデスクトップターゲットをビルドする場合:

  • GNU Compiler Collection v7.4.0 以降
  • 新しい Perl 互換正規表現ライブラリ - 16 ビット (libpcre2-16-0)

これらの前提条件はすべて、以下のコマンドを使用してインストールできます:

sudo apt update
sudo apt install build-essential cmake libpcre2-16-0
  • CMake 3.21.1 以降(Qt Online Installer を使用してインストールできます)

デスクトップ上でアプリケーションをテストするためにデスクトップターゲットをビルドする場合は:

注: Linux環境で g++-12 を含めずにgcc-12 をインストールした場合、qmlinterfacegenerator を実行すると、インクルードパス内の GCC ヘッダーが原因で C++ ヘッダーが見つからないというエラー('cstdint' file not found )が発生します。この問題を解決するには、gcc-12 を削除するか、g++-12 をインストールしてください。

Qt Creator セットアップ

以下の手順は、LinuxおよびWindowsプラットフォームでQt Creator を設定するのに役立ちます。

Qt Creator IDEを使用してMCU向けの開発を行うには、MCUプラグインが必要です。Qt for MCUs SDKをインストールすると、Qt Online Installer によってデフォルトで有効になります。

MCU上でアプリケーションをビルドして実行するには、キットを作成する必要があります:

  1. Edit > Preferences > Devices > MCU 」を選択します。

    注: 「MCU」タブが表示されない場合は 、「Help > About Plugins 」を選択し、「McuSupport」プラグインを有効にしてから、Qt Creator を再起動して変更を反映させてください。

  2. まだ設定されていない場合は、Qt for MCUs のインストールディレクトリへのパスを指定してください。

    Qt Creator での MCU 設定。

  3. [ Target supported by the Qt for MCUs SDKを選択してください。例: Qt for MCUs 2.12.2 - Desktop 32bpp
  4. Requirements 」セクションで、プラットフォーム固有の要件が満たされていることを確認してください。
  5. キットを自動的に作成するには、[Automatically create kits for all available targets on start ] を選択します。

    注: Create Kit 」および「Update Kit 」を使用して、キットを手動で作成または更新することもできます

  6. キットを自動的に作成する場合は、「Apply 」を選択し、「Qt Creator 」を再起動してください。

コマンドラインの設定

QUL_ROOT 以下のコマンドラインの例では、QUL_TOOLS が環境変数として設定されているかのように使用されています。例:

export QUL_ROOT=$HOME/Qt/QtMCUs/2.12.2
export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\2.12.2
set QUL_TOOLS=C:\Qt\Tools\QtMCUs

プロジェクトの設定

プロジェクトを設定するには、コマンドプロンプトからCMakeを実行します。プロジェクトディレクトリに移動し、以下のコマンドを入力してください。ここでは、%QUL_ROOT%\demos\thermo のデモを例として使用しています。

cd $QUL_ROOT/demos/thermo
mkdir build_linuxqt
cd build_linuxqt
cmake .. -DQUL_PLATFORM=Qt -DQul_ROOT=$QUL_ROOT
cd %QUL_ROOT%\demos\thermo
mkdir build_winqt
cd build_winqt
cmake .. -DQUL_PLATFORM=Qt -DQUL_COMPILER_NAME=msvc -DQul_ROOT=%QUL_ROOT%

注: CMakeのQUL_COMPILER_NAME オプションを使用することで、MSVC(msvc )とMinGW(gnu )のツールチェーンのいずれかを選択できます

MinGW ツールチェーンを使用するためにQUL_COMPILER_NAME=gnu という CMake オプションを指定する場合は、以下に示すように、Ninja またはMinGW Makefiles ジェネレータのいずれかを明示的に選択してください。これは、Visual Studio がインストールされている場合、CMake はデフォルトで Visual Studio ジェネレータを使用するため、この設定が必要となります。

cmake .. -G "Ninja" -DQUL_PLATFORM=Qt -DQUL_COMPILER_NAME=gnu -DQul_ROOT=%QUL_ROOT%

これらのコマンドは、前提条件を確認し、プロジェクトを設定します。

ビルド

ビルドするには、次のコマンドを使用してください:

cmake --build . --target thermo_big --config Release

注: Qtプラットフォーム用の事前ビルド済みライブラリは 、DebugおよびRelease構成でのみ利用可能です。Windowsでは、その他のビルドタイプを使用するとリンクエラーが発生する可能性があります。

アプリケーションの実行

サーモスタットアプリケーションのビルドが完了したら、実行してみてください:

./thermo_big

thermo のデモは、Windows用のQtアプリケーションとして構築されているため、実行するにはPATH に含まれるQtランタイムライブラリが必要です。Qt for MCUs には、これら必要なQtライブラリがすべて含まれており、これらをPATH に追加する必要があります。

set PATH=%QUL_ROOT%\lib\msvc;%PATH%
set QT_QPA_PLATFORM_PLUGIN_PATH=%QUL_ROOT%\lib\msvc

注: MinGWツールチェーン用のQt ランタイムライブラリは QUL_ROOT\lib\gnu にインストールされます。

PATHに必要なライブラリが追加されたので、アプリケーションを実行します:

%QUL_ROOT%\demos\thermo\build_winqt>Release\thermo_big.exe

注: MinGW ツールチェーンを使用している場合、実行ファイルはビルドディレクトリ内にあります

Thermostat アプリケーションのウィンドウは、次のようになります:

Linux上で動作するサーモスタットのデモアプリケーションで、温度制御のUIが表示されています。

Windows での Visual Studio のセットアップ

プロジェクトの設定

プロジェクトを設定するには、「コマンドラインでのセットアップ」セクションの手順に従ってください。

Visual Studio でソリューションを開く

Microsoft Visual Studio を使用してプロジェクトを操作するには、build_winqtフォルダ内にある CMake によって作成されたソリューションを開いてください。

Visual Studioのファイルブラウザが「build_winqt」フォルダを開いた状態で表示され、CMakeによって生成されたソリューションファイルが選択されています。

これで、ソリューションのツリー構造が表示されるはずです。

サーモスタットデモのプロジェクトツリー構造を表示している Visual Studio のソリューション エクスプローラー。

これは Windows 版 Qt プロジェクトであるため、実行には Qt のランタイムライブラリが必要です。ビルドされたアプリケーションでこれらを利用できるようにするには、ランタイム環境を設定する必要があります。その手順は次のとおりです。

  1. プロジェクトを選択して長押しするか、右クリックしてコンテキストメニューから「Properties 」を選択します。
  2. General > Debugging 」を選択します。
  3. Environment 」に、Qtライブラリが含まれるディレクトリを指すPATH およびQT_QPA_PLATFORM_PLUGIN_PATH 変数を追加します。Qtライブラリは、QUL_ROOTlib\msvc ディレクトリにインストールされています。例:
    PATH=%QUL_ROOT%\lib\msvc
    QT_QPA_PLATFORM_PLUGIN_PATH=%QUL_ROOT%\lib\msvc

この手順を完了すると(%QUL_ROOT% が C:\Qt\QtMCUs \2 .3.0 に設定されている場合)、プロジェクトのプロパティウィンドウは次のようになります:

PATH および QT_QPA_PLATFORM_PLUGIN_PATH 環境変数が設定された Visual Studio のプロジェクトのプロパティウィンドウ。

ビルドと実行

変更を適用し、アプリケーションをビルドして実行します。画面にサーモスタットのデモが表示されるはずです。

特定のQtライセンスの下で利用可能です。
詳細はこちら。