Erstellen von R-Projekten in Visual Studio
Ein R-Projekt (eine RXPROJ-Datei) identifiziert alle Quell- und Inhaltsdateien, die mit einem Projekt verknüpft sind. Außerdem enthält es Buildinformationen für jede Datei, verwaltet diese Informationen zur Integration in Quellcodeverwaltungssysteme und unterstützt Sie bei der Organisation Ihrer Anwendung in logische Komponenten. Arbeitsbereichbezogene Informationen wie die Liste der installierten Pakete im Arbeitsbereich selbst werden getrennt verwaltet.
Darüber hinaus werden Projekte immer in einer Visual Studio-Projektmappe verwaltet, die eine beliebige Anzahl von aufeinander verweisenden Projekten enthalten kann. Weitere Informationen finden Sie unter Verwenden von verschiedenen Projekttypen in Visual Studio.
Erstellen eines neuen R-Projekts
Öffnen Sie Visual Studio.
Wählen Sie Datei > Neu > Projekt aus (STRG+UMSCHALT+N)
Wählen Sie unter Vorlagen > R „R-Projekt“ aus, weisen Sie dem Projekt einen Namen und Speicherort zu, und klicken Sie auf OK:
Mit diesem Befehl wird ein Projekt mit einer leeren, im Editor geöffneten script.R-Datei erstellt. Im Projektmappen-Explorer sind im Projekt noch zwei weitere Dateien vorhanden:
Die RHISTORY-Datei zeichnet alle Befehle auf, die Sie im Fenster R Interactive eingeben. Sie können ein Fenster zum dedizierten Verlauf mit dem Befehl R Tools > Windows > Verlauf öffnen. Dieses Fenster hat eine Schaltfläche in der Symbolleiste und Elemente im Kontextmenü, um den Inhalt des Verlaufs zu löschen.
Die Datei rproject.rproj behält bestimmte R-spezifische Projekteinstellungen bei, die anderweitig nicht von Visual Studio verwaltet werden:
| Eigenschaft | Standard | BESCHREIBUNG |
|---|---|---|
| Version | 1.0 | Die Version von R Tools für Visual Studio, die für die Projekterstellung verwendet wurde |
| RestoreWorkspace | Standard | Lädt automatisch vorherige Arbeitsbereichsvariablen aus der Datei .RData im Projektverzeichnis |
| SaveWorkspace | Standard | Speichert aktuelle Arbeitsbereichsvariablen beim Schließen eines Projekts in der Datei .RData im Projektverzeichnis |
| AlwaysSaveHistory | Standard | Speichert die aktuelle Versionsgeschichte des interaktiven Fensters beim Schließen eines Projekts in der Datei .RHistory im Projektverzeichnis |
| EnableCodeIndexing | Ja | Bestimmt, ob zur Beschleunigung von Codesuchen im Hintergrund eine Indizierungsaufgabe ausgeführt werden soll |
| UseSpacesForTab | Ja | Bestimmt, ob Leerzeichen (Ja) oder ein Tabstoppzeichen (Nein) eingefügt werden sollen bzw. soll, wenn im Editor die TAB-TASTE gedrückt wird. |
| NumSpacesForTab | 2 | Die Anzahl der einzufügenden Leerzeichen, wenn UseSpacesForTab „Ja“ lautet |
| Codieren | UTF-8 | Die Standardcodierung für .R-Dateien |
| RnwWeave | Sweave | Das beim Einbinden einer RNW-Datei zu verwendende Paket |
| LaTeX | pdfLaTeX | Die beim Konvertieren von RMarkdown in PDF zu verwendende Bibliothek |
Konvertieren eines Dateiordners in ein R-Projekt
Führen Sie die folgenden Schritte aus, wenn Sie einen vorhandenen Ordner mit R-Dateien in einem Projekt verwalten möchten:
- Erstellen Sie wie im vorherigen Abschnitt ein neues Projekt in Visual Studio.
- Kopieren Sie die Dateien in den Projektordner.
- Klicken Sie im Projektmappen-Explorer von Visual Studio mit der rechten Maustaste auf das Projekt, wählen Sie Hinzufügen > Vorhandenes Element aus, und navigieren Sie zu den Dateien, die Sie hinzufügen möchten. Diese Dateien werden in Ihrer Projektstruktur angezeigt, nachdem Sie auf OK geklickt haben.
- Klicken Sie zum Organisieren von Code in Unterordnern mit der rechten Maustaste auf das Projekt, und wählen Sie zunächst Hinzufügen > Neuer Ordner aus. Kopieren Sie Ihre Dateien anschließend in diesen Ordner, und fügen Sie diese vorhandenen Elemente in Schritt 3 hinzu.
Projekteigenschaften
Klicken Sie zum Öffnen der Eigenschaftenseiten des Projekts im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie Eigenschaften oder das Menüelement Projekt > (Projektname)-Eigenschaften aus. Das geöffnete Fenster zeigt die Projekteigenschaften an:
| Registerkarte | Eigenschaft | BESCHREIBUNG |
|---|---|---|
| Ausführen | Startup file | Der Name der Datei, die mit dem Befehl Source startup file, F5, Debuggen > Debuggen starten oder Debuggen > Ohne Debuggen starten ausgeführt wird. Sie können die Startdatei auch im Projekt über einen Rechtsklick auf die Datei und die Option Als R-Startskript festlegen festlegen. |
| R Interactive beim Ausführen zurücksetzen | Löscht alle Variablen aus dem Arbeitsbereich des interaktiven Fensters, wenn das Projekt ausgeführt wird. So wird sichergestellt, dass keine Inhalte des Arbeitsbereichs aus vorherigen Ausführungen übrig bleiben. | |
| Remote Project Path | Pfad zu einem Remotearbeitsbereich | |
| Transfer files on run | Gibt an, ob die Projektdateien, die dem Filter in Files to transfer unterliegen, bei jeder Ausführung in einen Remotearbeitsbereich kopiert werden sollen | |
| Files to transfer | Dateinamen und Platzhalter, die die genauen Dateien angeben, die in einen Remotearbeitsbereich kopiert werden sollen, wenn Transfer files on run ausgewählt ist. | |
| Einstellungen | (Settings.R-Datei) | Die Einstellungen des R-Projekts stammen aus Settings.R- oder **.Settings.R*-Dateien, die sich innerhalb des Projekts befinden. Wenn keine Einstellungsdatei vorhanden ist, können Sie Variablen hinzufügen und die Seite speichern. Zudem wird eine Settings.R-Standarddatei für Sie erstellt. Sie können die Einstellungsdatei auch über den Menübefehl Datei > Neues Element hinzufügen zum Projekt hinzufügen. Einstellungen werden als R-Code gespeichert, und die Datei kann vor dem Ausführen anderer Module und dem Vorabausfüllen der Umgebung mit den vordefinierten Einstellungen zurückverfolgt werden. |
R-spezifische Projektbefehle
Visual Studio-Projekte unterstützen sowohl über das Kontextmenü als auch über das Projektmenü eine Reihe von allgemeinen Befehlen. Weitere Informationen zu diesen allgemeinen Funktionen finden Sie unter Projektmappen und Projekte in Visual Studio. Bedenken Sie jedoch, dass R Tools für Visual Studio (RTVS) eine Reihe eigener Befehle zum Kontextmenü eines R-Projekts sowie Dateien und Ordner innerhalb des Projekts hinzufügt.
| Befehl | BESCHREIBUNG |
|---|---|
| Arbeitsverzeichnis hier festlegen | Legt das Arbeitsverzeichnis des Fensters von R Interactive auf den Projektordner fest, der auch für jeden Unterordner eines Projekts verwendet werden kann. |
| Enthaltenden Ordner öffnen | Öffnet den Windows-Explorer am Speicherort der ausgewählten Datei |
| R-Skript hinzufügen | Erstellt und öffnet eine neue .R-Datei mit einem Standardnamen. Sie können auch den Befehl Hinzufügen > Neues Element zum Erstellen von R-Dateien und einer Reihe anderer Dateitypen verwenden. Weitere Informationen finden Sie unter R-spezifische Elementvorlagen. |
| R Markdown hinzufügen | Erstellt und öffnet ein neues RMD-Dokument mit einem Standardnamen. Sie können auch den Befehl Hinzufügen > Neues Element zum Erstellen von RMD-Dateien und einer Reihe anderer Dateitypen verwenden. Weitere Informationen finden Sie unter R-spezifische Elementvorlagen. |
| Gespeicherte Prozeduren veröffentlichen | Startet einen Prozess zum Veröffentlichen von in R-Skripts enthaltenen gespeicherten Prozeduren. Weitere Informationen finden Sie unter Arbeiten mit gespeicherten SQL Server-Prozeduren. |
R-spezifische Elementvorlagen
RTVS umfasst eine Reihe von Vorlagen für bestimmte Dateitypen. Sie können auf Vorlagen zugreifen, indem Sie mit der rechten Maustaste auf ein R-Projekt klicken und dann Hinzufügen > Neues Element, Projekt > Neues Element hinzufügen oder Datei > Neu > Datei auswählen und zur Registerkarte R navigieren. Die beste Vorgehensweise zum Untersuchen einer Vorlage besteht darin, ein neues Projekt zu erstellen und Dateien jeden Dateityps einzufügen.
Hinweis
Die Befehle Hinzufügen > Neues Element zeigen auch allgemeine Dateitypen an, die in der Tabelle nicht aufgelistet sind. Mit Datei > Neu > Datei werden diese Typen stattdessen auf der Registerkarte Allgemein aufgeführt.
| Dateityp | BESCHREIBUNG |
|---|---|
| R-Skript | Eine Textdatei, die dieselben Befehle enthält, die in der R-Befehlszeile eingegeben werden können |
| R Markdown | Eine Datei mit einem R Markdown-Dokument |
| R-Einstellungen | Eine Datei, die die R-Anwendungseinstellungen enthält |
| R-Dokumentation | Eine generische R-Dokumentationsdatei, die nur die Namens-, Alias-, und Titelfelder enthält |
| R-Dokumentation (Funktion) | Eine R-Dokumentationsdatei, die viele Felder mit Kommentaren zum Beschreiben einer Funktion enthält |
| R-Dokumentation (Dataset) | Eine R-Dokumentationsdatei, die viele Felder mit Kommentaren zum Beschreiben eines Datasets enthält |
| SQL-Abfrage | Eine leere SQL-Datei. Siehe Arbeiten mit SQL Server und R. |
| Gespeicherte Prozeduren mit R | Eine R-Datei mit untergeordneten SQL-Abfragen und einer Vorlagendatei für die untergeordnete gespeicherte Prozedur. Siehe Arbeiten mit SQL Server und R. |
Verwenden von verschiedenen Projekttypen in Visual Studio
Visual Studio-Projektmappen stellen eine bequeme Möglichkeit zum Sammeln und Verwalten verwandter Projekte in einem logischen Ort bereit. Mit Projektmappen bleibt Ihr Code organisiert. Darüber hinaus erleichtern sie das Arbeiten in Teams.
Im folgenden Beispiel enthält die Projektmappe ein R-Projekt mit einem Modell, das mithilfe von R und Azure Machine Learning erstellt wurde, ein Python/SciKit-learn-Projekt, ein C++-Projekt, das Module für rechenintensive Rechenaufwand enthält, ein SQL-Projekt für die Datenverwaltung und ein Python/Bottle-Projekt für die Website, die das Ergebnis veröffentlicht:
Das fett markierte Projekt ist das „Startprojekt“ der Projektmappe. Um es zu ändern, klicken Sie mit der rechten Maustaste auf ein anderes Projekt, und wählen Sie Als Startprojekt festlegen aus.
Hinweis
Derzeit ist keine explizite Sprachintegration für R in C#/C++ vorhanden (wie bei Python, siehe Erstellen einer C++-Erweiterung für Python). Es gibt jedoch Bibliotheken, die C#- und C++-Brücken für R bereitstellen.
Weitere Informationen zum Verwalten von Projekten und Projektmappen im Allgemeinen finden Sie unter Projektmappen und Projekte in Visual Studio.