このガイドでは、移植の手順を説明するために、サンプル・プラットフォーム（example-baremetal ）を使用します。このサンプル・プラットフォームをベースにプラットフォームの移植を作成することも、ゼロから作成することもできます。

Qt Quick Ultraliteプラットフォーム移植プロジェクトのセットアップ

Qt Quick Ultraliteは、サポートするすべてのプラットフォームをplatform\boards ディレクトリの下に置いており、プラットフォームの製造者名に基づいて分類されています。例えば、example-baremetal プラットフォームポートの製造元は qt で、ポートはplatform\boards\qt\example-baremetal から見つけることができます。

変数BOARD_MANUFACTURER_NAME はCMakeで自動的に設定され、ボードが見つかった製造元フォルダーの名前が格納されます。

Qt Quick UltraliteのCMakeスクリプトからプラットフォームを見えるようにするには、プラットフォーム用の新しいディレクトリを作成します：

mkdir -p platform/boards/<MANUFACTURER_NAME>/<YOUR_PLATFORM>

md platform\boards\<MANUFACTURER_NAME>\<YOUR_PLATFORM>

<MANUFACTURER_NAME> と<YOUR_PLATFORM> は、問題を避けるために小文字の名前にします。

プロジェクトの構成

Qt Quick Ultraliteは、このガイドに従って作成する特定のプロジェクト構造を持つことを要求します。

• 📁 <メーカー名>.
  • 🗎 CMakeLists.txt
  • 📁 <あなたのプラットフォーム
    • 🗎 CMakeLists.txt
    • 📁 cmake
      • 📁 <あなたのコンパイラ
        • 🗎 <あなたのリンカー・スクリプト
      • 🗎 BoardArchitectureConfigure.cmake
      • 🗎 BoardDefaults.qmlprojectconfig
      • 🗎 BSPConfig.cmake (オプション)
      • 🗎 LinkerScriptConfig.cmake (オプション)
      • 🗎 ExecutableHook.cmake (オプション)

上に示したように、プラットフォーム用のデフォルト変数を定義する設定ファイルがいくつかある：

• BoardDefaults.qmlprojectconfig ターゲット・ボード用のQt Quick Ultralite エンジン固有のコンフィギュレーション。
• BoardArchitectureConfig.cmake プラットフォーム・アーキテクチャに関する情報が含まれています。
• LinkerScriptConfig.cmake リンカ・スクリプトのコンフィギュレーションが含まれています。
• プラットフォーム固有のビルド・システム設定はCMakeLists.txt

製造元 CMakeLists.txt

<MANUFACTURER_NAME>フォルダーの下に、少なくとも以下の内容のCMakeLists.txt ファイルを追加します：

include(CMakeDependentOption)
add_subdirectory(${CMAKE_CURRENT_LIST_DIR}/${QUL_PLATFORM})

cmake ディレクトリ

Qt Quick Ultraliteがプラットフォームを認識してコンパイルできるように、プロジェクトにはコンパイラとボード情報を含むplatform\<BOARD_MANUFACTURER_NAME>\<YOUR_PLATFORM>\cmake ディレクトリが必要です。platform\boards\qt\example-baremetal\cmake ディレクトリをプラットフォームの cmake ディレクトリのベースとして使用することができます。

cmake ディレクトリにある必要なファイルは、上のディレクトリ構造に示されています。

example-baremetal プロジェクトのcmake ディレクトリには、ARM GCC コンパイラと IAR コンパイラのコンフィギュレーションが含まれています。ARM GCC、Green Hills for V850またはARM、IAR for ARMコンパイラ以外のコンパイラを使用する場合は、追加のコンフィギュレーションが必要です。詳細については、カスタムツールチェインの使用を参照してください。

CPUアーキテクチャの設定

Qt Quick Ultraliteには、サポートされている利用可能なCPUアーキテクチャのセットが付属しています。リストはplatform/architecture/ 、最も一般的なCortex-Mアーキテクチャが含まれています。

デフォルトのアーキテクチャの1つを使用するには、<MANUFACTURER_NAME>/<YOUR_PLATFORM>/BoardArchitectureConfig.cmake ：

# Copyright (C) 2025 The Qt Company Ltd.
# SPDX-License-Identifier: LicenseRef-Qt-Commercial
set (QUL_PLATFORM_ARCHITECTURE "cortex-m7-hf-fpv5-d16")

それ以外のカスタム・アーキテクチャが必要な場合は、<YOUR_COMPILER> フォルダに独自のアーキテクチャを作成する方法について、Using custom architecturesを参照してください。

set(QUL_PLATFORM_ARCHITECTURE SomeCustomName)
set(QUL_PLATFORM_ARCHITECTURE_FILE "${CMAKE_CURRENT_LIST_DIR}/${QUL_COMPILER_NAME}/architecture.cmake")