プラットフォームのデフォルト変数を定義するには、QMLプロジェクトの設定ファイルを作成する必要があります。

プラットフォームの移植先によっては、ボードやディスプレイの構成の違いに応じて、複数のBoardDefaults.qmlprojectconfig ファイルが存在する場合があります。これらすべての構成に対応するため、以下の命名規則を使用してください：

BoardDefaults_<color_depth>bpp<_default>.qmlprojectconfig

ここで：

• color_depth の値は、CMake変数QUL_COLOR_DEPTHに設定する必要があります。この値は、プラットフォームのcmake ディレクトリに複数のqmlprojectconfigファイルが存在する場合、利用可能な構成の中から適切なものを選択する際にも使用されます。
• 複数の構成がある場合は、そのうちの1つにdefault キーワードを指定して、デフォルトの構成を指定してください。

以下の表は、さまざまなシナリオの例と、それに対応する設定ファイル名を示しています。

以下に最小限の設定ファイルの例を示します。このファイルには、少なくとも使用するプラットフォーム向けのカラーフォーマットを指定する必要があります。

// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial

import QmlProject 1.2

Project {
    MCU.Config {
        platformAlphaPixelFormat: "ARGB8888"
        platformOpaquePixelFormat: "RGB565"
    }
}

これらに関する説明やその他のオプションについては、QmlProjectマニュアルを参照してください。