37 Construindo pacotes
Os passos básicos para contrução de um pacote são listados a seguir.
-
1.
- Abra uma sessão do R e coloque na sua área de trabalho todas as funções e conjunto de
dados que deseja incluir no pacote. Tome o cuidade de remover todos os demais objetos
que não devem ser incluídos no pacote.
-
2.
- No "prompt"do R use package.skeleton() para gerar um diretório com a estrutura de
diretórios mínima requirida para pacotes. Por exemplo, se o seu pacote for se chamar meupack
use o comando abaixo. Certifique-se que o diretório a ser criado ainda não existe no seu diretório
de trabalho.
> package.skeleton(name="meupack")
-
3.
- No diretório criado voce vai encontrar:
- O arquivo DESCRIPTION que contém uma descrição básica do seu pacote. Edite este
arquivo tomando cuidado para não alterar a estrutura do mesmo
- O subdiretório data que contém os conjuntos de dados que estavam em seu
"workspace". Voce não precisa fazer nada neste diretório.
- O subdiretório man que contém a documantação de seu pacote com um arquivo para
cada função e conjunto de dados de seu pacote. Abra cada um dos arquivos em um
editor de arquivos texto e edite a documentação, preservando o formato do arquivo.
- O subdiretório R contém arquivos com as funções em R de seu pacote. Voce não
precisa fazer nada neste diretório a menos que vá usar código compilado em seu
pacote (ver mais detalhes a seguir).
- O subdiretório src somente será usado caso o seu pacote vá usar códigos em C, C++
ou Fortran. Se este for o caso voce deve colocar neste subdiretório os arquivos fontes
nestas linguagens.
-
4.
- Caso o seu pacote vá usar códigos em C, C++ ou Fortran coloque um arquivo com o nome zzz.R
no sibdiretório R com o seguinte conteúdo
".First.lib" <- function(lib, pkg)
{
library.dynam("Embrapa", package = pkg, lib.loc = lib)
return(invisible(0))
}
-
5.
- Para testar o seu pacote voce pode usar na linha de comando:
R CMD check meupack
-
6.
- Para montar o arquivo fonte .tar.gz de distribuição co pacote use o comando a seguir. O
arquivo criando pode ser usado de forma padrão para instalar pacotes no R a partir do arquivo
fonte do pacote.
R CMD build meupack
Durante o curso foi demonstrado como construir pacotes no R. O pacote montado durante as aulas
está disponível neste link e voce pode inspecionar o conteúdo para ver um exemplo de criação de
pacote.
As passos listados aqui são bastante simplificados e são simplesmente o mínimo necessário para
criação de pacotes. Diversos outros recursos estão disponíveis e para maiores e mais detalhadas
informações sobre como construir pacotes consulte o manual Writing R Extensions.