Rebuild the Packages in your Project Library

Rebuild and reinstall packages in your library. This can be useful as a diagnostic tool -- for example, if you find that one or more of your packages fail to load, and you want to ensure that you are starting from a clean slate.

rebuild(
  packages = NULL,
  recursive = TRUE,
  ...,
  prompt = interactive(),
  library = NULL,
  project = NULL
)

Arguments

packages	The package(s) to be rebuilt. When NULL, all packages in the library will be installed.
recursive	Boolean; should dependencies of packages be rebuilt recursively? Defaults to TRUE.
...	Unused arguments, reserved for future expansion. If any arguments are matched to ..., renv will signal an error.
prompt	Boolean; prompt the user before taking any action? For backwards compatibility, confirm is accepted as an alias for prompt.
library	The R library to be used. When NULL, the active project library will be used instead.
project	The project directory. If NULL, then the active project will be used. If no project is currently active, then the current working directory is used instead.

Value

A named list of package records which were installed by renv.

Details

Note that binaries will be used when appropriate and available for your platform. If you'd like to force packages to be rebuilt from sources, you can set options(pkgType = "source").

Examples

if (FALSE) {

# rebuild the 'dplyr' package + all of its dependencies
renv::rebuild("dplyr", recursive = TRUE)

# rebuild only 'dplyr'
renv::rebuild("dplyr", recursive = FALSE)

}