---
url: /pt-br/guide/custom-packages.md
---
# Pacotes personalizados

`core` e `world` (veja [Pacotes disponíveis](/pt-br/guide/available-packages))
cobrem os pacotes que o `ps2build update` instala. Qualquer outra coisa, como uma biblioteca sua ou um projeto de terceiros, é instalada como pacote `world`.

## Instalando um

Baixe o zip da release do pacote e extraia em
`$PS2DEV/packages/world/<nome>/`, correspondendo ao `name:` que seu
`package.yaml` declara. Por exemplo, o zip de release do
[`ps2gl`](https://github.com/ps2build/ps2gl) extrai em
`$PS2DEV/packages/world/ps2gl/`. Depois disso ele pode ser usado em `libs:` como qualquer pacote de `core` ou `world`.

## Empacotando uma biblioteca

Um pacote é um diretório no formato `packages/world/<nome>/`, com um
`package.yaml` descrevendo seu conteúdo ao lado do resultado
compilado. Veja [Pacotes](/pt-br/guide/packages) para o esquema. Como esse diretório é produzido depende do sistema de build.

**Projetos CMake** são construídos contra `$PS2DEV/cmake/ps2dev.cmake`
como arquivo de toolchain (instalado automaticamente pelo `ps2build
update`), com `CMAKE_INSTALL_PREFIX` definido como
`packages/world/<nome>`. Um `package.yaml` é escrito à mão
descrevendo o que `cmake --install` produz.
[`ps2gl`](https://github.com/ps2build/ps2gl) e
[`ps2stuff`](https://github.com/ps2build/ps2stuff) seguem
ambos esse padrão, e seus arquivos `package.yaml` são exemplos funcionais.

**Projetos nativos do `ps2build`** (um `ps2.yaml` simples) mantêm um
`package.yaml` ao lado que nomeia os resultados da build a publicar. `ps2build install` constrói em um diretório temporário e
copia apenas o que o `package.yaml` nomeia para
`packages/world/<nome>`. [`audsrv`](https://github.com/ps2build/audsrv)
segue esse padrão.

**Publicando uma release**: o diretório `packages/world/<nome>/`
resultante é compactado e anexado a uma release. O próprio
[`.github/workflows`](https://github.com/ps2build/ps2gl/tree/master/.github/workflows)
do `ps2gl` faz isso a cada tag e serve de ponto de partida para o CI de
um novo pacote.

## Pacotes personalizados existentes