Node.js package guidelines (Português)
Esse documento cobre padrões e diretrizes de escrita PKGBUILDs para pacotes Node.js.
Nomenclatura de pacote
Nomes de pacote para bibliotecas do Node.js devem iniciar com um prefixo nodejs-
. Para aplicativos independentes, use apenas o nome do programa.
Usando npm
Ao instalar com npm, adicione-o como dependência de compilação:
makedepends=('npm')
Geralmente, não há necessidade de extrair o tarball:
noextract=("${pkgname}-${pkgver}.tgz")
Essa é uma função package mínima:
package() { npm install -g --prefix "${pkgdir}/usr" "${srcdir}/${pkgname}-${pkgver}.tgz" # Non-deterministic race in npm gives 777 permissions to random directories. # See https://github.com/npm/cli/issues/1103 for details. find "${pkgdir}/usr" -type d -exec chmod 755 {} + # npm gives ownership of ALL FILES to build user # https://bugs.archlinux.org/task/63396 chown -R root:root "${pkgdir}" }
Definindo um cache temporário
Quando o npm processa package.json
para compilar um pacote, ele baixa dependências para sua pasta de cache padrão em $HOME/.npm
. Para evitar encher a pasta pessoa do usuário, podemos definir temporariamente uma pasta de cache diferente com a opção --cache
.
Baixe as dependências para ${srcdir}/npm-cache
e instale-os no diretório do pacote:
npm install --cache "${srcdir}/npm-cache"
Continue com empacotamento de costume:
npm run packager
Pacote contém referência para $srcdir/$pkgdir
Infelizmente, o npm cria referências ao diretório de origem e ao diretório pkg. Este é um problema conhecido. No entanto, você pode remover essas referências manualmente, pois elas não são usadas de forma alguma.
Todas as dependências conterão uma referência a $pkgdir
, no atributo _where
. Você pode geralmente remover esses atributos com alguma magia do sed da seguinte forma:
find "$pkgdir" -name package.json -print0 | xargs -r -0 sed -i '/_where/d'
Seu pacote principal também terá outras referências. A maneira mais fácil de removê-los é remover todas as propriedades sublinhadas, mas isso não é tão fácil com o sed. Em vez disso, você pode usar jq para obter resultados semelhantes, como segue:
Outro lugar onde você pode encontrar referências a $pkgdir
são os atributos dos pacotes. Se você não se importa com as páginas man (elas não serão instaladas para dependências de qualquer maneira), você pode excluí-las assim:
Um exemplo de todas essas três técnicas pode ser visto em .
Usando nvm
Quando um aplicativo baseado em node.js requer uma versão diferente para compilamento ou empacotamento, nvmAUR pode ser aproveitado.
Adicione-o como uma dependência de compilação:
makedepends=('npm' 'nvm')
nvmAUR usa a variável de ambiente NVM_DIR
para procurar por seu prefixo, que é definido com se não especificado antes da inicialização do nvmAUR.
Você pode usar a seguinte função para criar e isolar seu prefixo personalizado da localização do usuário:
Esta função deve ser chamada antes de interagir com nvmAUR, ou outros programas baseados em node.js que devem usar a versão especificada.
Exemplo de uso em um PKGBUILD
Alternativamente, padrão vai procurar por uma string de versão no arquivo no diretório atual.
Um exemplo deste uso pode ser visto no .