Abstracción de la Plataforma Qt

La Abstracción de Plataforma Qt (QPA) es la principal capa de abstracción de plataforma en Qt.

La API puede identificarse mediante el prefijo de clase QPlatform*, y se utiliza para implementar clases de nivel superior que suelen encontrarse en Qt GUIpor ejemplo, QPlatformWindow para la integración de sistemas de ventanas, expuesta a través de QWindow, o QPlatformTheme para una tematización e integración más profunda de la plataforma, expuesta a través de QStyleHint y QStyle.

No existen garantías de compatibilidad binaria o de código fuente para las clases QPA, lo que significa que sólo se garantiza que la API funcione con la versión de Qt con la que se desarrolló. No obstante, los cambios en la API sólo se realizarán en versiones menores. (5.1, 5.2, etc.)

Visión general de la API

• Integración del sistema de ventanas
  • QPlatformIntegration
  • QPlatformAccessibility
  • QPlatformBackingStore
  • QPlatformClipboard
  • QPlatformCursor
  • QPlatformDrag
  • QPlatformFontDatabase
  • QPlatformGraphicsBuffer
  • QPlatformInputContext
  • QPlatformOffscreenSurface
  • QPlatformOpenGLContext
  • QPlatformScreen
  • QPlatformServices
  • QPlatformSharedGraphicsCache
  • QPlatformSurface
  • QPlatformWindow
• Estilo/temática
  • QPlatformTheme
  • paletas de plataforma
  • fuentes de plataforma
  • sugerencias temáticas
• Diálogos y menús nativos
  • QPlatformDialogHelper
  • QPlatformMenu
  • QPlatformMenuBar
  • QPlatformMenuItem

Plugins QPA

Las implementaciones concretas de las interfaces enumeradas anteriormente se encuentran en los plugins QPA, o plugins de plataforma, que añaden soporte para las distintas plataformas en las que se ejecuta Qt. Los plugins QPA se implementan subclasificando las clases QPlatform*.

La siguiente tabla resume los plugins de plataforma disponibles:

Selección de un plugin QPA

Qt seleccionará un plugin QPA por defecto, dependiendo de la plataforma. La variable de entorno QT_QPA_PLATFORM y el argumento de línea de comandos -platform permiten anular este valor predeterminado. Ver QGuiApplication para más detalles.

Puede pasar una lista separada por punto y coma para instalar un plugin. En este caso, el instalador recorrerá los elementos de la lista e instalará el primer complemento disponible.

Ejemplo:

-qpa xcb;wayland

La línea anterior comprueba si el plugin xcb está disponible, si no lo está, busca el plugin wayland.

Escribir un complemento QPA

En este momento no hay documentación tutorial detallada para escribir plugins QPA. Sin embargo, hay dos plugins mínimos incluidos con Qt para pruebas y otros propósitos especiales que puedes usar como ejemplos:

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

El plugin qminimal se utiliza para herramientas que enlazan con Qt GUIpero que no requieren integración con el sistema de ventanas (por ejemplo, qmlplugindump). También tiene soporte de diagnóstico para volcar el contenido de las ventanas a archivos de imagen según lo determinen las variables de entorno.