Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: add compulsoryAppIdList, update DConfig doc #218

Merged
merged 1 commit into from
Apr 22, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions docs/DConfig.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,16 +39,27 @@ The base configuration template is **usually** located at `/usr/share/dsg/config

### org.deepin.dde.launchpad.appsmodel

#### `excludeAppIdList`
#### `excludeAppIdList` (readonly)

The application id list that shouldn't be displayed in dde-launchpad. The application id is its freedeskop.org [`desktop-entry-spec` desktop file id](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s02.html#desktop-file-id).

> [!IMPORTANT]
> Think twice before actually using this field. If you are application developer or distro package maintainer, please consider use the [`OnlyShowIn`, `NotShowIn` or `Hidden` field](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s06.html) inside the application's desktop file.

#### `compulsoryAppIdList`
#### `compulsoryAppIdList` (readonly)

The application id list that is considered as compulsory for the current desktop environment. The "Uninstall" menu entry will be disabled for these applications. The application id is its freedeskop.org [`desktop-entry-spec` desktop file id](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s02.html#desktop-file-id).

> [!IMPORTANT]
> Think twice before actually using this field. If you are application developer or distro package maintainer, please consider ship an AppStream metadata file to mark your application as a compulsory component. See: [`<compulsory_for_desktop/>`](https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-compulsory_for_desktop).
> Think twice before actually using this field. If you are application developer or distro package maintainer, please consider ship an AppStream metadata file to mark your application as a compulsory component. See: [`<compulsory_for_desktop/>`](https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-compulsory_for_desktop).

#### `frequentlyUsedAppIdList` (readonly)

The default application id list that will be displayed in the "my frequency used" section when users haven't interact with any program.

> [!NOTE]
> This section will only show max to 16 (4x4) items, and it will only show 12 (4x3) items when "recently installed" section is visible. So it's suggested to ensure the list is equal or less than 16 items.

#### `categoryType`

The default sort and group type for the app list in windowed mode launchpad. Value 0 for alphabetary, 1 for DDE-style category, 2 for freeform sort. Such value can be override from the UI by the end user.
27 changes: 25 additions & 2 deletions src/models/org.deepin.dde.launchpad.appsmodel.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,29 @@
"permissions": "readonly",
"visibility": "private"
},
"compulsoryAppIdList": {
"value": [
"dde-control-center.desktop",
"dde-computer.desktop",
"dde-trash.desktop",
"dde-file-manager.desktop",
"deepin-terminal.desktop",
"deepin-manual.desktop",
"deepin-system-monitor.desktop",
"deepin-devicemanager.desktop",
"dde-printer.desktop",
"deepin-app-store.desktop",
"dde-calendar.desktop"
],
"serial": 0,
"flags": [],
"name": "Compulsory Application ID List",
"name[zh_CN]": "核心必要应用 ID 列表",
"description": "The desktop ID list for applications considered as compulsory.",
"description[zh_CN]": "需要被视为核心必要应用的应用 ID 列表。",
"permissions": "readonly",
"visibility": "private"
},
"frequentlyUsedAppIdList": {
"value": [
"org.deepin.browser.desktop",
Expand All @@ -34,9 +57,9 @@
],
"serial": 0,
"flags": [],
"name": "frequentlyUsed Application ID List",
"name": "Frequently Used Application ID List",
"name[zh_CN]": "常用应用 ID 列表",
"description": "The default desktop ID list for my frequentlyUsed used applications.",
"description": "The default desktop ID list for \"my frequently used\" applications.",
"description[zh_CN]": "我的常用中默认显示的应用程序的 desktop ID 列表。",
"permissions": "readonly",
"visibility": "private"
Expand Down
Loading