Provides functions used to build R packages. Locates compilers needed to build R packages on various platforms and ensures the PATH is configured appropriately so R can use them.
The goal of pkgbuild is to make it easy to build packages with compiled code. It provides tools to configure your R session, and check that everything is working ok. If you are using RStudio, it also helps you trigger automatic install of the build tools.
You can install pkgbuild from github with:
# install.packages("devtools")devtools::install_github("r-lib/pkgbuild")
# Check that you have the build tools installedpkgbuild::check_build_tools(debug = TRUE)# Build a packagepkgbuild::build("/path/to/my/package")# Run your own code in an environment guaranteed to# have build tools availablepkgbuild::with_build_tools(my_code)
build()
and compile_dll()
gain a register_routines
argument, to
automatically register C routines with
tools::package_native_routines_registration_skeleton()
(#50)
build()
will now warn if trying to build packages on R versions <= 3.4.2 on
Windows with a space in the R installation directory (#49)
build()
will now message if a build contains long paths, which are unsupported on windows
(#48)
compile_dll()
no longer doubles output, a regression caused by the styling callback.
(https://github.com/r-lib/devtools/issues/1877)
build()
output is now styled like that in the rcmdcheck package
(https://github.com/r-lib/devtools/issues/1874).
build()
no longer sets compile flags (#46)
compile_dll()
now does not supply compiler flags if there is an existing
user defined Makevars file.
local_build_tools()
function added to provide a deferred equivalent to
with_build_tools()
. So you can add rtools to the PATH until the end of a
function body.
Add metadata to support Rtools 3.5 (#38).
build()
only uses the --no-resave-data
argument in R CMD build
if the --resave-data
argument wasn't supplied by the user
(@theGreatWhiteShark, #26)
build()
now cleans existing vignette files in inst/doc
if they exist. (#10)
clean_dll()
also deletes symbols.rds
which is created when compile_dll()
is run inside of R CMD check
.
First argument of all functions is now path
rather than pkg
.