Referência de Estratégias de Atualização

Toda receita de app requer um bloco strategy que informa ao fp-appimage-updater onde procurar a versão mais recente e como baixá-la. Três estratégias estão disponíveis.

Quando usar cada estratégia:

Estratégia	Use quando
`forge`	O app publica releases no GitHub ou GitLab
`direct`	O app fornece uma URL estável que sempre aponta para a versão mais recente
`script`	Nenhuma das opções acima se encaixa - você precisa de lógica personalizada para encontrar a URL de download

Forge
Direct
Script

Use a estratégia forge para apps distribuídos por meio de releases do GitHub, GitLab, Gitea ou Forgejo. fp-appimage-updater consulta a API de releases, corresponde o nome do arquivo do asset ao seu padrão e baixa o arquivo correspondente.Para repositórios do GitHub, você pode fornecer um token de API via secrets.yml ou pela variável de ambiente GITHUB_TOKEN para contornar limites de taxa. Veja Configuração Global para detalhes.Para instâncias auto-hospedadas do Gitea ou Forgejo, o resolvedor detecta automaticamente a plataforma consultando o endpoint de metadados /swagger.v1.json do host do repositório.Para repositórios GitLab, o resolvedor usa a API latest permalink em https://gitlab.com/api/v4/projects/<project-path>/releases/permalink/latest, lê assets.links e prefere direct_asset_url quando disponível.

Campos

strategy.strategy

string

obrigatório

Deve ser forge.

strategy.repository

string

obrigatório

URL completa para o repositório GitHub, GitLab, Gitea ou Forgejo (por exemplo, https://github.com/owner/repo).

strategy.asset_match

string

Padrão curinga para corresponder ao nome do arquivo do asset da release. Usa sintaxe glob estilo shell (por exemplo, "*-amd64.AppImage"). O primeiro asset correspondente é selecionado. Obrigatório se asset_match_regex não for fornecido.

strategy.asset_match_regex

string

Expressão regular opcional para corresponder ao nome do arquivo do asset. Use isso para casos complexos onde um padrão glob simples é muito abrangente. Por exemplo, para corresponder a Obsidian-1.5.3.AppImage enquanto exclui Obsidian-1.5.3-arm64.AppImage, você pode usar ^Obsidian-[0-9.]+\\.AppImage$.

strategy.inner_asset_match

string

Padrão opcional para encontrar uma AppImage específica dentro de um arquivo .zip. Se o asset resolvido for um arquivo ZIP, o updater extrairá o arquivo que corresponde a este padrão. Se omitido, ele procura automaticamente por arquivos que terminam em .AppImage ou que contêm magic bytes ELF.

Sobrescritas por app

Você também pode definir esses campos diretamente na receita do app (não dentro de strategy) para sobrescrever a configuração global para este app:

github_proxy

boolean

Habilita ou desabilita o fallback de proxy da API do GitHub para este app. Quando habilitado, uma requisição de metadados do GitHub limitada por taxa é repetida por meio das bases de proxy configuradas. A URL real de download sempre usa o link direto do asset do GitHub.

github_proxy_prefix

string | string[]

URL(s) base de proxy a usar quando github_proxy está habilitado. Aceita uma única string de URL, uma lista de URLs ou a string all para tentar cada proxy embutido em ordem.

respect_rate_limits

boolean

Quando false, fp-appimage-updater ignora uma janela anterior de limite de taxa e sempre tenta a requisição.

Exemplos

Release Forge padrão:

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

Extração de arquivo ZIP: Se um app estiver empacotado dentro de um arquivo ZIP, use asset_match para encontrar o ZIP e inner_asset_match para especificar qual arquivo extrair:

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

Correspondência por Regex: Use asset_match_regex para casos complexos onde um padrão glob simples é muito abrangente (ex: para excluir assets arm64):

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

Repositório GitLab:

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

Gitea/Forgejo auto-hospedado: A plataforma do host é detectada automaticamente.

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

Use a estratégia direct quando o fornecedor do app publica uma URL estável que sempre resolve para a versão mais recente. fp-appimage-updater verifica os cabeçalhos HTTP da resposta para detectar se o arquivo remoto mudou desde o último download.

Campos

strategy.strategy

string

obrigatório

Deve ser direct.

strategy.url

string

obrigatório

URL de download estática que sempre aponta para a versão mais recente do AppImage.

strategy.check_method

string

obrigatório

Cabeçalho HTTP usado para detectar alterações remotas. Valores aceitos:

etag — compara o cabeçalho de resposta ETag
last-modified — compara o cabeçalho de resposta Last-Modified

Escolha o cabeçalho que o servidor fornecer. Se não tiver certeza, tente etag primeiro.

Exemplo

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

Use a estratégia script quando nem forge nem direct se encaixarem - por exemplo, quando a URL de download do app exige analisar uma resposta de API personalizada ou uma página de releases não padronizada.Você fornece um script bash que fp-appimage-updater executa para resolver a URL de download e a versão atuais. O script deve imprimir exatamente duas linhas em stdout:

A URL de download
A string de versão

fp-appimage-updater armazena a string de versão localmente e a compara na próxima execução para decidir se uma atualização é necessária.

Campos

strategy.strategy

string

obrigatório

Deve ser script.

strategy.script_path

string

obrigatório

Caminho para o script bash, relativo ao diretório da receita.

script_path é resolvido relativamente ao diretório que contém o arquivo de receita. Se sua receita estiver em ~/.config/fp-appimage-updater/apps/hayase/hayase.yml, então ./resolver.sh resolve para ~/.config/fp-appimage-updater/apps/hayase/resolver.sh.

Exemplo

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

#!/usr/bin/env bash

set -e

# Buscar a definição YAML
YAML_DATA=$(curl -sL "https://api.hayase.watch/files/latest-linux.yml")

# Use yq ou grep para extrair a versão - vamos escrever isso de forma genérica para sistemas sem 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}')
# fallback usando sed básico
if [ -z "$FILENAME" ]; then
   FILENAME="linux-hayase-${VERSION}-linux.AppImage"
fi

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

# O atualizador espera "DOWNLOAD_URL" depois "VERSION" em linhas consecutivas de stdout:
echo "$DOWNLOAD_URL"
echo "$VERSION"

Documentation Index

​Campos

​Sobrescritas por app

​Exemplos

​Campos

​Exemplo

​Campos

​Exemplo

Campos

Sobrescritas por app

Exemplos

Campos

Exemplo

Campos

Exemplo