Skip to content

Commit

Permalink
extensions: Minor fixes and additions
Browse files Browse the repository at this point in the history
 - explain add-ld-path
 - explain .debug and .locale extensions are created with
   autodelete=true
 - Fix version of an extension
  • Loading branch information
bbhtt committed May 6, 2024
1 parent 10fb0bb commit cab84e1
Showing 1 changed file with 7 additions and 4 deletions.
11 changes: 7 additions & 4 deletions docs/extension.rst
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,9 @@ further below.

- ``add-ld-path`` adds a path relative to the extension prefix
``/app/extension_directory/foo/lib``, so that a library residing there
can be loaded. This supports a single value.
can be loaded. This supports a single value. If the ``$LD_LIBRARY_PATH``
environment variable exists, the path here is appended to it, otherwise
it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``.

- ``merge-dirs: plug-ins;help`` will merge the contents of these
directories from multiple extensions using the same extension point.
Expand All @@ -100,6 +102,9 @@ further below.
- ``autodelete: true`` will remove all extensions under this extension
point when the application is removed.

``.Debug`` and ``.Locale`` extensions are created with
``autodelete: true`` by default.

- ``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup
phase. It is used to initialise an empty directory for the extension to
be loaded. This can also be done using ``post-install`` or ``build-commands``
Expand Down Expand Up @@ -173,8 +178,6 @@ in the application. The extension is loaded at runtime and the user needs
to have it installed.

The extensions are mounted in alphabetical path order of directory.
ld-path prepended before ``/app/lib`` for app extensions and appended
after ``/app/lib`` in case of runtime extensions.

``org.freedesktop.Platform.ffmpeg-full`` is an extension of the runtime
``org.freedesktop.Platform`` and ``org.kde.Platform`` is a child runtime
Expand Down Expand Up @@ -208,7 +211,7 @@ of ``org.freedesktop.Platform``.
add-extensions:
org.freedesktop.Sdk.Extension.texlive:
directory: texlive
version: '22.08'
version: '23.08'
cleanup-commands:
- mkdir -p ${FLATPAK_DEST}/texlive
Expand Down

0 comments on commit cab84e1

Please sign in to comment.