En esta página

Requisitos del entorno de ejecución de Qt para QNX

QNX Software Systems ofrece soluciones de software para la fabricación de dispositivos embebidos. Esto incluye la creación de imágenes de arranque del sistema operativo en tiempo real (RTOS) QNX Neutrino de forma muy flexible. Aunque QNX proporciona varios scripts de referencia para la creación de imágenes del sistema operativo, tarde o temprano tendrás que realizar cambios o quizá decidas crear una imagen del sistema operativo desde cero. Qt depende de la existencia de varios componentes de terceros y de determinados servicios del sistema operativo. Por este motivo, las imágenes de arranque del sistema operativo en tiempo real (RTOS) QNX Neutrino para un dispositivo de destino que ejecute Qt deben cumplir los requisitos enumerados en las siguientes secciones para garantizar que Qt funcione según lo esperado.

Subsistema de gráficos de pantalla de QNX

Antes de que se pueda iniciar cualquier aplicación Qt, el subsistema de gráficos de pantalla de QNX (también denominado simplemente «Screen») debe estar en ejecución. Screen consta de un controlador y varias utilidades y servicios que utiliza Qt. Esto incluye también el procesamiento de eventos del ratón y del teclado. Puede asegurarse de que Screen está configurado y funciona correctamente comprobando que una aplicación gráfica, como gles2-gears, se pueda iniciar y funcione sin problemas.

La mayoría de los scripts de compilación de sistemas operativos de muestra recientes del SDP incluyen secciones con todos los componentes y los comandos de inicio para Screen. Puedes utilizarlos como referencia.

Vulkan

Si utiliza el renderizado Vulkan, la imagen de destino debe proporcionar un cargador de Vulkan (libvulkan.so) y un controlador gráfico de Screen que implemente la extensión VK_QNX_screen_surface. Para obtener más información, consulte las API de renderizado de Vulkan.

Compatibilidad con IPv6

La pila de red de Qt Network requiere que la compatibilidad con IPv6 esté habilitada, independientemente de si la red real utiliza IPv4 o IPv6.

Advertencia: debe estar en ejecuciónio-pkt-v6-hc, no io-pkt-v4.

Dispositivo aleatorio /dev/random

Qt requiere que /dev/random esté presente y sea funcional. Inícialo antes de iniciar cualquier aplicación Qt o durante el arranque del sistema:

random -p
waitfor /dev/random

Registrador del sistema

QNX proporciona el marco de registro «slog2», adaptado a las características específicas de los sistemas embebidos. Su principal ventaja es un rendimiento mucho mejor que el de la salida de texto a archivos. Qt utiliza este marco de forma predeterminada para cualquier salida de registro que pase por QDebug en el sistema operativo en tiempo real QNX Neutrino. El servicio slog2 debe iniciarse durante el arranque del sistema. El servicio « slog2 » también depende de la existencia de la carpeta « /tmp », que también debe configurarse, por ejemplo:

[type=link] /tmp=/dev/shmem
display_msg "Starting slogger2..."
slogger2 -U1001:1000 &
waitfor /dev/slog2

Variables de entorno

Hay un conjunto de variables de entorno que debes configurar al iniciar una aplicación Qt. La mayoría de ellas, en realidad, no son específicas del sistema operativo en tiempo real QNX Neutrino. No obstante, se mencionan aquí, ya que conocerlas ahorra mucho tiempo en caso de que surjan problemas.

Nota: Se requierensetconf y getconf para acceder a las variables de entorno POSIX, especialmente para el nombre del host y la fecha y la hora.

Ubicación del tiempo de ejecución de Qt

Si no has compilado Qt con la variable de entorno RPATH configurada, puedes colocar los componentes de tiempo de ejecución de Qt en cualquier carpeta del sistema de archivos. Las siguientes variables de entorno deben apuntar a ubicaciones válidas, suponiendo que la instalación de Qt se encuentre en <Qt-install-path>:

  • LD_LIBRARY_PATH debe contener la ruta a las bibliotecas de Qt en <Qt-install-path>/lib.
  • QT_PLUGIN_PATH define dónde se encuentran los complementos de Qt. Debe establecerse en <Qt-install-path>/plugins.
  • QML2_IMPORT_PATH define dónde se encuentran los complementos de Qt Quick. Debe establecerse en <Qt-install-path>/qml.
  • Si Qt no utiliza fontconfig, debe proporcionar la ruta a las fuentes con QT_QPA_FONTDIR, o bien colocar las fuentes en <Qt-install-path>/lib/fonts, que es la ubicación predeterminada de las fuentes.
  • Comprueba QT_QPA_QNX_DISPLAY_CONFIG para ver el número y el orden de las pantallas disponibles.

Tamaño físico de la pantalla

Qt necesita información sobre las dimensiones físicas de la pantalla conectada para determinar los valores de DPI y, de este modo, establecer los tamaños de fuente correctos. Normalmente, esta información la proporciona la pantalla. En algunos casos, es posible que se muestre un tamaño de pantalla no válido, como 0 mm x 0 mm. En tal caso, Qt requiere que la variable de entorno ` QQNX_PHYSICAL_SCREEN_SIZE ` se establezca en los valores correspondientes para obtener la información necesaria. Si las aplicaciones de Qt se cierran con un mensaje de error indicando que no se ha podido determinar el tamaño físico de la pantalla, configura la variable de la siguiente manera antes de iniciar la aplicación de Qt:

export QQNX_PHYSICAL_SCREEN_SIZE=150,100

para indicar a Qt que, en este caso concreto, la pantalla tiene una anchura de 150 mm y una altura de 100 mm. El tamaño físico de la pantalla se mide en milímetros (mm) y debe corresponder al tamaño físico real de la pantalla en la configuración final.

Solución de problemas en el primer inicio de una aplicación Qt

El único inconveniente de la flexibilidad que ofrece el sistema operativo en tiempo real (RTOS) QNX Neutrino es el riesgo de que el entorno de ejecución en su dispositivo de destino sea ligeramente diferente de lo que espera Qt. Esta es una causa habitual por la que una aplicación Qt no se inicia en un nuevo dispositivo de destino. Algunas variables de entorno genéricas pueden ayudar a localizar la causa raíz de los problemas:

  • Establecer ` QT_DEBUG_PLUGINS ` en ` 1 ` ayuda a determinar por qué no se puede cargar el complemento QPA.
  • Establecer LD_DEBUG en 1 ayuda a ver dónde y cómo se cargan las bibliotecas compartidas. Esto se puede utilizar junto con QT_DEBUG_PLUGINS cuando un complemento no se ha podido cargar porque no ha podido cargar otras bibliotecas compartidas.
  • Al configurar QT_LOGGING_TO_CONSOLE se forzará el envío de todos los mensajes de registro a stderr en lugar de a slog2. Esto resulta útil para analizar problemas de inicio de la aplicación, ya que no es necesario utilizar otra herramienta para ver los mensajes.

Qt suele utilizar fontconfig para proporcionar acceso a las fuentes del sistema. Si aún no se ha creado una caché de fuentes, se creará al iniciar la primera aplicación Qt. Dependiendo de la configuración, esto puede llevar mucho tiempo y retrasar considerablemente el inicio de las aplicaciones. Si no es necesario, fontconfig se puede desactivar con -DFEATURE_fontconfig=OFF durante la configuración.

Uso de QCursor en la plataforma QNX

La compatibilidad con cursores personalizados en QNX está desactivada por defecto. Para activarla, configura la variable de entorno ` QT_QPA_QNX_CUSTOM_CURSOR ` antes de iniciar tu aplicación Qt:

export QT_QPA_QNX_CUSTOM_CURSOR=1

Cuando se habilita la compatibilidad con cursores personalizados, QNX permite cambiar la forma del cursor de una ventana, pero deberá implementar y especificar las imágenes asociadas a las formas que desee utilizar a través del archivo de configuración de pantalla, graphics.conf. Consulte el parámetro «cursor-type» de la subsección «Configurar la pantalla» para obtener más detalles. Además del cursor predeterminado, QNX no proporciona ningún cursor adicional. Por lo tanto, cualquier gráfico de cursor adicional debe proporcionarse manualmente en formato de mapa de bits. La tabla siguiente muestra el nombre del cursor utilizado en graphics.conf para cada valor de « Qt::CursorShape ».

Qt::CursorShape valorNombre de la configuración de pantalla de QNX
Qt::ArrowCursorflecha
Qt::CrossCursorcruz
Qt::WaitCursorespera
Qt::IBeamCursorviga
Qt::PointingHandCursormano
Qt::OpenHandCursoragarrar
Qt::ClosedHandCursoragarrando
Qt::DragMoveCursormover
Todas las demás formas de cursorflecha (predeterminada)

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.