Argumenty
pkgs
znakový vektor názvů balíčků, jejichž aktuální verze mají být staženy z repozitářů.
Pokud repos = NULL, znakový vektor cest k souborům,
v systému Windows
cesty k souborům .zip obsahujícím binární sestavení balíčků. (Akceptovány jsou také a file:// adresy URL a soubory budou staženy a nainstalovány z místních kopií). Zdrojové adresáře nebo cesty k souborům nebo adresy URL archivů lze zadat pomocí type = "source", ale některé balíčky vyžadují instalaci vhodných nástrojů (viz část „Podrobnosti“).
Na systémech s operačním systémem Unix mohou být
těmito cestami k souborům zdrojové adresáře nebo archivy nebo binární soubory archivů balíčků (vytvořené pomocí R CMD build --binary a file:// adresy URL jsou také akceptovány a soubory budou staženy a nainstalovány z místních kopií). V sestavení CRAN systému R pro macOS to mohou být .tgz soubory obsahující archivy binárních balíčků. Tilde-rozšíření bude provedeno na cestách k souborům.
Pokud chybí, zobrazí se v interaktivním sezení R seznam dostupných balíčků, pokud je to možné.
lib
znakový vektor udávající adresáře knihoven, kam se balíčky nainstalují. Recykluje se podle potřeby. Pokud chybí, výchozí hodnota je první prvek .libPaths().
repos
Může být NULL pro instalaci z místních souborů, adresářů nebo URL: to se odvodí podle rozšíření z pkgs, pokud má délku jedna.
contriburl
URL sekcí contrib repozitářů. Tento argument použijte, pokud je zrcadlo vašeho repozitáře neúplné, např. protože jste na CD vypálili pouze sekci contrib nebo máte pouze binární balíčky. Přepisuje argument repos. Incompatible with type = "both".
method
download method, see download.file. Unused if a non-NULLavailable 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. V opačném případě je ignorován s varováním.
Výchozí NA znamená c("Depends", "Imports", "LinkingTo").
Ve všech případech se "LinkingTo" u binárních balíčků vynechává.
typ
znak, označující typ balíčku, který má být stažen a nainstalován. Bude to "source" s výjimkou sestavení systému Windows a některých sestavení systému MacOS: pro ty viz část „Binární balíčky“.
configure.args
(Používá se pouze pro instalace zdrojových kódů.) Vektor znaků nebo pojmenovaný seznam. Pokud je zadán znakový vektor bez jmen, prvky se spojí do jednoho řetězce (odděleného mezerou) a použijí se jako hodnota příznaku –configure-args ve volání R CMD INSTALL. Pokud má vektor znaků jména, předpokládá se, že tato jména identifikují hodnoty příznaku –configure-args pro jednotlivé balíčky. To umožňuje zadat nastavení pro celou kolekci balíčků, která se použijí, pokud se má některý z těchto balíčků nainstalovat. (Tato nastavení lze tedy použít opakovaně a fungují jako výchozí nastavení.)
K témuž účelu lze použít i pojmenovaný seznam, který umožňuje použít jako hodnotu pro –configure-args víceprvkové znakové řetězce pro jednotlivé balíčky, které se spojí do jediného řetězce.
configure.vars
(Používá se pouze pro zdrojové instalace.) Analogicky k configure.args pro příznak –configure-vars, který se používá k nastavení proměnných prostředí pro configure běh.
clean
logická hodnota určující, zda se má k volání R CMD INSTALL přidat příznak –clean. To se někdy používá k provedení dalších operací na konci instalace balíčku kromě odstranění mezisouborů.
Ncpus
počet paralelních procesů, které se mají použít pro paralelní instalaci více než jednoho zdrojového balíčku. Hodnoty větší než jedna jsou podporovány, pokud příkaz make určený Sys.getenv("MAKE", "make") přijímá argument -k -j Ncpus.
verbose
logická hodnota udávající, zda má být podáno nějaké „hlášení o průběhu“.
libs_only
logická hodnota: má být použita volba –libs-only pro instalaci pouze dalších dílčích architektur pro instalaci zdrojových kódů? (Viz také INSTALL_opts.) Tuto volbu lze také použít v systému Windows k instalaci pouze knihoven DLL z binárního balíčku, např. k přidání 64bitových knihoven DLL do 32bitové instalace.
INSTALL_opts
Může to být také pojmenovaný seznam znakových vektorů, které se použijí jako další volby, přičemž názvy jsou názvy příslušných balíčků.
quiet
logické: je-li true, omezí množství výstupu.
keep_outputs
a logické: je-li true, ponechá výstupy z instalace zdrojových balíčků v aktuálním pracovním adresáři, přičemž názvy výstupních souborů budou názvy balíčků s připojeným .out. Případně znakový řetězec udávající adresář, do kterého se mají výstupy uložit. Ignorováno při instalaci z místních souborů.