Qtプラットフォーム抽象化

Qt Platform Abstraction（QPA）は、Qtにおける主要なプラットフォーム抽象化レイヤーです。

この API は「QPlatform* 」というクラス接頭辞で識別でき、通常は次のような高レベルのクラスを実装するために使用されます Qt GUI。例えば、QWindow を通じて公開されるウィンドウシステム統合のためのQPlatformWindow や、QStyleHintおよびQStyle を通じて公開される、より詳細なプラットフォームのテーマ設定や統合のためのQPlatformTheme などです。

QPA クラスについては、ソースおよびバイナリの互換性は保証されていません。つまり、API は、その開発元となった Qt バージョンでのみ動作が保証されます。ただし、API の変更はマイナーリリース（5.1、5.2 など）でのみ行われます。

APIの概要

• ウィンドウシステムとの統合
  • QPlatformIntegration
  • QPlatformAccessibility
  • QPlatformBackingStore
  • QPlatformClipboard
  • QPlatformカーソル
  • QPlatformDrag
  • QPlatformFontDatabase
  • QPlatformGraphicsBuffer
  • QPlatformInputContext
  • QPlatformOffscreenSurface
  • QPlatformOpenGLContext
  • QPlatformScreen
  • QPlatformServices
  • QPlatformSharedGraphicsCache
  • QPlatformSurface
  • QPlatformWindow
• スタイル／テーマ設定
  • QPlatformTheme
  • プラットフォームのパレット
  • プラットフォームフォント
  • テーマのヒント
• ネイティブのダイアログとメニュー
  • QPlatformDialogHelper
  • QPlatformMenu
  • QPlatformMenuBar
  • QPlatformMenuItem

QPA プラグイン

上記に挙げたインターフェースの具体的な実装は、QPAプラグイン（またはプラットフォームプラグイン）に存在し、Qtが動作するさまざまなプラットフォームへのサポートを追加します。QPAプラグインは、QPlatform* クラスをサブクラス化することで実装されます。

利用可能なプラットフォームプラグインの概要は、次の表にまとめられています：

QPAプラグインの選択

Qtは、プラットフォームに応じてデフォルトのQPAプラグインを選択します。環境変数QT_QPA_PLATFORM およびコマンドライン引数-platform を使用することで、このデフォルト設定を上書きできます。詳細については、QGuiApplication を参照してください。

プラグインをインストールするには、セミコロンで区切られたリストを指定できます。この場合、インストーラはリスト内の項目を順に確認し、利用可能な最初のプラグインをインストールします。

例：

-qpa xcb;wayland

上記の行は、xcb プラグインが利用可能かどうかを確認し、利用できない場合はwaylandプラグインの有無を確認します。

QPAプラグインの作成

現時点では、QPAプラグインの作成に関する詳細なチュートリアルドキュメントは存在しません。ただし、テストやその他の特別な目的のためにQtに同梱されている2つの最小限のプラグインがあり、これらを例として利用できます:

• qtbase/src/plugins/platforms/minimal/
• qtbase/src/plugins/platforms/minimalegl/

qminimal プラグインは、 Qt GUIに対してリンクされるが、ウィンドウシステムとの統合を必要としないツール（例：qmlplugindump ）に使用されます。また、環境変数によって指定された通りにウィンドウの内容を画像ファイルにダンプする診断機能も備えています。