Skip to content
Select theme
Select languageEnglish

Local install

acdev dev hands your app to the runtime only temporarily. To keep the app in the Dopame desktop on this machine:

Terminal window
acdev install

This runs acdev build, then installs the package into $XDG_DATA_HOME/acde/packages/<id> (by default ~/.local/share/acde/packages/<id>, on Windows %USERPROFILE%\.local\share\acde\packages\<id>). It copies to a temporary directory first and then swaps the whole directory in, so you never end up with half a package. A handwritten package (no config, with its own acdev manifest in package.json) is installed as a symlink to the project.

Once installed, the next session you start (and acdev dev --desktop dopame) will see it.

In this order; for a given id, the first one found wins:

  1. Directories in ACDE_PATH (this is how acdev dev hands over its builds);
  2. $XDG_DATA_HOME/acde/packages/*;
  3. $XDG_DATA_DIRS/acde/packages/* (system-wide installs).
Terminal window
acdev uninstall # the installed packages: id and path
acdev uninstall <id> # or the project directory it was installed from

It says what it removes and asks first (--yes skips the question, and is needed outside a terminal). A copied package's directory is removed; for a handwritten package only the link is removed, never the project. A package that a running acdev dev session uses is not removed: stop that session first.

The apps' data is kept: under ~/.local/share/acde/ their storage (storage/app-<id>/), backend data (apps/<id>/) and private files (files/<id>/), their folder grants (~/.local/state/acde/grants/<id>.json), and their entries in ~/.config/acde/permissions.json (camera and microphone decisions) and ~/.local/state/acde/windows.json (window places). It is kept unless you ask, and removing it takes all of these (other apps' entries in the shared files stay): in a terminal acdev uninstall asks whether to remove it too; --data removes it and --keep-data keeps it without asking. With --yes alone it is kept, and the paths are printed. acdev uninstall lists the exit codes.

An app store and acdev publish are still in the works. For now, distributing an app means distributing the built package directory (.acde/); put it in any of the locations above.