Argumentumok
pkgs
karakteres vektor azon csomagok nevéből, amelyek aktuális verzióját le kell tölteni a tárolókból.
Ha repos = NULL
, fájlútvonalak karaktervektora,
windows esetén
a csomagok bináris buildjeit tartalmazó .zip
fájlok útvonalai. ( és
file://
URL-ek is elfogadottak, és a fájlok letöltése és telepítése helyi másolatokból történik). A type = "source"
segítségével megadhatók forráskönyvtárak vagy fájlok elérési útvonalai vagy archívumok URL-jei, de néhány csomaghoz megfelelő eszközök telepítése szükséges (lásd a ‘Részletek’ részt).
Unix-alízeken
ezek a fájlok elérési útvonalai lehetnek forráskönyvtárak vagy archívumok vagy bináris csomagarchívumok (a R CMD build --binary
által létrehozott). (A és
file://
URL-ek is elfogadottak, és a fájlok letöltése és telepítése helyi másolatokból történik). Az R for macOS CRAN build-jén ezek lehetnek .tgz
fájlok, amelyek bináris csomagarchívumokat tartalmaznak. A fájlútvonalakon Tilde-kiterjesztés történik.
Ha ez hiányzik, az interaktív R munkamenetben lehetőség szerint az elérhető csomagok listaboxa jelenik meg.
lib
karakteres vektor, amely megadja azokat a könyvtárkönyvtárkönyvtárakat, ahová a csomagokat telepíteni kell. Szükség szerint újrahasznosítva. Ha hiányzik, alapértelmezés szerint a .libPaths()
első eleme.
repos
Lehet NULL
a helyi fájlokból, könyvtárakból vagy URL-ekből történő telepítéshez: ezt a pkgs
kiterjesztésből következtetjük ki, ha hossza egy.
contriburl
A tárolók contrib szakaszainak URL-jei. Ezt az argumentumot akkor használd, ha a repository tükör hiányos, például mert csak a contrib
szekciót égetted le egy CD-re, vagy csak bináris csomagokkal rendelkezel. Felülírja a repos
argumentumot. 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. Ha ez nem így van, akkor figyelmen kívül hagyjuk, figyelmeztetéssel.
Az alapértelmezett NA
a c("Depends", "Imports", "LinkingTo")
-t jelenti.
Mindegyikben a "LinkingTo"
a bináris csomagok esetében elhagyható.
type
karakter, amely a letöltendő és telepítendő csomag típusát jelzi. Lesz "source"
, kivéve Windows és néhány macOS build esetén: ezekről lásd a “Bináris csomagok” című részt.
configure.args
(Csak forrás telepítéseknél használatos.) Egy karaktervektor vagy egy megnevezett lista. Ha név nélküli karaktervektort adunk meg, az elemek egyetlen (szóközzel elválasztott) karakterlánccá állnak össze, és a R CMD INSTALL
hívásakor a –configure-args flag értékeként használjuk. Ha a karaktervektornak vannak nevei, akkor ezekről feltételezzük, hogy az egyes csomagok –configure-args értékeit azonosítják. Ez lehetővé teszi, hogy egy egész csomaggyűjteményre vonatkozó beállításokat adjunk meg, amelyeket a csomagok bármelyikének telepítése esetén használni fogunk. (Ezek a beállítások tehát újra felhasználhatók és alapértelmezett beállításokként működnek.)
Egy névvel ellátott lista is használható ugyanerre a célra, és ez lehetővé teszi, hogy a –configure-args.
configure értékeként több elemű karakterláncokat használjunk az egyes csomagokhoz, amelyeket egyetlen karakterlánccá fűzünk össze.vars
(Csak forrás telepítéseknél használatos.) Analóg a configure.args
–configure-vars flaggel, amely a configure
futás környezeti változóinak beállítására szolgál.
clean
logikai érték, amely jelzi, hogy a R CMD INSTALL
hívásához hozzá kell-e adni a –clean flaget. Ez néha arra szolgál, hogy a csomagtelepítés végén a köztes fájlok eltávolításán kívül további műveleteket hajtson végre.
Ncpus
a több forráscsomag párhuzamos telepítéséhez használandó párhuzamos folyamatok száma. Az egynél nagyobb értékek akkor támogatottak, ha a make
parancs által megadott Sys.getenv("MAKE", "make")
parancs elfogadja a -k -j Ncpus
argumentumot.
verbose
egy logikai érték, amely jelzi, hogy kell-e valamilyen “előrehaladási jelentést” adni.
libs_only
egy logikai érték: a –libs-only opcióval csak további alarchitektúrákat kell-e telepíteni a forrás telepítésekor? (Lásd még INSTALL_opts
.) Ez Windowson arra is használható, hogy csak a DLL(ek)et telepítse egy bináris csomagból, pl. 64 bites DLL-ek hozzáadása egy 32 bites telepítéshez.
INSTALL_opts
A kiegészítő opcióként használható karaktervektorok megnevezett listája is lehet, a nevek a megfelelő csomagnevek.
quiet
logikus: ha igaz, csökkenti a kimenet mennyiségét.
keep_outputs
a logikus: ha igaz, megtartja a forráscsomagok telepítéséből származó kimeneteket az aktuális munkakönyvtárban, a kimeneti fájlok nevei a csomagnevek .out
függelékkel. Alternatívaként egy karakterlánc, amely megadja azt a könyvtárat, ahová a kimeneteket menteni kell. A helyi fájlokból történő telepítés esetén figyelmen kívül hagyja.