Argumenty
pkgs
wektor znaków nazw pakietów, których aktualne wersje powinny zostać pobrane z repozytoriów.
Jeśli repos = NULL
, wektor znaków ścieżek do plików,
na windows,
ścieżki do plików .zip
zawierających binarne kompilacje pakietów. ( i
file://
URL są również akceptowane, a pliki zostaną pobrane i zainstalowane z lokalnych kopii). Katalogi źródłowe lub ścieżki do plików lub adresy URL archiwów mogą być podane z type = "source"
, ale niektóre pakiety wymagają zainstalowania odpowiednich narzędzi (zobacz sekcję 'Szczegóły’).
Na komputerach z systemem Unix,
te ścieżki do plików mogą być katalogami źródłowymi lub archiwami lub binarnymi plikami archiwów pakietów (jak utworzone przez R CMD build --binary
i
file://
adresy URL są również akceptowane, a pliki zostaną pobrane i zainstalowane z lokalnych kopii). Na CRAN build R dla macOS mogą to być .tgz
pliki zawierające archiwa pakietów binarnych. Tilde-expansion zostanie wykonany na ścieżkach do plików.
Jeśli tego brakuje, pole listy dostępnych pakietów jest prezentowane tam, gdzie to możliwe w interaktywnej sesji R.
lib
wektor znaków podający katalogi bibliotek, gdzie zainstalować pakiety. Recyklowany w razie potrzeby. Jeśli go brakuje, domyślnie jest to pierwszy element .libPaths()
.
repos
Może być NULL
do instalacji z lokalnych plików, katalogów lub adresów URL: będzie to wnioskowane przez rozszerzenie z pkgs
jeśli ma długość jeden.
contriburl
URL(s) sekcji contrib repozytoriów. Użyj tego argumentu jeśli mirror twojego repozytorium jest niekompletny, np. ponieważ wypaliłeś tylko sekcję contrib
na CD, lub masz tylko pakiety binarne. Nadpisuje argument repos
. Incompatible with type = "both"
.
method
download method, see download.file
. Unused if a non-NULL
available
is supplied.
available
a matrix as returned by available.packages
listing packages available at the repositories, or NULL
when the function makes an internal call to available.packages
. Incompatible with type = "both"
.
destdir
directory where downloaded packages are stored. If it is NULL
(the default) a subdirectory downloaded_packages
of the session temporary directory will be used (and the files will be deleted at the end of the session).
dependencies
Only supported if lib
is of length one (or missing), so it is unambiguous where to install the dependent packages. Jeśli tak nie jest, jest to ignorowane, z ostrzeżeniem.
Domyślnie, NA
, oznacza c("Depends", "Imports", "LinkingTo")
.
W tych wszystkich, "LinkingTo"
jest pomijany dla pakietów binarnych.
type
znak, wskazujący typ pakietu do pobrania i zainstalowania. Będzie to "source"
z wyjątkiem kompilacji dla Windows i niektórych macOS: zobacz sekcję 'Pakiety binarne’ dla nich.
configure.args
(Używane tylko dla instalacji źródeł.) Wektor znaków lub lista nazw. Jeśli podano wektor znaków bez nazw, elementy są konkatenowane w pojedynczy łańcuch (oddzielony spacją) i używane jako wartość dla flagi –configure-args w wywołaniu R CMD INSTALL
. Jeśli wektor znaków ma nazwy, to są one przyjmowane do identyfikacji wartości dla –configure-args dla poszczególnych pakietów. Pozwala to na określenie ustawień dla całej kolekcji pakietów, które będą użyte jeśli któryś z tych pakietów ma być zainstalowany. (Te ustawienia mogą być zatem ponownie użyte i działać jako ustawienia domyślne.)
W tym samym celu może być użyta lista nazwana, która pozwala na wieloelementowe łańcuchy znaków dla każdego pakietu, które są konkatenowane do pojedynczego łańcucha, który może być użyty jako wartość dla –configure-args.
configure.vars
(Używane tylko dla instalacji źródłowych.) Analogiczne do configure.args
dla flagi –configure-vars, która jest używana do ustawiania zmiennych środowiskowych dla configure
run.
clean
wartość logiczna wskazująca czy dodać flagę –clean do wywołania R CMD INSTALL
. Jest to czasami używane do wykonywania dodatkowych operacji na końcu instalacji pakietu oprócz usuwania plików pośrednich.
Ncpus
liczba procesów równoległych do użycia przy równoległej instalacji więcej niż jednego pakietu źródłowego. Wartości większe niż jeden są obsługiwane, jeśli polecenie make
określone przez Sys.getenv("MAKE", "make")
przyjmuje argument -k -j Ncpus
.
verbose
wartość logiczna wskazująca, czy powinien być podawany jakiś „raport postępu”.
libs_only
wartość logiczna: czy opcja –libs-only powinna być używana do instalowania tylko dodatkowych podarchitektur dla instalacji źródłowych? (Zobacz także INSTALL_opts
.) Może to być także użyte w Windows do zainstalowania tylko DLL(s) z pakietu binarnego, np. aby dodać 64-bitowe DLL do instalacji 32-bitowej.
INSTALL_opts
Może być także nazwaną listą wektorów znaków, które mają być użyte jako dodatkowe opcje, z nazwami odpowiednich pakietów.
quiet
logiczne: jeśli true, zredukuj ilość danych wyjściowych.
keep_outputs
logiczne: jeśli true, zachowaj dane wyjściowe z instalacji pakietów źródłowych w bieżącym katalogu roboczym, z nazwami plików wyjściowych odpowiadającymi nazwom pakietów z dodanymi .out
. Alternatywnie, łańcuch znaków podający katalog, w którym mają być zapisane dane wyjściowe. Ignorowane przy instalacji z plików lokalnych.