R CMD INSTALL to install the package. Will also try to install
dependencies of the package from CRAN, if they're not already installed.
install(pkg = ".", reload = TRUE, quick = FALSE, build = !quick, args = getOption("devtools.install.args"), quiet = FALSE, dependencies = NA, upgrade = "ask", build_vignettes = FALSE, keep_source = getOption("keep.source.pkgs"), force = FALSE, ...)
package description, can be path or package name. See
as.package() for more information
TRUE (the default), will automatically reload the
package after installing.
TRUE skips docs, multiple-architectures,
demos, and vignettes, to make installation as fast as possible.
pkgbuild::build()s the package first:
this ensures that the installation is completely clean, and prevents any
binary artefacts (like
.so) from appearing in your local
package directory, but is considerably slower, because every compile has
to start from scratch.
An optional character vector of additional command line
arguments to be passed to
R CMD INSTALL. This defaults to the
value of the option
TRUE, suppress output.
Which dependencies do you want to check? Can be a character vector (selecting from "Depends", "Imports", "LinkingTo", "Suggests", or "Enhances"), or a logical vector.
TRUE is shorthand for "Depends", "Imports", "LinkingTo" and
NA is shorthand for "Depends", "Imports" and "LinkingTo"
and is the default.
FALSE is shorthand for no dependencies (i.e.
just check this package, not its dependencies).
One of "ask", "always" or "never". "ask" prompts the user for
which out of date packages to upgrade. For non-interactive sessions "ask" is
equivalent to "always".
FALSE are also accepted and
correspond to "always" and "never" respectively.
TRUE, will build vignettes. Normally it is
build that's responsible for creating vignettes; this argument makes
sure vignettes are built even if a build never happens (i.e. because
local = TRUE).
TRUE will keep the srcrefs from an installed
package. This is useful for debugging (especially inside of RStudio).
It defaults to the option
Force installation, even if the remote state has not changed since the previous install.
additional arguments passed to
when installing dependencies.
By default, installation takes place using the current package directory.
If you have compiled code, this means that artefacts of compilation will be
created in the
src/ directory. If you want to avoid this, you can
build = TRUE to first build a package bundle and then install
it from a temporary directory. This is slower, but keeps the source
If the package is loaded, it will be reloaded after installation. This is
not always completely possible, see
reload() for caveats.
To install a package in a non-default library, use
Other package installation: