Installieren Sie rtools unter Windows

Rtools stellt Windows-Nutzern Build-Werkzeuge bereit, die sie benötigen, wenn sie manche R-Pakete aus dem Quellcode installieren oder Pakete entwickeln, die Code kompilieren. Für die bloße Nutzung von R müssen Sie Rtools normalerweise nicht installieren: Viele Pakete sind als vorgefertigte Binärdateien verfügbar. Wenn ein Paket kompiliert werden muss oder Sie selbst eines erstellen möchten, installieren Sie die Rtools-Version, die zu Ihrer R-Version passt, und prüfen Sie, ob Ihre R-Sitzung die Werkzeuge finden kann.

Rtools unter Windows installieren

Rtools ist eine Sammlung von Build-Werkzeugen für R unter Windows, darunter Compiler und Hilfsprogramme, die zum Kompilieren von Paketquellcode verwendet werden. Rtools ist für die Paketinstallation und Entwicklung gedacht, wenn diese Werkzeuge benötigt werden; es ist keine allgemeine Voraussetzung für alle R-Nutzenden. Diese Anleitung behandelt die Wahl einer kompatiblen Version, das Ausführen des Installationsprogramms, die Prüfung, ob R die Werkzeuge findet, und die Eingrenzung häufiger Einrichtungsprobleme.

Die passende Rtools-Version für Ihre R-Installation auswählen

Rufen Sie zunächst die CRAN-Rtools-Seite auf und lesen Sie die Kompatibilitätsinformationen zu den dort aufgeführten Rtools-Versionen. Wählen Sie die Version, die für die auf Ihrem Computer installierte R-Version unterstützt wird. Entscheiden Sie sich nicht allein deshalb für eine Version, weil ihre Nummer höher ist: Die Kompatibilität hängt von der R-Toolchain ab, und die verfügbaren Hinweise können sich im Laufe der Zeit ändern.

Wenn Sie mehrere R-Installationen haben, prüfen Sie vor der Auswahl, welche davon R oder RStudio verwendet. Maßgeblich ist die R-Version, die in dieser Sitzung angezeigt wird. Die CRAN-Seite enthält aktuelle Angaben zu Versionen und Kompatibilität; diese Anleitung geht nicht davon aus, dass eine bestimmte Rtools-Version für jede Installation aktuell ist.

Rtools installieren

Laden Sie das Installationsprogramm für die kompatible Version von der CRAN-Seite herunter, öffnen Sie die heruntergeladene Datei und folgen Sie den Anweisungen. Die Installationsdialoge und ihre Beschriftungen können sich je nach Version unterscheiden. Verwenden Sie daher die für Ihre ausgewählte Version dokumentierten Optionen. Insbesondere können Optionen zum Hinzufügen zum PATH je nach Version anders angeboten werden oder unterschiedlich relevant sein. Gehen Sie nicht davon aus, dass eine Bezeichnung für ein Kontrollkästchen oder eine Einstellung aus einer älteren Anleitung auch für Ihr Installationsprogramm gilt.

Verwenden Sie einen Speicherort und Optionen, die von dieser Version unterstützt werden, und warten Sie, bis die Installation abgeschlossen ist, bevor Sie eine neue R- oder RStudio-Sitzung öffnen. Falls das Installationsprogramm eine Konfiguration zum Auffinden der Werkzeuge anbietet, folgen Sie den versionsspezifischen Hinweisen. Notieren Sie sich die ausgewählte R-Version und Rtools-Version, damit Sie deren Kompatibilität prüfen können, falls die Installation oder das Kompilieren eines Pakets nicht funktioniert.

Die Rtools-Installation überprüfen

Prüfen Sie mit Sys.which(), ob die R-Sitzung ein Build-Werkzeug wie make findet. Führen Sie dies in der R- oder RStudio-Sitzung aus, die Sie für die Arbeit mit Paketen verwenden:

Sys.which("make")

Der zurückgegebene Wert hängt vom Betriebssystem, der Rtools-Version und der Konfiguration dieser Sitzung ab. Ein nichtleerer Pfad zeigt, dass R einen Befehl mit diesem Namen finden kann; er beweist für sich genommen nicht, dass alle Compiler- oder Paket-Build-Anforderungen richtig konfiguriert sind. Ein leerer Wert bedeutet, dass diese Sitzung make über ihren aktuellen Befehlssuchpfad nicht gefunden hat. Vergleichen Sie das Ergebnis mit den Einrichtungshinweisen für Ihre Rtools-Version und mit den Anforderungen des Pakets, das Sie erstellen. Für alle Windows-Installationen lässt sich kein bestimmter Pfad oder eine bestimmte Ausgabe erwarten.

Probleme mit der Rtools-Installation und dem Auffinden der Werkzeuge beheben

Wenn ein Paket-Build seine Werkzeuge nicht findet, prüfen Sie zuerst, ob die Rtools-Version mit der R-Version kompatibel ist, die diese Sitzung verwendet. Schließen Sie R oder RStudio nach der Installation und öffnen Sie es erneut; prüfen Sie anschließend nochmals, ob die Werkzeuge gefunden werden. Eine Sitzung, die bereits vor der Installation geöffnet war, übernimmt möglicherweise geänderte Umgebungsvariablen nicht.

Wenn Sys.which("make") den Befehl nicht findet, prüfen Sie die Konfigurationsschritte für Ihre konkrete Rtools-Version. Stellen Sie sicher, dass die Installation abgeschlossen wurde und die dokumentierte PATH-Einrichtung für die R-Sitzung wirksam ist. Übernehmen Sie keinen PATH-Eintrag von einer anderen Version oder einem anderen Computer, da sich Installationsorte und Einrichtungsschritte unterscheiden können.

Berechtigungsprobleme hängen vom Zielordner und vom Windows-Konto ab. Verwenden Sie einen Speicherort, an dem Sie Schreibrechte haben, und folgen Sie den Hinweisen des Installationsprogramms. Das Ausführen des Installationsprogramms als Administrator kann helfen, wenn Windows den Zugriff auf einen benötigten Speicherort verweigert. Ein Versionskonflikt oder ein Konfigurationsproblem beim Auffinden der Werkzeuge wird dadurch allein jedoch nicht behoben. Rtools wird im Allgemeinen benötigt, wenn Ihr Paket-Workflow das Kompilieren erfordert. Wenn Sie nur vorgefertigte Pakete verwenden, benötigen Sie es möglicherweise nicht.