UI specific package
User interfaces in postmarketOS are packaged in main/postmarketos-ui-* in pmaports.
Variables
Some APKBUILD variables of UI packages have additional meaning. Furthermore there are pmbootstrap specific variables (prefixed with _pmb_*) that only get used during pmbootstrap init and pmbootstrap install. When the installation is done, the _pmb_* variables are irrelevant: they are only in the APKBUILD and not in the built package, so apk doesn't know about them.
Keep this list in alphabetical order.
_pmb_groups
- Groups to which the default user should be added to during the installation.
_pmb_recommends
- Packages to install together with the UI, which can be uninstalled by the user (!1962).
_pmb_select
- Let
pmbootstrap initdisplay a prompt for each package in the given list of package, which provider to use for that package (!2132).
_pmb_default
- Define the package to display as default during a
pmbootstrap init_pmb_selectprompt. Without this the package with the highest priority will list as default (!2301).
options
- The
pmb:gpu-acceloption is specific to postmarketOS UI APKBUILDs. See pmbootstrap specific APKBUILD options.
pkgdesc
- The usual package description (see APKBUILD Reference). However, for UI packages it is also used in
pmbootstrap initfor the UI selection.
Extras subpackage
For postmarketos-ui-plasma-mobile, we have added an extras subpackage that has additional _pmb_recommends. Other _pmb_* options should work with this specific subpackage too (not with others though!). However, it's questionable how useful the extras subpackage is nowadays, as we have working graphical package managers now and just build the regular, non-extras package in official images (-extras subpackage was added before we had automated building images). So it's probably a good idea not to add more of those at least.