Content Source: deepin Plant
Qt 6.8 has been released for some time now, and various distributions have encountered significant issues with several components, including dde-shell, when attempting to port DDE. The DDE team has carried out related emergency repairs. Since some DDE projects are also maintained through forking, to facilitate effective porting by porters, the following precautions are listed here.
Note: The testing environment used by the author is Arch Linux, and the following are the test conclusions of the testing repository as of 2024/10/25. Unless otherwise specified, the project names mentioned below still use the names of the original repositories corresponding to DDE, not the package names under each distribution.
Update: There are now new maintenance branch versions for dde-launchpad, dde-tray-loader, and dde-shell, and some versions already include some of the patches mentioned below. This article only updates the new tag versions that have been physically verified to be usable, but you can also try new tags on the maintenance branch that have not been verified.
Branch and Tag Explanation
For maintenance purposes, for some DDE components (dde-shell, dde-launchpad, dde-tray-loader), we have created a maintenance branch named release/beige
for the branch used by deepin 23. We also apply corresponding maintenance update tags on the maintenance branch.
Since deepin's current testing process requires tagging the test version, we also tag the main (master) branch. To distinguish as much as possible without conflicting with the current specifications, we use tags in the format of x.99.z
to indicate that this version is still under development. In fact, the tag version under development can also be used externally under certain conditions, but we do not guarantee compatibility when updating the z position in x.99.z
, so it is still recommended to use the tag version on release/beige first.
Qt 6 Wayland
Since the tray loading part of dde-shell (dde-tray-loader) uses Wayland (even in X11 environments) to implement application embedding, there is a dependency on the Wayland component of Qt 6. The following two patches need to be applied to the Qt 6 Wayland component:
- https://codereview.qt-project.org/c/qt/qtwayland/+/598596
- https://codereview.qt-project.org/c/qt/qtwayland/+/599732
dde-shell
Patch Description
After upgrading to Qt 6.8, dde-shell may have a situation where the panel has no content. For this issue, this patch needs to be applied: https://github.com/linuxdeepin/dde-shell/commit/46871c83cf8ecfcf83bf2fb49e1f09af997eca96
Version Recommendations
- If the target distribution is originally using version 1.0.0, it is recommended to update to at least 1.0.2.
- Versions above 1.0.3 depend on the treeland-protocols project, which can be packaged as is, and it is recommended to update dde-shell to at least 1.0.4 after aligning the packaging.
- Since treeland-protocols has updated the case sensitivity of target names in its CMake support, you need to apply this small patch (or manually make the corresponding adjustments): https://github.com/linuxdeepin/dde-shell/commit/b3f342c094354e4ba87ac1da4cf1a380556b2a3b
- There is a 1.99.1 version in the dde-shell main branch, but the main branch, including this version, no longer provides launcher icons in the taskbar, so it needs to be used in conjunction with the launcher main branch (the launcher does not have a 1.99.z version yet).
tl;dr: It is recommended to package treeland-protocols and update to at least 1.0.4.
treeland-protocols
Depended on by dde-shell version 1.0.3 and above.
Version Recommendations
It is recommended to package/update to 0.4.1.
dde-tray-loader
Patch Description
The pop-up panels in the taskbar tray area (such as the panel that appears after clicking on the time component) had incorrect positioning issues in earlier versions, which require the application of this patch: https://github.com/linuxdeepin/dde-tray-loader/commit/664b093b6a913764fedbac9110927f26978aa8c9.
The latest versions (starting from 1.0.5) have already fixed the related issues.
Version Recommendations
It is recommended to update to 1.0.5.
dde-launchpad
Patch Description
The maintenance branch version of the launcher should work correctly without any modifications. Although the panel position of the launcher's small window mode may be incorrect, the position issue is not planned to be resolved in the maintenance branch at this time.
The main branch of the launcher does not have the aforementioned problem, but there is currently no 1.99.z tag on the main branch.
Version Recommendations
During the previous porting process, it was found that there might be display misalignment issues with the small window search results interface. This issue has been fixed in version 1.0.6, so it is recommended to update to 1.0.6.
dde-application-manager
Patch Description
No patch is required.
Version Recommendations
A so-called "feature" in deepin 23 is that child processes started by the parent process are generally recognized as belonging to the parent process. This can cause issues such as when launching vscode from a terminal, the opened vscode window will share the same icon as the terminal. This issue has been resolved in the latest maintenance version. Simply updating dde-shell (>= 1.0.4) and dde-application-manager (>=1.2.16) will resolve the issue.
It is recommended to update to 1.2.16.
Related Reading:
(1)International Rankings for deepin
(2)deepin Desktop Environment(DDE)
(3)Unveiling the Treeland Technology Behind DDE
Content source: deepin community
Reprinted with attribution