Skip to content

Commit e128ee4

Browse files
authored
Add headless qt info
1 parent fc5ed32 commit e128ee4

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

src/maintainer/maintainer_faq.rst

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,4 +126,31 @@ FAQ
126126
127127
ImportError: libGL.so.1: cannot open shared object file: No such file or directory
128128
129-
To fix the error, create a `yum_requirements.txt <https://conda-forge.org/docs/maintainer/knowledge_base.html#yum-deps>`_ file and add *mesa-libGL*.
129+
To fix the error, create a `yum_requirements.txt <https://conda-forge.org/docs/maintainer/knowledge_base.html#yum-deps>`_ file and add *mesa-libGL*.
130+
131+
132+
.. _mfaq_qt_load_xcb:
133+
134+
:ref:`(Q) <mfaq_qt_load_xcb>` **How can I fix the** ``The Qt platform plugin "xcb" could not be loaded`` **error during testing?**
135+
136+
137+
When testing packages that have a dependency on pyqt, the following error might occur under linux:
138+
139+
140+
.. code-block:: shell
141+
142+
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
143+
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.
144+
145+
Available platform plugins are: eglfs, minimal, minimalegl, offscreen, vnc, webgl, xcb.
146+
147+
148+
149+
This comes from the CI environment being headless and can be fixed by adding the ``QT_QPA_PLATFORM=offscreen`` `environment variable <https://docs.conda.io/projects/conda-build/en/latest/user-guide/environment-variables.html#inherited-environment-variabless>`_.
150+
The variable can either be added directly to the test command or provided in the `meta.yaml <https://conda-forge.org/docs/maintainer/adding_pkgs.html#the-recipe-meta-yaml>`_ like so:
151+
152+
.. code-block:: yaml
153+
154+
build:
155+
script_env:
156+
- QT_QPA_PLATFORM=offscreen

0 commit comments

Comments
 (0)