Skip to content

Commit 9aafbd4

Browse files
committed
doc: Add libdrm troubleshooting entry
I ran into this today when I tried running the Linux app. (It looks like the reason I hadn't seen it before is that until recently I had this package installed; it was installed "automatically", i.e. only because it was a dependency of something else, and then I upgraded my machine, it was no longer such a dependency, and got autoremoved. Now that I've installed it directly, it'll stay.)
1 parent fb1b97f commit 9aafbd4

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

docs/setup.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -179,3 +179,37 @@ For the original reports and debugging of this issue, see
179179
chat threads
180180
[here](https://chat.zulip.org/#narrow/stream/243-mobile-team/topic/flutter.20json_annotation.20unexpected.20behavior/near/1824410)
181181
and [here](https://chat.zulip.org/#narrow/stream/516-mobile-dev-help/topic/generated.20plugin.20files.20changed/near/1944826).
182+
183+
184+
<div id="libdrm" />
185+
186+
### Lack of libdrm on Linux target
187+
188+
This item applies only when building the app to run as a Linux desktop
189+
app. (This is an unsupported configuration which is sometimes
190+
convenient in development.) It does not affect using Linux for a
191+
development environment when building or running Zulip as an Android
192+
app.
193+
194+
When building or running as a Linux desktop app, you may see an error
195+
about `/usr/include/libdrm`, like this:
196+
```
197+
$ flutter run -d linux
198+
Launching lib/main.dart on Linux in debug mode...
199+
CMake Error in CMakeLists.txt:
200+
Imported target "PkgConfig::GTK" includes non-existent path
201+
202+
"/usr/include/libdrm"
203+
204+
in its INTERFACE_INCLUDE_DIRECTORIES. Possible reasons include:
205+
206+
```
207+
208+
This means you need to install the header files for "DRM", part of the
209+
Linux graphics infrastructure.
210+
211+
To resolve the issue, install the appropriate package from your OS
212+
distribution. For example, on Debian or Ubuntu:
213+
```
214+
$ sudo apt install libdrm-dev
215+
```

0 commit comments

Comments
 (0)