flatpak - Crie, instale e execute aplicativos e tempos de execução
SINTAXE
flatpak [OPÇÃO...] {COMANDO}
DESCRIÇÃO
Flatpak é uma ferramenta para gerenciar aplicativos e os tempos de execução que eles usam. No modelo Flatpak, os aplicativos podem ser criados e distribuídos independentemente do sistema host em que são usados, e eles são isolados do sistema host ('em sandbox') até certo ponto, em tempo de execução.
Flatpak pode operar em modo de sistema ou por usuário. Os dados de todo o sistema (tempos de execução, aplicativos e configuração) estão localizados em $prefix/var/lib/flatpak/ e os dados por usuário estão em $HOME/.local/share/flatpak/. Abaixo dessas localizações, há um repositório local no subdiretório repo/ e tempos de execução e aplicativos instalados estão nos subdiretórios runtime/ e app/ correspondentes.
Os remotos de todo o sistema podem ser pré-configurados estaticamente, incluindo arquivos flatpakrepo(5) em /usr/share/flatpak/remotes.d/ e /etc/flatpak/remotes.d/. Se um arquivo com o mesmo nome existir em ambos, o arquivo em /etc terá precedência.
Além da instalação de todo o sistema em $prefix/var/lib/flatpak/, que sempre é considerado o padrão, a menos que seja substituído, mais instalações de todo o sistema podem ser definidas por meio de arquivos de configuração em /etc/flatpak/installations.d/, que devem definir pelo menos o ID da instalação e o caminho absoluto para ela. Outros parâmetros opcionais, como DisplayName, Priority ou StorageType, também são suportados.
Flatpak usa OSTree para distribuir e implantar dados. Os repositórios que ele usa são repositórios OSTree e podem ser manipulados com o utilitário ostree. Os tempos de execução e aplicativos instalados são checkouts OSTree.
Os comandos básicos para construir flatpaks, como build-init, build e build-finish, estão incluídos no utilitário flatpak. Para suporte de construção de nível superior, consulte o utilitário separado flatpak-builder(1).
Flatpak oferece suporte à instalação a partir de repositórios sideload. Estes são cópias parciais de um repositório (geradas por flatpak create-usb) que são usadas como uma fonte de instalação quando offline (e online como uma melhoria de desempenho). Esses repositórios são configurados criando links simbólicos para os fontes sideload no subdiretório sideload-repos do diretório de instalação (por exemplo, /var/lib/flatpak/sideload-repos ou ~/.local/share/flatpak/sideload-repos). Além disso, links simbólicos podem ser criados em /run/flatpak/sideload-repos, que é uma localização melhor para fontes não persistentes (já que é limpo na reinicialização). Esses links simbólicos podem apontar para o diretório fornecido ao flatpak create-usb, que por padrão grava no subcaminho .ostree/repo, ou diretamente para um repositório ostree.
OPÇÕES
As seguintes opções globais são reconhecidas. Comandos individuais têm suas próprias opções.
-h, --help
Mostra as opções de ajuda e sai.
-v, --verbose
Mostra informações de depuração durante o processamento do comando. Use -vv para mais detalhes.
--ostree-verbose
Mostra informações de depuração do OSTree durante o processamento do comando.
--version
Imprime informações da versão e sai.
--default-arch
Imprime a arquitetura padrão e sai.
--supported-arches
Imprime as arquiteturas suportadas em ordem de prioridade e sai.
--gl-drivers
Imprime a lista de drivers GL ativos e sai.
--installations
Imprime os caminhos das instalações do sistema e sai.
--print-system-only
Quando o comando flatpak --print-updated-env é executado, imprime apenas o ambiente para as instalações do sistema Flatpak, não incluindo a instalação na pasta pessoal do usuário.
--print-updated-env
Imprime o conjunto de variáveis de ambiente necessárias para usar os Flatpaks, modificando o conjunto atual de variáveis de ambiente. Isso deve ser usado em um gerador de ambiente systemd e não deve ser executado manualmente.
COMANDOS
Comandos para gerenciar aplicativos e runtimes instalados:
flatpak-install(1)
Instala um aplicativo ou um runtime de um repositório remoto ou pacote.
flatpak-update(1)
Atualiza um aplicativo ou runtime instalado.
flatpak-uninstall(1)
Desinstala um aplicativo ou runtime instalado.
flatpak-mask(1)
Impede atualizações e instalação automática.
flatpak-pin(1)
Fixa runtimes para evitar a remoção automática.
flatpak-list(1)
Lista os aplicativos e/ou runtimes instalados.
flatpak-info(1)
Mostra informações sobre um aplicativo ou runtime instalado.
flatpak-history(1)
Mostra o histórico.
flatpak-config(1)
Gerencia a configuração do Flatpak.
flatpak-repair(1)
Repara a instalação do Flatpak.
flatpak-create-usb(1)
Copia aplicativos e/ou runtimes para mídia removível.
Comandos para encontrar aplicativos e runtimes:
flatpak-search(1)
Pesquisa aplicativos e runtimes.
Comandos para gerenciar aplicativos em execução:
flatpak-run(1)
Executa um aplicativo.
flatpak-kill(1)
Interrompe um aplicativo em execução.
flatpak-override(1)
Substitui as permissões de um aplicativo.
flatpak-make-current(1)
Especifica a versão padrão a ser executada.
flatpak-enter(1)
Entra no namespace de um aplicativo em execução.
Comandos para gerenciar o acesso a arquivos:
flatpak-document-export(1)
Concede a um aplicativo acesso a um arquivo específico.
flatpak-document-unexport(1)
Revoga o acesso a um arquivo específico.
flatpak-document-info(1)
Mostra informações sobre um arquivo específico.
flatpak-documents(1)
Lista os arquivos exportados.
Comandos para gerenciar o armazenamento dinâmico de permissões:
flatpak-permission-remove(1)
Remove um item do armazenamento de permissões.
flatpak-permissions(1)
Lista as permissões.
flatpak-permission-show(1)
Mostra as permissões do aplicativo.
flatpak-permission-reset(1)
Redefine as permissões do aplicativo.
flatpak-permission-set(1)
Define as permissões do aplicativo.
Comandos para gerenciar repositórios remotos:
flatpak-remotes(1)
Lista todos os repositórios remotos configurados.
flatpak-remote-add(1)
Adiciona um novo repositório remoto.
flatpak-remote-modify(1)
Modifica as propriedades de um repositório remoto configurado.
flatpak-remote-delete(1)
Exclui um repositório remoto configurado.
flatpak-remote-ls(1)
Lista o conteúdo de um repositório remoto configurado.
flatpak-remote-info(1)
Mostra informações sobre uma referência em um repositório remoto configurado.
Comandos para construir aplicações:
flatpak-build-init(1)
Inicializa um diretório de construção.
flatpak-build(1)
Executa um comando de construção em um diretório de construção.
flatpak-build-finish(1)
Finaliza um diretório de construção para exportação.
flatpak-build-export(1)
Exporta um diretório de construção para um repositório.
flatpak-build-bundle(1)
Cria um arquivo de pacote a partir de uma referência em um repositório local.
flatpak-build-import-bundle(1)
Importa um arquivo de pacote para um repositório local.
flatpak-build-sign(1)
Assina uma aplicação ou runtime após a sua exportação.
flatpak-build-update-repo(1)
Atualiza o arquivo de resumo em um repositório.
flatpak-build-commit-from(1)
Cria uma nova confirmação com base em uma referência existente.
flatpak-repo(1)
Imprime informações sobre um repositório.
Comandos disponíveis dentro do sandbox:
flatpak-spawn(1)
Executa um comando em outro sandbox.
FORMATOS DE ARQUIVO
Formatos de arquivo que são usados pelos comandos Flatpak:
flatpakref(5)
Referência a um remoto para uma aplicação ou runtime.
flatpakrepo(5)
Referência a um remoto.
flatpak-remote(5)
Configuração para um remoto.
flatpak-installation(5)
Configuração para um local de instalação.
flatpak-metadata(5)
Informações sobre uma aplicação ou runtime.
AMBIENTE
Além das variáveis de ambiente padrão, como XDG_DATA_DIRS e XDG_DATA_HOME, o Flatpak consulta algumas de suas próprias variáveis.
FLATPAK_BINARY
Caminho para o executável flatpak que será gravado nos arquivos .desktop e scripts exportados quando um aplicativo é instalado. O padrão é /usr/bin/flatpak, a menos que seja substituído no momento da construção por --bindir.
FLATPAK_BWRAP
Caminho para o executável bwrap(1) que será usado para criar o sandbox. Dependendo de como o Flatpak foi configurado no momento da construção, o padrão é procurar no PATH ou usar uma cópia fornecida, que normalmente é instalada como /usr/libexec/flatpak-bwrap.
FLATPAK_CONFIG_DIR
O local da configuração do site Flatpak. Se isso não estiver definido, /etc/flatpak será usado (a menos que substituído no momento da construção por --sysconfdir).
FLATPAK_DATA_DIR
O local dos padrões do sistema operacional do Flatpak e dos ganchos de integração. Se isso não estiver definido, /usr/share/flatpak será usado, a menos que seja substituído no momento da construção por --datadir.
FLATPAK_DBUSPROXY
Caminho para o executável xdg-dbus-proxy(1) que será usado para filtrar o tráfego D-Bus entre o sandbox e o sistema host. Dependendo de como o Flatpak foi configurado no momento da construção, o padrão é procurar no PATH ou usar uma cópia fornecida, que normalmente é instalada como /usr/libexec/flatpak-dbus-proxy.
FLATPAK_DOWNLOAD_TMPDIR
Caminho para um diretório que será usado temporariamente ao baixar camadas OCI e potencialmente para outros downloads no futuro. O TMPDIR padrão não é usado para isso, porque os aplicativos Flatpak geralmente são grandes demais para caber em um tmpfs.
FLATPAK_FANCY_OUTPUT
Pode ser definido como 0 para evitar a formatação sofisticada ao exibir no terminal. Este recurso também é desativado automaticamente quando a saída padrão não é um terminal, ou quando G_MESSAGES_DEBUG está definido.
FLATPAK_FORCE_TEXT_AUTH
Pode ser definido como 1 para forçar o uso de um agente polkit(8) simples integrado quando a autenticação é necessária para modificar a instalação em todo o sistema. Por padrão, o agente polkit do ambiente de desktop é usado, se disponível, resultando normalmente em um prompt gráfico.
FLATPAK_GL_DRIVERS
Uma lista separada por dois pontos de extensões de driver gráfico a serem usadas para OpenGL, Vulkan e APIs semelhantes, da mais preferida para a menos. O padrão é selecionar um driver gráfico automaticamente. Os valores nesta lista correspondem ao último componente separado por ponto dos nomes das extensões com a condição active-gl-driver. Valores típicos são default, mesa-git ou nvidia-550-120 (substituindo o número da versão pela versão principal e secundária do módulo do kernel nvidia).
FLATPAK_RUN_DIR
O local dos arquivos globais de tempo de execução do flatpak. Se isso não for definido, /run/flatpak será usado.
FLATPAK_SYSTEM_CACHE_DIR
O local onde os repositórios filho temporários serão criados durante os pulls para a instalação em todo o sistema. Se isso não for definido, um diretório em /var/tmp/ será usado. Isso é útil porque é mais provável que esteja no mesmo sistema de arquivos do repositório do sistema (aumentando assim as chances de, por exemplo, cópia de reflink) e podemos evitar preencher o diretório pessoal do usuário com dados temporários.
FLATPAK_SYSTEM_DIR
O local da instalação padrão em todo o sistema. Se isso não for definido, /var/lib/flatpak será usado (a menos que seja substituído no momento da construção por --localstatedir ou -Dsystem_install_dir).
FLATPAK_TTY_PROGRESS
Pode ser definido como 1 para habilitar o relatório de progresso legível por máquina para o terminal. Este recurso não está habilitado por padrão porque usa a sequência OSC 9; 4, que alguns emuladores de terminal interpretam como uma notificação pop-up.
FLATPAK_USER_DIR
O local da instalação por usuário. Se isso não for definido, $XDG_DATA_HOME/flatpak será usado.
VEJA TAMBÉM
ostree(1), ostree.repo(5), flatpak-remote(5), flatpak-installation(5), https://www.flatpak.org