Skip to content

Commit ce79700

Browse files
committed
Improve documentation about launchers
1 parent 222790c commit ce79700

File tree

1 file changed

+33
-0
lines changed
  • Reference/Core_Areas_and_APIs/Apps_and_MW/Lipstick/Launchers

1 file changed

+33
-0
lines changed

Reference/Core_Areas_and_APIs/Apps_and_MW/Lipstick/Launchers/README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,27 @@ They are read by [Lipstick](/Reference/Core_Areas_and_APIs/Apps_and_MW/Lipstick/
1515
Desktop Entry Specification allows extending the specification with product specific keys. Sailfish
1616
OS uses that to specify some extensions to support certain functions better.
1717

18+
### Launcher and Booster Type
19+
_X-Nemo-Application-Type_, and _X-Nemo-Single-Instance_ can be used instead
20+
of giving the the `--single-instance`, and `--type` options to invoker in the
21+
_Exec_ key.
22+
See the documentation for Invoker, and the
23+
[Harbour FAQ](https://harbour.jolla.com/faq#.desktop-Files) for details.
24+
25+
### Hiding app from launcher grid
26+
In addition to the _Hidden_, and _NoDisplay_ keys, app developers can use
27+
_NotShowIn=X-MeeGo_, to hide the launcher from the launcher grid.
28+
This is mainly useful for registering a MIME Type launchers.
29+
30+
### Localization
31+
In addition to the _Name[xx]_ method from the Desktop spec, launcher names can
32+
be localized using the keys _X-MeeGo-Translation-Catalog_, and
33+
_X-MeeGo-Logical-Id_. The former gives the basename (without language suffix, and
34+
without file extension) of a Qt translation (.qm) file. The latter specifies
35+
the translation ID (as used in Qt "id-based" translation).
36+
This way, developers can re-use a translation present in their application also
37+
for the launcher name.
38+
1839
### Application sandboxing profile
1940
Application developers can control their app's
2041
[sandbox](https://github.com/sailfishos/sailjail-permissions#sailfish-os-application-sandboxing-and-permissions)
@@ -70,3 +91,15 @@ In Sailfish OS 4.3.0 _ExecDBus_ is not considered when validating the arguments
7091
launched via D-Bus which limits usefulness of that key. To work around that, the launch arguments
7192
used for D-Bus activation must match _Exec_ key in _Desktop Entry_ section. This issue is fixed in
7293
Sailfish OS 4.4.0.
94+
95+
## D-Bus method calls
96+
The keys _X-Maemo-Service_, _X-Maemo-Object-Path_, and _X-Maemo-Method_ can be
97+
used to specify a D-Bus method on a certain object path, which is called when
98+
the launcher is activated.
99+
100+
This is similar to, but different from D-Bus activation above. The D-Bus
101+
Service must already be registered (using the method above, or from the app
102+
after launch), and `path` and `method` must exist for that service.
103+
104+
This is used e.g. by MimeType .desktop files to open an app at a certain page.
105+

0 commit comments

Comments
 (0)