Qt Platform Abstraction

QPA (Qt 平台抽象) 是 Qt 中的主要平台抽象层。

API 可以被标识通过 QPlatform* 类前缀，且用于实现的更高级类，通常可找到在 Qt GUI ，如 QPlatformWindow 用于窗口系统集成，暴露透过 QWindow ，或 QPlatformTheme 用于深入平台主题及集成，暴露透过 QStyleHint 和 QStyle .

QPA 类同有源代码或二进制的兼容性保证，意味着 API 仅保证能工作于开发所针对的 Qt 版本。不管怎样，API 改变只在次要发行中进行 (如 5.1、5.2、依此类推)。

API 概述

窗口系统集成
- QPlatformIntegration
- QPlatformAccessibility
- QPlatformBackingStore
- QPlatformClipboard
- QPlatformCursor
- QPlatformDrag
- QPlatformFontDatabase
- QPlatformGraphicsBuffer
- QPlatformInputContext
- QPlatformOffscreenSurface
- QPlatformOpenGLContext
- QPlatformScreen
- QPlatformServices
- QPlatformSharedGraphicsCache
- QPlatformSurface
- QPlatformWindow
样式/主题
- QPlatformTheme
- platform palettes
- platform fonts
- theme hints
本机对话框和菜单
- QPlatformDialogHelper
- QPlatformMenu
- QPlatformMenuBar
- QPlatformMenuItem

注意： 除 QPA API 外，Qt 中还有很多其它平台抽象，例如：事件调度程序抽象在 Qt Core 及 RHI 中的渲染硬件抽象。QPA API 多半聚焦在窗口系统集成及相关支持上。

QPA 插件

上文列出的具体接口实现活在 QPA 插件或平台插件中，从而增加对 Qt 运行的各平台的支持。QPA 插件的实现是通过子类化 QPlatform* 类。

下表汇总了可用的平台插件：

插件名称	插件类名	描述
`qandroid`	QAndroidPlatformIntegration	Android 支持
`qbsdfb`	QBsdFbIntegration	BsdFb 支持
`qcocoa`	QCocoaIntegrationPlugin	macOS 支持
`qdirect2d`	QWindowsDirect2DIntegrationPlugin	类似于 `qwindows` 插件，但采用基于 Direct2D 的描绘引擎替换光栅描绘引擎为 QPixmap and QBackingStore .
`qdirectfb`	QDirectFbIntegrationPlugin	DirectFB 中心围绕 surfaces ，相当于 QPaintDevice .
`qeglfs`	QEglFSIntegrationPlugin	EGLFS 支持嵌入式 Linux 设备。
`qhaiku`	QHaikuIntegration	Haiku 支持
`qios`	QIOSIntegrationPlugin	iOS 支持
`qlinuxfb`	QLinuxFbIntegrationPlugin	LinuxFB 支持嵌入式 Linux 设备。
`qvnc`	QVncIntegration	VNC 支持
`qwayland`	QWaylandIntegrationPlugin QWaylandBrcmEglPlatformIntegrationPlugin QWaylandEglPlatformIntegrationPlugin QWaylandXCompositeEglPlatformIntegrationPlugin QWaylandXCompositeGlxPlatformIntegrationPlugin	Wayland 支持
`qwindows`	QWindowsIntegrationPlugin	Windows 支持
`qxcb`	QXcbIntegrationPlugin	X 窗口系统 (X11) 支持

选择 QPA 插件

Qt 将根据平台，选择默认 QPA 插件。 QT_QPA_PLATFORM 环境变量和 -platform 命令行自变量允许覆写此默认值。见 QGuiApplication 了解更多细节。

编写 QPA 插件

目前还没有编写 QPA 插件的详细教程文档编制。不管怎样，Qt 随附 2 个用于测试及其它特殊目的的最小插件，可以用作范例：

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

The qminimal 插件是工具用于链接到 Qt GUI ，但不要求窗口系统集成 (例如， qmlplugindump )。它还拥有诊断支持，可以通过环境变量确定把窗口内容转储到图像文件。