AUR Guia do Usuario
From ArchWiki
Contents |
Propósito
O ArchLinux User-community Repository (AUR) (Repositório dos Usuários-Comunidade Archlinux) é um repositório mantido pela comunidade para usuários do Arch. Esse documento mostra ao usuário normal como acessar o AUR e trabalhar com ele.
O Usuário e o AUR
O usuário comum desempenha um papel essencial na AUR e sem o suporte, envolvimento e contribuição da extensa comunidade de usuários a AUR não consegue atingir seu potencial. O ciclo de vida de um pacote da AUR começa e termina com o usuário e requer do usuário contribuições de várias formas.
Compartilhando PKGBUILDs no AUR
Usuários podem compartilhar PKGBUILDs usando a área UNSUPPORTED no AUR. O AUR não contém nenhum pacote binário mas permite aos usuários enviar PKGBUILDS que podem ser baixados por outros usuários. Existe um serviço de comentários que permite aos usuários submeter informações sobre melhorias e sugestões a quem contribui para o PKGBUILD. Um novo sistema de marcação foi introduzido, que permite aos TUs especificar pacotes que foram verificados contra códigos maliciosos. Contudo, esses PKGBUILDs são totalmente não-oficiais e sem qualquer verificação cuidadosa; portanto, devem ser usados com cuidado e por sua própria conta e risco.
Não existe ainda nenhum mecanismo oficial para download de material para compilação direto do UNSUPPORTED mas alguns scripts podem ser encontrados no wiki.
[community]
O repositório [community] é um suplemento para os repositórios [extra] e [current], onde os pacotes mais populares são mantidos por Trusted Users (usuários que já possuem algum tempo de casa e reputação) que representam o resto dos usuários. O repositório [community], diferentemente de UNSUPPORTED, contém pacotes binários que podem ser instalados diretamente pelo pacman e os arquivos de build também podem ser acessados pelo ABS. Alguns desses pacotes podem eventualmente representar a transição dos repositórios [current] ou [extra] pelo fato dos desenvolvedores considerá-los cruciais para a distribuição.
Usuários podem acessar o repositório AUR [community] adicionando/descomentando a seguinte linha no arquivo /etc/pacman.conf:
Include = /etc/pacman.d/community
Se o arquivo /etc/pacman.d/community
não existir então ele deverá ser criado manualmente, contendo o seguinte texto:
[community] Server = ftp://ftp.archlinux.org/community/os/i686/
Os usuários também podem acessar os arquivos de build do [community] editando o arquivo /etc/abs.conf
da seguinte forma:
REPOS=(core extra community)
Votando
Uma das atividades mais fáceis para todos os usuários Arch é navegar pela AUR e votar nos seus pacotes favoritos usando a interface online. Pacotes que recebem 25 votos ou mais poderão ser adotados por um TU para inclusão no repositório [community], permitindo a todos o acesso aos binários - é interesse de todos votar nos seus favoritos!
Como usar o AUR
Usando pacotes do UNSUPPORTED
Para instalar um pacote do UNSUPORTED você deve seguir estes passos:
- localize a aplicação no AUR usando a ferramenta de busca (aqui usaremos foo como exemplo de nome de pacote) e clique no nome do pacote na lista de resultados. Isto o levará à página de informações do pacote. Do lado esquerdo você verá dois links lado a lado:
Tarball :: Files
- Clique
Tarball
para baixar os arqivos de construção necessários para o seu disco rígido. Este poderia ser chamado defoo.tar.gz
, por exemplo, se ele tiver sido corretamente submetido. - Copie o tarball
foo.tar.gz
para o diretório de construção p.ex./var/abs/local
e o descompacte. Isto deve criar um novo diretório,/var/abs/local/foo
que contém todos os arquivos necessários para a construção do pacote. - IMPORTANTE: entre no diretório recém criado e procure cuidadosamente no PKGBUILD e em qualquer arquivo .install por comandos maliciosos - se tiver dúvidas quanto a isso NÂO construa o pacote e procure orientação nos fóruns ou lista de discussão.
- Sugere-se que você use o
fakeroot
para construir pacotes (veja abaixo). Após ter confirmado manualmente a integridade dos arquivos, simplesmente executemakepkg
como usuário comum no diretório de construção. Os arquivos fonte serão baixados, verificados e construídos normalmente.
Usando fakeroot
fakeroot
simplesmente possibilita a um usuário normal ter as permissões de root necessárias para criar pacotes no ambiente de construção sem ser capaz de alterar o sistema todo. Se o processo de construção tenta alterar arquivos fora do ambiente de construção, erros são produzidos e o processo falha - isto é muito útil para verificar a qualidade/segurança/integridade dos PKGBUILDs a serem distribuídos. Por "default" export USE_FAKEROOT="y"
está incluído em /etc/makepkg.conf
, assim, exceto se você o tiver desligado, ele já está habilitado.
Submetendo Pacotes para o UNSUPPORTED
Após logar na interface web do AUR, um usuário pode submeter uma "tarball" (tar.gz) de um diretório contendo arquivos de construção para um pacote. O diretório dentro da "tarball" deve conter um PKGBUILD, qualquer arquivo .install, "patches", etc (ABSOLUTAMENTE nenhum binário). Exemplos de como um diretório desses deve parecer podem ser vistos dentro de /var/abs.
Quando submeter um pacote, observe as seguintes regras:
- Verifique em [extra], [current], UNSUPPORTED, and [community] se o pacote já existe. Se ele está em qualquer desses repositórios, sob QUALQUER forma, NÃO submeta o pacote (se o pacote já existente estiver quebrado ou faltando alguma propriedade, por favor envie um relatório de "bug" no FlySpray).
- Verifique cuidadosamente se o que você está enviando está correto. Todos os contribuidores devem ler e aderir aos Padrões de Empacotamento do Arch quando escreverem PKGBUILDs. Isto é essencial para o bom andamento e sucesso geral do AUR. Lembre-se de que você não ganhará qualquer crédito ou respeito dos seus colegas por desperdiçar o tempo deles com um PKGBUILD ruim.
- Pacotes que contenham binários ou que são muito mal escritos poderão ser excluídos sem aviso prévio.
- Se você estiver inseguro sobre o pacote (ou o processo de construção/envio) por qualquer motivo, envie o PKGBUILD para a lista de discussão do AUR ou aos grupos sobre o AUR no forum, para revisão pública antes de adicioná-lo ao AUR.
- Certifique-se de que o pacote é útil. Alguém além de você vai querer usá-lo? Ele é muito especializado? Se mais do que umas poucas pessoas acharem-no útil, ele é apropriado para envio.
- Ganhe alguma experiência antes de submeter pacotes. Construa alguns par aprender o processo e então submeta.
Mantendo Pacotes no UNSUPPORTED
- Verifique os comentários de outros usuários e tente incorporar as melhorias que eles sugeremCheck for feedback and comments from other users and try to incorporate any improvements they suggest; consider it a learning process!
- Por favor JAMAIS submeta um pacote e o largue pra lá em seguida! Enquanto estiver no UNSUPPORTED, é função do usuário manter o pacote, verificando atualizações e melhorando o PKGBUILD.
- Se você não quer continuar mantendo o pacote por alguma razão,
disown [abandone]
o pacote usando a interface web do AUR e/ou envie mensagem para a lista de discussão do AUR.