Skip to content

9.desktop.md

Latest commit

 

History

History
69 lines (59 loc) · 3.4 KB

9.desktop.md

File metadata and controls

69 lines (59 loc) · 3.4 KB
icon display-medical
description Fetch .Desktop file from Remote/Local (SBUILD) Source (TYPE: NON_ENFORCED)

9.Desktop

{% code overflow="wrap" %}

#Example ONLY
desktop:
 #Can contain one of (or all of): url, file, dir
 #If it contains multiple (or all), the builder WILL STOP UPON FIRST successful desktop file MATCH
  url: "#A Direct RAW URL to download a .desktop file"
  file: "#A Direct PATH to a .desktop file from ${SBUILD_OUTDIR} | ${SBUILD_TMPDIR}"
  dir: "#A Direct PATH to a Directory that contains at least 1 .Desktop"

{% endcode %}

  • This is Optional & can be left empty or removed completely (TYPE:NON_ENFORCED)
  • This is applicable only if $pkg_type is a portable format like AppImage, FlatImage etc
  • This will be downloaded/copied & saved as ${SBUILD_PKG}.desktop inside as ${SBUILD_OUTDIR}/${SBUILD_PKG}.desktop
  • If used, it can only contain (One of these or all):
  • url : Is always preferred as the 1st Choice, even if used with others
  • file : Is ONLY preferred, if url was non-existent/empty, as the 2nd Choice
  • dir : Is ONLY preferred, if both url & file are non-existent/empty, as the 3rd & Final Choice

{% code overflow="wrap" %}

#Another Example
desktop:
 #Can contain one of (or all of): url, file, dir
  url: "https://example.com/example.desktop"
  #If you only use `/example.desktop` or `example.desktop`, it is assumed as: ${SBUILD_OUTDIR}/example.desktop
  #Here, we specify explictly to use ${SBUILD_TMPDIR}
  file: "${SBUILD_TMPDIR}/example.desktop" 
  #You can just use `/usr/share` or `usr/share`, it is assumed as: ${SBUILD_OUTDIR}/usr/share
  dir: "usr/share" #will search in ${SBUILD_OUTDIR}/usr/share

{% endcode %}

{% hint style="info" %} file supports wildcard glob (*) pattern

{% code overflow="wrap" %}

desktop:
#Will search for a *.desktop file in ${SBUILD_TMPDIR} (picks first match)
  file: "${SBUILD_TMPDIR}/*.desktop"

{% endcode %} {% endhint %}

{% hint style="info" %} dir supports wildcard glob (*) pattern

desktop:
  dir: "${SBUILD_OUTDIR}/usr/share/applications/assets*" 
#Will search inside all these dir (picks first match):
# ${SBUILD_OUTDIR}/usr/share/applications/assets-extras
# ${SBUILD_OUTDIR}/usr/share/applications/assets_res
# ${SBUILD_OUTDIR}/usr/share/applications/assetsXYZ

{% endhint %}

{% hint style="info" %} This MAY BE OVERWRITTEN, if x_exec.run does something to the file, otherwise is used as the default .Desktop file {% endhint %}