Receitas de Aplicativos - fp-appimage-updater

Uma receita é um arquivo YAML que diz ao fp-appimage-updater tudo o que ele precisa saber sobre um app: como ele se chama, como encontrar atualizações e como instalá-lo. Você escreve uma receita por app, faz commit dela nos seus dotfiles, e fp-appimage-updater cuida do resto.

Onde as receitas ficam

Coloque arquivos de receita dentro de ~/.config/fp-appimage-updater/apps/. Cada arquivo pode ser um .yml plano no nível superior, ou um subdiretório contendo o arquivo de receita e quaisquer scripts de apoio.

~/.config/fp-appimage-updater/
├── config.yml
└── apps/
    ├── hydra-launcher.yml
    └── hayase/
        ├── hayase.yml
        └── resolver.sh

Use um subdiretório quando seu app precisar de um script resolver.sh personalizado para a estratégia script. Coloque a receita e o script juntos no subdiretório para que script_path permaneça um caminho relativo limpo como ./resolver.sh.

Campos

name

string

obrigatório

Identificador único para o app. Usado como base do nome do arquivo, nome do symlink e nome de exibição na saída da CLI. Deve ser único entre todas as suas receitas.

strategy

object

obrigatório

Define como fp-appimage-updater encontra e baixa atualizações. Veja estratégias de atualização para a referência completa e exemplos.

ignore

boolean

Ignora esta receita em check e update, e a mostra como ignorada em list. Isso é útil quando você quer manter o app na configuração sem que o fp-appimage-updater mexa nele.

integration

boolean

Sobrescreve a configuração global manage_desktop_files para este app. Defina como false para pular a extração de arquivos .desktop e ícones para apps que não enviam um manifesto de desktop AppImage adequado.

create_symlink

boolean

Sobrescreve a configuração global create_symlinks para este app.

segmented_downloads

boolean

Sobrescreve a configuração global segmented_downloads para este app. Defina como false para servidores que não suportam requisições HTTP range.

respect_rate_limits

boolean

Sobrescreve a configuração global respect_rate_limits para este app. Quando definido como false, fp-appimage-updater sempre tenta a requisição mesmo se uma janela anterior de limite de taxa ainda não tiver expirado.

github_proxy

boolean

Sobrescreve a configuração global github_proxy para este app.

github_proxy_prefix

string | string[]

Sobrescreve a configuração global github_proxy_prefix para este app. Aceita uma única string de URL, uma lista de URLs ou all.

storage_dir

string

Sobrescreve o storage_dir global para este app. O arquivo AppImage é armazenado nesse diretório em vez do padrão global.

naming_format

string

Sobrescreve o naming_format global para este app. Placeholders suportados: {name} e {version}.

inner_asset_match

string

Padrão opcional para encontrar uma AppImage específica dentro de um arquivo .zip. Se omitido, o updater encontra automaticamente arquivos que terminam em .AppImage ou que contêm magic bytes ELF.

zsync

boolean | string

Habilita downloads delta zsync para este app. Defina como true para permitir que fp-appimage-updater detecte a URL zsync automaticamente, ou forneça uma string de URL zsync direta para usar um endpoint específico.

# Auto-detect zsync URL
zsync: true

# Explicit zsync URL
zsync: "https://example.com/app.AppImage.zsync"

Usa o backend integrado zsync-rs, então nenhum pacote de sistema zsync separado é necessário.

Exemplos

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

Receita Avançada

Este exemplo mostra uma receita usando várias sobrescritas para personalizar o armazenamento, a nomenclatura e o comportamento de download:

curseforge.yml

name: curseforge
storage_dir: ~/Games/AppImages
naming_format: "CurseForge-{version}.AppImage"
create_symlink: true
segmented_downloads: false
zsync: true
strategy:
  strategy: direct
  url: "https://curseforge.overwolf.com/downloads/curseforge-latest-linux.AppImage"
  check_method: last-modified

Gere um esqueleto de receita para um novo app com:

fp-appimage-updater init --app <name> --strategy <forge|direct|script>

Use --force para sobrescrever um arquivo de receita existente.

Documentation Index

​Onde as receitas ficam

​Campos

​Exemplos

​Receita Avançada

Onde as receitas ficam

Campos

Exemplos

Receita Avançada