Referentia Strategiarum Renovationis

Omnis formula applicationis requirit blocum strategy qui dicit fp-appimage-updater ubi quaerere versionem recentissimam et quomodo eam dēscribere. Tres strategiae praesto sunt.

Quando quaque strategia utendum:

Strategia	Utere cum
`forge`	Applicatio emissiones in GitHub vel GitLab publicat
`direct`	Applicatio praebet URL stabilem quae semper indicat ad versionem recentissimam
`script`	Neutrum ex superioribus convenit - logica personalis necessaria est ad inveniendam URL dēscriptionis

Forge
Direct
Script

Utere strategia forge pro applicationibus distributis per emissiones GitHub, GitLab, Gitea, vel Forgejo. fp-appimage-updater consulit API emissionum, formulae nomini fasciculi assetis tuae respondet et fasciculum correspondentem dēscribit.Pro repositoriis GitHub, potes providere tesseram API per secrets.yml vel variabilem ambientis GITHUB_TOKEN ad limites rate praeteriendos. Vide Configurationem Globalem pro singulis.Pro repositoriis GitLab, resolver adhibet API latest permalink in https://gitlab.com/api/v4/projects/<project-path>/releases/permalink/latest, legit assets.links et praefert direct_asset_url cum praesto est.Pro instantiis auto-hospitatis Gitea vel Forgejo, resolver automatice detegit platam interrogando endpoint metadata /swagger.v1.json hostis repositorii.

Campi

strategy.strategy

string

obbligatorio

Debet esse forge.

strategy.repository

string

obbligatorio

URL completa ad repositorium GitHub, GitLab, Gitea, vel Forgejo (exempli gratia, https://github.com/owner/repo).

strategy.asset_match

string

Formula substitutiva ad respondendum nomini fasciculi assetis emissionis. Adhibet syntaxim glob styli shell (exempli gratia, "*-amd64.AppImage"). Primus asset respondens eligitur. Necessaria si asset_match_regex non praebetur.

strategy.asset_match_regex

string

Expressio regularis optionalis pro nomine fasciculi assetis. Utere hoc pro casibus complexis ubi formula glob simplex nimis lata est. Exempli gratia, ad respondendum Obsidian-1.5.3.AppImage dum excluditur Obsidian-1.5.3-arm64.AppImage, potes uti ^Obsidian-[0-9.]+\\.AppImage$.

strategy.inner_asset_match

string

Formula optionalis ad inveniendam AppImage specificam intra archivum .zip. Si asset solutum est fasciculus ZIP, renovator fasciculum huic formulae respondentem extrahet. Si omittitur, automatice quaerit fasciculos in .AppImage desinentes aut magic bytes ELF continentes.

Superationes per applicationem

Etiam potes definire hos campos directe in formula applicationis (non intra strategy) ad superandum configurationem globalem pro hac applicatione:

github_proxy

boolean

Habilitat vel dishabilitat subsidiarium procuratoris API GitHub pro hac applicatione. Cum habilitatum, petitio metadata GitHub limite rate adfecta repetitur per bases procuratorum configuratas. URL realis dēscriptionis semper utitur nexu directo assetis GitHub.

github_proxy_prefix

string | string[]

URL(s) basis procuratoris utendas cum github_proxy habilitatum est. Accipit unicam stringam URL, enumerationem URLium vel stringam all ad temptandum quemque procuratorem integrum in ordine.

respect_rate_limits

boolean

Cum false, fp-appimage-updater ignorat fenestram priorem limitis rate et semper temptat petitionem.

Exempla

Emissio Forge normativa:

name: hydra-launcher
strategy:
  strategy: forge
  repository: https://github.com/hydralauncher/hydra
  asset_match: "hydralauncher-*.AppImage"
segmented_downloads: true

Extractio archivi ZIP: Si applicatio intra fasciculum ZIP colligatur, utere asset_match ad ZIP inveniendum et inner_asset_match ad definiendum quem fasciculum extrahere:

name: sioyek
strategy:
  strategy: forge
  repository: https://github.com/ahrm/sioyek
  asset_match: "sioyek-release-linux.zip"
  inner_asset_match: "Sioyek-x86_64.AppImage"

Responsio per Regex: Utere asset_match_regex pro casibus complexis ubi formula glob simplex nimis lata est (exempli gratia, ad assets arm64 excludendos):

name: obsidian
strategy:
  strategy: forge
  repository: "https://github.com/obsidianmd/obsidian-releases"
  asset_match_regex: "^Obsidian-[0-9.]+\\.AppImage$"

Repositorium GitLab:

name: glab
strategy:
  strategy: forge
  repository: https://gitlab.com/gitlab-org/cli
  asset_match: "glab_*_linux_amd64.AppImage"

Gitea/Forgejo auto-hospitatus: Plata hostis automatice detegitur.

name: app-meus-privatus
strategy:
  strategy: forge
  repository: https://gitea.example.com/owner/repo
  asset_match: "app-*.AppImage"

Utere strategia direct cum provisor applicationis publicat URL stabilem quae semper ad versionem recentissimam resolvitur. fp-appimage-updater capita HTTP responsionis verificat ad detegendum si fasciculus remotus mutavit post ultimam dēscriptionem.

Campi

strategy.strategy

string

obbligatorio

Debet esse direct.

strategy.url

string

obbligatorio

URL dēscriptionis statica quae semper indicat ad versionem recentissimam AppImage.

strategy.check_method

string

obbligatorio

Caput HTTP adhibitum ad detegendas mutationes remotas. Valores accepti:

etag — comparat caput responsionis ETag
last-modified — comparat caput responsionis Last-Modified

Elige caput quod servitor praebet. Si incertus es, proba etag primum.

Exemplum

name: whatpulse
strategy:
  strategy: direct
  url: "https://releases.whatpulse.org/latest/linux/whatpulse-linux-latest_amd64.AppImage"
  check_method: etag
segmented_downloads: true

Utere strategia script cum neque forge neque direct convenit - exempli gratia, cum URL dēscriptionis applicationis requirit analysim responsionis API personalis vel paginae emissionum non normativae.Praebis scriptum bash quod fp-appimage-updater exsequitur ad resolvendum URL dēscriptionis et versionem currentes. Scriptum debet imprimere exacte duas lineas in stdout:

URL dēscriptionis
Stringam versionis

fp-appimage-updater stringam versionis localiter reponit et eam in exsecutione proxima comparat ad decidendum si renovatio necessaria sit.

Campi

strategy.strategy

string

obbligatorio

Debet esse script.

strategy.script_path

string

obbligatorio

Via ad scriptum bash, relativa ad directorium formulae.

script_path resolvitur relative ad directorium continens fasciculum formulae. Si formula tua est in ~/.config/fp-appimage-updater/apps/hayase/hayase.yml, tunc ./resolver.sh resolvitur ad ~/.config/fp-appimage-updater/apps/hayase/resolver.sh.

Exemplum

name: hayase
strategy:
  strategy: script
  script_path: ./resolver.sh

#!/usr/bin/env bash

set -e

# Pete definitionem YAML
YAML_DATA=$(curl -sL "https://api.hayase.watch/files/latest-linux.yml")

# Utere yq vel grep ad extrahendum versionem - scribemus hoc modo generico pro systematibus sine yq
VERSION=$(echo "$YAML_DATA" | grep "^version:" | awk '{print $2}')
FILENAME=$(echo "$YAML_DATA" | grep "'linux-hayase-.*-linux.AppImage'" || echo "$YAML_DATA" | grep 'path:' | awk '{print $2}')
# subsidiarium utendo sed basicum
if [ -z "$FILENAME" ]; then
   FILENAME="linux-hayase-${VERSION}-linux.AppImage"
fi

DOWNLOAD_URL="https://api.hayase.watch/files/${FILENAME}"

# Renovator exspectat "DOWNLOAD_URL" deinde "VERSION" in lineis consecutivis stdout:
echo "$DOWNLOAD_URL"
echo "$VERSION"

Documentation Index

​Campi

​Superationes per applicationem

​Exempla

​Campi

​Exemplum

​Campi

​Exemplum

Campi

Superationes per applicationem

Exempla

Campi

Exemplum

Campi

Exemplum