aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 0e8af70d8036086e1c583adcb8a1c5e170d44734 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
AGL Application Launcher service reference implementation

`applaunchd` is a simple service for launching applications from other
applications.  It exposes a gRPC RPC interface as described in the file
`protos/applauncher.proto`.

The interface can be used to:
- retrieve a list of available applications
- request that a specific application be started by using the 'start' method
- subcribe to a status signal (separate 'started' and/or 'terminated' signals
  for the D-Bus implementation) in order to be notified when an application
  has started successfully or terminated.

For more details about the deprecated D-Bus interface, please refer to the
file `data/org.automotivelinux.AppLaunch.xml`.

Applications are enumerated from systemd's list of available units based on
the pattern agl-app*@*.service, and are started and controled using their
systemd unit.  Please note `applaunchd` allows only one instance of a given
application.

Note that while the gRPC and D-Bus implementations are comparable in
functionality, they are not interoperable with respect to status notifications
for applications started by the other interface.  It is advised that their
usage not be mixed in the same image to avoid confusion around application
window activation.

AGL repo for source code:
https://gerrit.automotivelinux.org/gerrit/#/admin/projects/src/applaunchd

You can also clone the source repository by running the following command:
```
$ git clone https://gerrit.automotivelinux.org/gerrit/src/applaunchd
```