You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+12-38Lines changed: 12 additions & 38 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -258,16 +258,12 @@ Here are some screenshots of ComposeTray running on different platforms:
258
258
259
259
## Linux packaging and Qt dependencies
260
260
261
-
This library uses Qt on Linux. When you package your app for Linux, you must declare the required Qt runtime packages so the OS will install them if necessary.
261
+
This library uses **Qt** on Linux. When you package your app for Linux, you must declare the required Qt runtime packages so the OS will install them if necessary.
262
262
263
-
* Minimal Debian/Ubuntu dependencies:
263
+
> **Heads-up:** In most cases, the only package that will be newly downloaded is **`libdbusmenu-qt5-2`** (≈300 KB).
264
+
> Qt itself is widely used by many desktop applications and often comes preinstalled with the desktop environment, so users typically already have the necessary Qt runtime packages.
264
265
265
-
* libqt5core5t64
266
-
* libqt5gui5t64
267
-
* libqt5widgets5t64
268
-
* libdbusmenu-qt5-2
269
-
270
-
> **Heads-up:** In most cases, the only package that will be newly downloaded is **`libdbusmenu-qt5-2`** (≈300 KB). Qt itself is widely used by many desktop applications and often comes preinstalled with the desktop environment, so users typically already have the necessary Qt runtime packages.
266
+
---
271
267
272
268
### Developer setup on Ubuntu/Debian
273
269
@@ -277,54 +273,32 @@ If you are developing or running locally on Ubuntu/Debian, ensure the runtime pa
277
273
sudo apt-get install -y libdbusmenu-qt5-2
278
274
```
279
275
280
-
### Link your app to the Qt runtime packages
276
+
---
277
+
278
+
### Linking your app to Qt runtime packages
281
279
282
-
If you use jpackage (Compose Multiplatform native distributions), we provide a Gradle plugin to declare these dependencies in the generated .deb control file:
280
+
If you use **jpackage** (Compose Multiplatform native distributions), you can use the dedicated Gradle plugin to declare the required dependencies automatically in the generated `.deb` control file:
id("io.github.kdroidfilter.compose.linux.packagedeps") version "0.2.0"
288
+
id("io.github.kdroidfilter.compose.linux.packagedeps") version "0.2.1"
291
289
}
292
290
```
293
291
294
-
Then configure the Debian dependencies:
292
+
Then configure it as follows:
295
293
296
294
```kotlin
297
295
linuxDebConfig {
298
-
debDepends.set(
299
-
listOf(
300
-
"libqt5core5t64",
301
-
"libqt5gui5t64",
302
-
"libqt5widgets5t64",
303
-
"libdbusmenu-qt5-2"
304
-
)
305
-
)
296
+
addComposeNativeTrayDeps()
306
297
}
307
298
```
308
299
309
-
#### Important note about jpackage and distro compatibility
310
-
311
-
There is a known jpackage issue that can cause incompatibilities between packages built on Ubuntu 24/Debian 13 and those built on Ubuntu 22/Debian 12 (and vice versa). Please see the plugin README for [details](https://github.com/kdroidFilter/GradleComposeDesktopLinuxDeps?tab=readme-ov-file#-known-jpackage-issue-ubuntu-t64-transition)
312
-
313
-
To support both newer T64 packages and older package names, use alternatives and enable the T64 alternative mode:
300
+
For more information about distro compatibility and advanced options, please see the [plugin README](https://github.com/kdroidFilter/GradleComposeDesktopLinuxDeps).
0 commit comments