Flatpak (Português)
Do README do projeto: "Flatpak é um sistema para construção, distribuição e execução de aplicações desktop sandboxed no Linux."
De flatpak(1):
- Flatpak é uma ferramenta para gerenciar aplicações e os runtimes que elas usam. No modelo Flatpak, aplicações podem ser construídas e distribuídas independentemente do sistema hospedeiro em que elas estão usando, e elas são isoladas do sistema hospedeiro (‘sandboxed’) em algum grau, no runtime.
- Flatpak usa OSTree[link inativo 2024-10-12 ⓘ] para distribuir e implantar dados. Os repositórios que ele usa são repositórios OSTree e podem ser manipulados com a ferramenta ostree. Runtimes instalados e aplicações são checkouts do OSTree.
Instalação
flatpak-builder, você precisará instalar as dependências opcionais elfutils e patch.Gerenciar repositórios
--user a cada comando. Se você deseja, por exemplo, adicionar um repositório visível apenas para você, execute flatpak remote-add --user nome localização. Para instalar um pacote visível apenas para você, execute flatpak install --user nome-pacote.Adicionar um repositório
Para adicionar um repositório flatpak remoto faça:
$ flatpak remote-add nome localização
onde nome é o nome do novo remoto e localização é o caminho ou a URL do repositório.
Por exemplo, para adicionar o repositório oficial Flathub:
$ flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
Deletar repositórios
Para deletar um repositório flatpak remoto faça:
$ flatpak remote-delete nome
onde nome é o nome do repositório remoto a ser deletado.
Listar repositórios
Para listar todos os repositórios adicionados faça:
$ flatpak remotes
Gerenciar runtimes e aplicações
Procurar por um runtime ou aplicação
Antes de estar pronto para procurar por um runtime ou aplicação em um novo repositório remoto adicionado, nós precisamos recuperar os dados appstream. Para isso:
$ flatpak update
Procurando por atualizações... Atualizando dados appstream para remote nome
Então nós podemos proceder para procurar por um pacote com flatpak search nomedopacote, e.g. para procurar pelo pacote libreoffice com o flathub remoto configurado:
$ flatpak search libreoffice
ID de aplicativo Versão Ramo Remotos Descrição org.libreoffice.LibreOffice stable flathub The LibreOffice productivity suite
Listar todos os runtime ou aplicações disponíveis
Para listar todos os runtimes e aplicações disponíveis em um repositório remoto nomeado como remoto faça:
$ flatpak remote-ls remoto
Instalar um runtine ou aplicação
Para instalar umruntime ou aplicação faça:
$ flatpak install remoto nome
onde remoto é o nome do repositório remoto e nome é o nome da aplicação ou runtime a ser instalado.
flatpak install nome-parcial (por exemplo flatpak install libreoffice).Listar os runtimes e aplicações instalados
Para listar os runtimes e aplicações instaladas faça:
$ flatpak list
Executar aplicações
Binários estão disponíveis em /var/lib/flatpak/exports/bin, o qual pode ser adicionado ao seu caminho:
$ PATH="/var/lib/flatpak/exports/bin:$PATH" $ org.libreoffice.LibreOffice --calc
Aplicações Flatpak também podem ser executadas com a linha de comando:
$ flatpak run nome
Atualizar um runtime ou aplicação
Para atualizar um runtime ou aplicação nomeada como nome faça:
$ flatpak update name
Desinstalar um runtime ou aplicação
Para desinstalar um runtime ou aplicação nomeado(a) como nome faça:
$ flatpak uninstall name
flatpak unsinstall --unused.Flatpak espera que o gerenciador de janelas respeite a variável de ambiente XDG_DATA_DIRS para descobrir aplicações. Isso pode requerer que a sessão seja reiniciada ou o lançador pode não suportar isso. Nesse caso, onde você pode editar a lista de diretórios escaneados, adicionar isso a ela:
~/.local/share/flatpak/exports/share/applications /var/lib/flatpak/exports/share/applications
Isso é sabidamente necessário no Awesome.
Vendo as permissões sandbox da aplicação
Aplicações Flatpak vêm com regras sandbox pré-definidas que definem quais os recursos e os caminhos do sistema de arquivos a aplicação tem permissão para acessar. Para ver as permissões de uma aplicação específica faça:
$ flatpak info --show-permissions name
A referência para os nomes das permissões sandbox podem ser encontradas na documentação oficial do Flatpak.[link inativo 2024-07-30 ⓘ]
Sobrescrevendo permissões sandbox de aplicações
Se você acha que as permissões pré-definidas da aplicação é muito permissiva ou muito restritiva, você pode mudar para qualquer uma que quiser usando o comando flatpak override.
Por exemplo:
$ flatpak override --nofilesystem=home name
Isso irá prevenir que a aplicação acesse a sua pasta home.
Todo tipo de permissão como dispositivo, sistema de arquivo ou soquete tem um uma linha de comando que permite aquela permissão em particular e uma opção separada que nega. Por exemplo, no caso de acesso ao dispositivo --device=device_nome permite o acesso, --no-device=device_nome nega a permissão para acessar o dispositivo.
Para todos os tipos de comandos de permissão consulte a página de manual: flatpak-override(1).
Substituições de permissão podem ser redefinidas para o padrão com o comando:
$ flatpak override --reset nome
Flatseal é um gerenciador de permissão por interface gráfica que oferece uma which offer simple point-and-click permissions operations.
Criar uma base de runtime customizada
- Você pode querer usar uma conta não confiável e desprivilegiadas para construir software não confiável porque o software não é sandboxed durante a criação do aplicativo e do runtime.
- Quando distribuindo pacotes para outros, você pode ser legalmente obrigado a fornecer o código fonte de alguns dos softwares empacotados mediante solicitação. Vocẽ ode querer usar ABS para construir tais pacotes a partir da fonte.
Você pode criar uma runtime base e uma SDK base customizada com base no Arch para Flatpak usando o pacman. Você pode, então, usá-las para criação e empacotamento de aplicações. Isso é uma alternativa para uso pessoal para o padrão org.freedesktop.BasePlatform e org.freedesktop.BaseSdk runtimes.
Em adição ao flatpak, você precisa ter instalado fakeroot e fakechroot, para suportar o pacman hooks.
Primeiro, comece criando um diretório para criação do runtime e, possivelmente, aplicações.
$ mkdir minhapastadecriacaoflatpak $ cd minhapastadecriacaoflatpak
Você pode, então, preparar o diretório para a criação da plataforma base do runtime. Os arquivos do subdiretório irão conter o que depois será o diretório /usr no sandbox. Portanto, você precisará criar links simbólicos para o padrão /etc/share etc. do Arch ainda possa ser acessado no caminho usual.
$ mkdir -p meuruntime/files/var/lib/pacman $ touch meuruntime/files/.ref $ ln -s /usr/usr/share meuruntime/files/share $ ln -s /usr/usr/include meuruntime/files/include $ ln -s /usr/usr/local meuruntime/files/local
Certifique-se que as fontes disponíveis pelo seu sistema operacional host para o runtime do Arch:
$ mkdir -p meuruntime/files/usr/share/fonts $ ln -s /run/host/fonts meuruntime/files/usr/share/fonts/flatpakhostfonts
Você precisa e talvez queira adaptar o seu pacman.conf antes de instalar pacotes no runtime. Copie o /etc/pacman.conf para o seu diretório de criação e então faça as seguintes mudanças:
- Remova a opção
CheckSpacee então o pacman não reclamará sobre erros ao encontrar a raiz do sistema de arquivo para checar o espaço de disco. - Remova quaisquer repositórios customizados indesejados e as configurações
IgnorePkg,IgnoreGroup,NoUpgradeeNoExtract, que são necessárias somente para o sistema hospedeiro.
Agora instale os pacotes para o runtime.
$ fakechroot fakeroot pacman -Syu --root meuruntime/files --dbpath meuruntime/files/var/lib/pacman --config pacman.conf base $ mv pacman.conf meuruntime/files/etc/pacman.conf
Configure os locales a serem usados editando meuruntime/files/etc/locale.gen. Então, gere novamente os locales do runtime.
$ fakechroot chroot meuruntime/files locale-gen
A SDK base pode ser criada a partir da base runtime com adição de aplicações necessárias para a criação de pacotes e executar o pacman.
$ cp -r meuruntime mysdk $ fakechroot fakeroot pacman -S --root mysdk/files --dbpath mysdk/files/var/lib/pacman --config meusdk/files/etc/pacman.conf base-devel fakeroot fakechroot --needed
Insira metadados sobre runtime e SDK.
meuruntime/metadados
[Runtime] name=org.meudominio.BasePlatform runtime=org.meudominio.BasePlatform/x86_64/2016-06-26 sdk=org.meudominio.BaseSdk/x86_64/2016-06-26
meusdk/metadados
[Runtime] name=org.meudominio.BaseSdk runtime=org.meudominio.BasePlatform/x86_64/2016-06-26 sdk=org.meudominio.BaseSdk/x86_64/2016-06-26
Adicione as bases runtime e SDK para um repositório local no diretório atual. Você pode querer dar para eles mensagens commit apropriadas como, por exemplo, “Minha runtime base Arch” e “Minha SDK base Arch”.
$ ostree init --mode archive-z2 --repo=. $ EDITOR="nano -w" ostree commit -b runtime/org.meudominio.BasePlatform/x86_64/2016-06-26 --tree=dir=meuruntime $ EDITOR="nano -w" ostree commit -b runtime/org.meudominio.BaseSdk/x86_64/2016-06-26 --tree=dir=meusdk $ ostree summary -u
Instale o runtime e o SDK.
$ flatpak remote-add --user --no-gpg-verify myarchos file://$(pwd) $ flatpak install --user myarchos org.meudominio.BasePlatform 2016-06-26 $ flatpak install --user myarchos org.meudominio.BaseSdk 2016-06-26
Criar aplicativos com o pacman
Como uma alternativa para a criação de aplicação da forma comum, nós podemos usar o pacman para criar uma versão em contêiner dos pacotes comuns do Arch. Note que /usr é somente-leitura quando criando aplicativos, então nós não podemos usar os pacotes do Arch quando da criação de um app. Para criar um aplicativo real com o pacman, nós podemos também:
- Usar o pacman para criar um runtime contendo todas as dependências
- e compilar os aplicativos como de costume ou talvez usando o pacman para criar um PKGBUILD customizado e adaptado ao Flatpak, o qual usa
--prefix=/apppara o scriptconfigure,
ou nós podemos
- usar o pacman para criar o runtime contendo o aplicativo instalado com o pacman
- e criar um aplicativo dummy para executá-lo.
Por último, primeiro crie um runtime usando o pacman como esse para o gedit. O runtime é primeiramente inicializado e preparado para uso com o pacman.
$ flatpak build-init -w geditruntime org.meudominio.geditruntime org.meudominio.BaseSdk org.meudominio.BasePlatform 2016-06-26 $ flatpak build geditruntime sed -i "s/^#Server/Server/g" /etc/pacman.d/mirrorlist $ flatpak build geditruntime ln -s /usr/var/lib /var/lib $ flatpak build geditruntime fakeroot pacman-key --init $ flatpak build geditruntime fakeroot pacman-key --populate archlinux
Então o pacote está instalado. A conexão da rede hospedeira deve estar disponível para o pacman.
$ flatpak build --share=network geditruntime fakechroot fakeroot pacman --root /usr -S gedit
Você pode testar a aplicação antes de finalizar o runtime (sem o sandboxing apropriado).
$ flatpak build --socket=x11 geditruntime gedit
Agora termine criando o runtime e exporte-o para um novo repositório local. As chaves GnuPG do pacman têm permissões que podem interferir e precisam ser removidas primeiro.
$ flatpak build geditruntime rm -r /etc/pacman.d/gnupg $ flatpak build-finish geditruntime $ sed -i "s/\[Application\]/\[Runtime\]/;s/runtime=org.meudominio.BasePlatform/runtime=org.meudominio.geditruntime/" geditruntime/metadata $ flatpak build-export -r geditrepo geditruntime
Então crie o aplicativo dummy.
$ flatpak build-init geditapp org.gnome.gedit org.meudominio.BaseSdk org.meudominio.geditruntime
Agora termine criando o aplicativo dummy. Você pode ajustar as permissões de acesso quando sandboxed dando opções adicionais ao terminar de criar. Para possíveis opções veja a documentação do Flatpak e os arquivos de manifesto do GNOME. Alternativamente, adapte geditapp/metadata para as suas necessidades após terminar de criar, mas antes de exportar. Quando os arquivos de metadados estiver concluído, exporte o app para o repositório.
$ flatpak build-finish geditapp --socket=x11 [possivelmente outras opções] --command=gedit $ flatpak build-export geditrepo geditapp
Instale-o junto com o runtime.
$ flatpak --user remote-add --no-gpg-verify geditrepo geditrepo $ flatpak install --user geditrepo org.meudominio.geditruntime $ flatpak install --user geditrepo org.gnome.gedit $ flatpak run org.gnome.gedit