HOWTO · R
Instalar rtools en Windows
Aprende cuándo necesitan Rtools los usuarios de R en Windows, cómo elegir una versión compatible, instalarla, comprobar si R encuentra las herramientas de compilación y solucionar problemas habituales de configuración.
En esta página
Rtools proporciona las herramientas de compilación que necesitan los usuarios de Windows para instalar algunos paquetes de R desde el código fuente o desarrollar paquetes que compilan código. Normalmente no necesitas instalarlo para usar R: muchos paquetes están disponibles como binarios precompilados. Si un paquete requiere compilación o planeas crear uno, instala la versión de Rtools compatible con tu versión de R y comprueba si tu sesión de R puede encontrar sus herramientas.
Instalar Rtools en Windows
Rtools es un conjunto de herramientas de compilación para R en Windows, que incluye compiladores y utilidades necesarias cuando hay que compilar el código fuente de un paquete. Está pensado para instalar y desarrollar paquetes que requieren esas herramientas; no es un requisito general para todos los usuarios de R. Esta guía explica cómo elegir una versión compatible, ejecutar el instalador, comprobar desde R si se encuentran las herramientas y acotar los problemas de configuración más habituales.
Elegir la versión de Rtools para tu instalación de R
Consulta la página de Rtools de CRAN y revisa la información de compatibilidad de las versiones de Rtools que aparecen allí. Elige la versión compatible con la versión de R instalada en tu equipo. No elijas una versión solo porque su número sea más reciente: la compatibilidad depende de la cadena de herramientas de R y las recomendaciones disponibles pueden cambiar con el tiempo.
Si tienes más de una instalación de R, comprueba cuál está usando R o RStudio antes de elegir. Debes tener en cuenta la versión de R que muestra esa sesión. La página de CRAN contiene la información actual sobre versiones y compatibilidad; esta guía no da por hecho que una versión concreta de Rtools sea la adecuada para todas las instalaciones.
Instalar Rtools
Descarga desde la página de CRAN el instalador de la versión compatible, ábrelo y sigue las indicaciones. Las pantallas y los textos del instalador pueden variar según la versión, así que usa las opciones documentadas para la versión que elegiste. En particular, las opciones para agregar herramientas a PATH pueden presentarse de distintas formas o no ser necesarias de la misma manera en todas las versiones. No des por sentado que una casilla o configuración mencionada en una guía antigua aparece en tu instalador.
Elige una ubicación y unas opciones admitidas por esa versión, y espera a que termine la instalación antes de abrir una nueva sesión de R o RStudio. Si el instalador ofrece configurar cómo se encuentran las herramientas, sigue las instrucciones específicas de esa versión. Anota qué versión de R y de Rtools elegiste para poder comprobar su compatibilidad si falla la instalación o la compilación de un paquete.
Verificar la instalación de Rtools
Comprueba si la sesión de R puede encontrar una herramienta de compilación como make mediante Sys.which(). Ejecuta esto en la sesión de R o RStudio que usas para trabajar con paquetes:
Sys.which("make")
El valor devuelto depende del sistema operativo, la versión de Rtools y la configuración de esa sesión. Si aparece una ruta, significa que R puede encontrar un comando con ese nombre; por sí solo, esto no demuestra que todos los compiladores o requisitos para compilar paquetes estén bien configurados. Si el valor está vacío, esa sesión no encontró make mediante su ruta de búsqueda de comandos actual. Compara el resultado con las instrucciones de configuración de tu versión de Rtools y con los requisitos del paquete que quieres compilar. No se espera una ruta ni un resultado específicos en todas las instalaciones de Windows.
Solucionar problemas de instalación y detección de Rtools
Si al compilar un paquete no se encuentran las herramientas, primero confirma que la versión de Rtools sea compatible con la versión de R que usa esa sesión. Después de instalarlo, cierra y vuelve a abrir R o RStudio y comprueba de nuevo si se encuentran las herramientas. Es posible que una sesión abierta antes de la instalación no refleje los cambios en la configuración del entorno.
Si Sys.which("make") no encuentra el comando, revisa los pasos de configuración de tu versión específica de Rtools. Comprueba que la instalación haya terminado y que la configuración documentada de PATH esté activa en la sesión de R. Evita copiar una entrada de PATH de otra versión o equipo, porque las ubicaciones de instalación y las instrucciones pueden variar.
Los problemas de permisos dependen de la carpeta de destino y de la cuenta de Windows. Usa una ubicación en la que tengas permiso para escribir y sigue las indicaciones del instalador. Ejecutarlo como administrador puede ayudar si Windows deniega el acceso a una ubicación necesaria, pero por sí solo no resuelve una incompatibilidad de versiones ni un problema de configuración para encontrar las herramientas. Por lo general, solo necesitas Rtools si tu flujo de trabajo con paquetes requiere compilación; si usas únicamente paquetes precompilados, quizá no lo necesites.