Skip to content

Commit d087294

Browse files
committed
Merge remote-tracking branch 'github/master'
2 parents 26dfc1e + 7b232ea commit d087294

3 files changed

Lines changed: 13 additions & 39 deletions

File tree

README.md

Lines changed: 12 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -258,16 +258,12 @@ Here are some screenshots of ComposeTray running on different platforms:
258258

259259
## Linux packaging and Qt dependencies
260260

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.
262262

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.
264265
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+
---
271267

272268
### Developer setup on Ubuntu/Debian
273269

@@ -277,54 +273,32 @@ If you are developing or running locally on Ubuntu/Debian, ensure the runtime pa
277273
sudo apt-get install -y libdbusmenu-qt5-2
278274
```
279275

280-
### Link your app to the Qt runtime packages
276+
---
277+
278+
### Linking your app to Qt runtime packages
281279

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:
283281

284282
* Plugin: [GradleComposeDesktopLinuxDeps](https://github.com/kdroidFilter/GradleComposeDesktopLinuxDeps)
285283
* Apply it in your Gradle build (Kotlin DSL):
286284

287285
```kotlin
288286
plugins {
289287
// ... your existing plugins
290-
id("io.github.kdroidfilter.compose.linux.packagedeps") version "0.2.0"
288+
id("io.github.kdroidfilter.compose.linux.packagedeps") version "0.2.1"
291289
}
292290
```
293291

294-
Then configure the Debian dependencies:
292+
Then configure it as follows:
295293

296294
```kotlin
297295
linuxDebConfig {
298-
debDepends.set(
299-
listOf(
300-
"libqt5core5t64",
301-
"libqt5gui5t64",
302-
"libqt5widgets5t64",
303-
"libdbusmenu-qt5-2"
304-
)
305-
)
296+
addComposeNativeTrayDeps()
306297
}
307298
```
308299

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).
314301

315-
```kotlin
316-
linuxDebConfig {
317-
debDepends.set(
318-
listOf(
319-
"libqt5core5t64 | libqt5core5a",
320-
"libqt5gui5t64 | libqt5gui5",
321-
"libqt5widgets5t64 | libqt5widgets5",
322-
"libdbusmenu-qt5-2"
323-
)
324-
)
325-
enableT64AlternativeDeps = true
326-
}
327-
```
328302

329303
### Using Conveyor
330304

linuxlib

34.1 KB
Binary file not shown.

0 commit comments

Comments
 (0)