Arch Build System (Português) - ArchWiki

# Arch Build System (Português)

From ArchWiki
Status de tradução: Esse artigo é uma tradução de Arch Build System. Data da última tradução: 2018-09-18. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Artigos relacionados

- Padrões de empacotamento do Arch
- Arch User Repository
- Criando pacotes
- Compilação de kernel com ABS
- makepkg
- Repositórios oficiais
- pacman
- PKGBUILD
- Aplicando patches no ABS

O sistema de compilação do Arch (Arch build system) é um sistema tipo portação para compilar e empacotar software a partir do código-fonte. Enquanto o pacman é a ferramenta especializada do Arch para gerenciamento de pacote binário (incluindo pacotes compilados com o ABS), ABS é uma coleção de ferramentas para compilar o fonte em pacotes `.pkg.tar.xz` instaláveis.

Ports é um sistema usado por *BSD para automatizar o processo de compilação de software a partir do código-fonte. O sistema usa um port para baixar, descompactar, patch, compilar e instalar o software dado. Um port é meramente um pequeno diretório no computador do usuário, nomeado pelo software correspondente para ser instalado, que contém uns poucos arquivos com as instruções para compilar e instalar o software a partir dos fontes. Isso torna a instalação de softwares tão simples quanto digitar `make` ou `make install clean` dentro de diretório de portação.

ABS é um conceito similar. ABS é feito de uma árvore de diretórios que pode ser obtida (checkout) usando o SVN. Essa árvore representa, mas não contém, todos os softwares oficiais do Arch. Subdiretórios não contêm o pacote de software nem o fonte, e sim um arquivo PKGBUILD e, algumas vezes, outros arquivos. Ao executar makepkg dentro de um diretório contendo um PKGBUILD, o software é primeiro compilado e então empacotado dentro do diretório de compilação. Então, você pode usar pacman para instalar ou atualizar seu novo pacote.

## Visão geral de ABS

"ABS" pode ser usado como um termo guarda-chuva já que ele inclui e depende de vários outros componentes; portanto, apesar de tecnicamente impreciso, "ABS" pode ser referir às seguintes ferramentas como um kit de ferramentas completos:

Árvore SVN
  A estrutura de diretório contendo arquivos necessários para compilar todos os pacotes oficiais, mas não os pacotes em si nem os arquivos fontes do software. Ela está disponível nos repositórios svn e git.

PKGBUILD
  Um script Bash que contém a URL do código-fonte junto com as instruções de compilação e empacotamento.

makepkg
  Ferramenta de comando shell que lê os PKGBUILDs, baixa automaticamente e compila os fontes e cria um `.pkg.tar*` de acordo com o vetor `PKGEXT` no `makepkg.conf`. Você também pode usar makepkg para fazer seus próprios pacotes personalizados do AUR ou fontes de terceiros. Veja Criando pacotes para mais informações.

pacman
  pacman é completamente separado, mas é necessariamente invocado pelo makepkg ou manualmente, para instalar e remover os pacotes compilados e para obter dependências.

AUR
  O Arch User Repository é separado do ABS, mas PKGBUILDs do AUR (sem suporte) são compilados usando makepkg para compilar e empacotar software. Em contraste com a árvore do ABS em sua máquina local, o AUR existe como uma interface do website. Ele contém muitos milhares de PKGBUILDs contribuídos por usuários para software que está indisponível como um pacote oficial do Arch. Se você precisar compilar um pacote fora da árvore oficial do Arch, as chances são de que esteja no AUR.

Atenção: PKGBUILDs oficiais presumem que pacotes são compilados em um chroot limpo. Compilação de software em um sistema de compilação sujo pode falhar ou causar comportamentos inesperados em tempo de execução, porque se o sistema de compilação detecta dependências dinamicamente, o resultado depende de quais pacotes estão disponíveis no sistema de compilação.

### Árvore SVN

Os repositórios core, extra e testing estão no repositório SVN packages para checkout. Os repositórios community e multilib estão no repositório SVN community.

Cada pacote possui seu próprio subdiretório. Dentro dele há diretórios `repos` e `trunk`. `repos` é expandido por nome de repositório (ex.: core) e arquitetura. PKGBUILDs e arquivos localizados em `repos` são usados em compilações oficiais. Arquivos localizados no `trunk` são usados pelos desenvolvedores na preparação antes de serem copiados para `repos`.

Por exemplo, a árvore para acl se parece com isso:

    acl
    acl/repos
    acl/repos/core-i686
    acl/repos/core-i686/PKGBUILD
    acl/repos/core-x86_64
    acl/repos/core-x86_64/PKGBUILD
    acl/trunk
    acl/trunk/PKGBUILD

O código-fonte do pacote não está presente no diretório ABS. Em vez disso, o `PKGBUILD` contém uma URL que vai baixar o código-fonte quando o pacote é compilado.

## Por que eu iria querer usar o ABS?

O sistema de compilação do Arch é usado para:

- Compilar ou recompilar um pacote, para qualquer motivo
- Make e instalar novos pacotes de fontes de software para os quais nenhum pacote está instalado ainda (veja Criando pacotes)
- Personalizar pacotes existentes para atender suas necessidades (habilitar ou desabilitar opções, patching)
- Recompilar todo o seu sistema usando suas flags de compilador, "à la FreeBSD" (ex.: com pacman-src-gitAUR))
- Compilar e instalar, sem interferências, seu próprio kernel personalizado (veja Compilação de kernel)
- Fazer com que módulos de kernel funcionem com seu kernel personalizado
- Compilar e instalar facilmente uma versão mais nova, antiga, beta ou de desenvolvimento de um pacote do Arch editando o número de versão no PKGBUILD

ABS não é necessário para usar o Arch Linux, mas é útil para automatizar certas tarefas de compilação de fonte.

## Como usar o ABS

Para obter o PKGBUILD necessário para compilar um certo pacote a partir do fonte, você pode usar uma abordagem baseada em Svn ou Git usando o pacote asp que é uma interface para os repositórios svntogit. A seguir, o método baseado em svn, bem como o método baseado em git, é descrito.

### Obtendo fonte de PKGBUILD usando Svn

#### Pré-requisitos

Instale o pacote subversion.

#### Checkout não-recursivo

Atenção: Não baixe todo o repositório; siga apenas as instruções abaixo. O repositório SVN todo é gigantesco. Não apenas vai gastar uma quantidade absurda de espaço em disco, mas também vai ocupar o servidor do archlinux.org para você baixá-lo. Se você abusar desse serviço, seu endereço pode ser bloqueado. Nunca use o SVN público para qualquer tipo de scripting.

Para fazer checkout dos repositórios core, extra e testing:

    $ svn checkout --depth=empty svn://svn.archlinux.org/packages

Para fazer checkout dos repositórios community e multilib

    $ svn checkout --depth=empty svn://svn.archlinux.org/community

Em ambos casos, ele cria um diretório vazio, mas ele sabe que é um checkout de svn.

#### Fazer checkout de um pacote

No diretório contendo o repositório svn que você fez checkout (isto é, packages ou community), faça:

    $ svn update nome-pacote

Isso vai obter o pacote que você requisitou em seu checkout. Daqui para frente, toda vez que você executar svn update no nível superior, esse também será atualizado.

Se você especifica um pacote que não existe, svn não vai avisar você. Ele só vai mostrar algo como "At revision 115847", sem criar quaisquer arquivos. Se isso acontecer:

- verifique se o nome do pacote está escrito corretamente
- verifique se o pacote não foi movido para outro repositório (ex. do repositório community para o repositório principal)
- acesse https://www.archlinux.org/packages para ver se o pacote é compilado a partir de outro pacote base (por exemplo, python-tensorflow é compilado no PKGBUILD do tensorflow)

Dica: Para fazer checkout uma versão mais antiga de um pacote, veja #Faça checkout de uma versão anterior de um pacote.

Você deve atualizar periodicamente todos os pacotes baixados se você deseja realizar recompilações em revisões mais recentes dos repositórios. Para fazer isso, execute:

    $ svn update

### Obtendo fonte de PKGBUILD usando Git

Para clonar o repositório svntogit para um pacote específico, use:

    $ asp checkout nome-pacote

Isso vai clonar o repositório git para o pacote dado em um diretório com o nome do pacote.

Para atualizar o repositório git clonado, execute `asp update` seguido por `git pull` dentro do repositório git.

Em seguida, você pode usar todos os comandos git para realizar o checkout de uma versão antiga do pacote ou rastrear alterações personalizadas. Para mais informações sobre o uso de git, veja a página git.

Se você só deseja copiar um snapshot do PKGBUILD para um pacote específico, use:

    $ asp export nome-pacote

### Compilar pacote

Veja makepkg (Português)#Configuração sobre como configurar o makepkg para compilar pacotes dos PKGBUILDs que você fez checkout.

Em seguida, copie o diretório contendo o PKGBUILD que você deseja modificar para uma nova localização. Então, faça as modificações desejadas e use makepkg, como descrito em makepkg (Português)#Uso, para criar e instalar o novo pacote.

## Dicas e truques

### Preserve pacotes modificados

Atualizar o sistema com o pacman vai substituir um pacote modificado pelo ABS com o pacote de menos nome dos repositórios oficiais. Veja as instruções a seguir para como evitar isso.

Insira um vetor de grupo no PKGBUILD, e adicione o pacote para um grupo chamado `modified`.

    PKGBUILD

    groups=('modified')

Adicione esse grupo à seção `IgnoreGroup` no `/etc/pacman.conf`.

    /etc/pacman.conf

    IgnoreGroup = modified

Se novas versões estiverem disponíveis nos repositórios oficiais durante uma atualização de sistema, pacman emite uma nota de que ele está ignorando essa atualização porque ele está na seção IgnoreGroup. Neste ponto, o pacote modificado deve ser recompilado a partir do ABS para evitar atualizações parciais.

### Faça checkout de uma versão anterior de um pacote

Dentro do repositório svn que você faz checkout como descrito em #Checkout não-recursivo (isto é, "packages" ou "community"), primeiro examine o log:

    $ svn log nome-pacote

Descrita a revisão que você deseja examinando o histórico e especifique a revisão que você deseja fazer checkout. Por exemplo, para fazer checkout da revisão `r1729`, você faria:

    $ svn update -r1729 nome-pacote

Isso vai atualizar uma cópia de trabalho existente de nome-pacote para a revisão escolhida.

Você também pode especificar uma data. Se nenhuma revisão naquele dia existir, svn vai pegar o pacote mais recente antes daquele tempo. O seguinte exemplo faz checkout da revisão de 2009-03-03:

     $ svn update -r'{20090303}' nome-pacote

Também é possível fazer checkout de pacotes nas versões antes de eles terem sido movidos para um outro repositório; veja os logs pela data que eles foram movidos ou o número da última revisão.

## Outras ferramentas

- pbget - obtém PKGBUILDs de pacotes individuais diretamente da interface web. Inclui suporte ao AUR.
- asp - uma ferramenta para gerenciar a compilação de arquivos fontes usados para criar pacotes do Arch Linux. Usa a interface git que oferece fontes mais atualizados.

Categories:

- About Arch (Português)
- Package development (Português)
- Package management (Português)