Rhino.Compute ermöglicht es Ihnen, die geometrischen Berechnungsfähigkeiten von Rhino in die Cloud zu bringen. Bevor Sie Ihre Anwendung in einer Produktionsumgebung einsetzen, sollten Sie sicherstellen, dass alle perfekt in einer kontrollierten Umgebung funktioniert.
Diese Anleitung richtet sich an Entwickler, die mit Windows vertraut sind und über Grundkenntnisse in Visual Studio und Git verfügen. Egal, ob Sie ein erfahrener Rhino-Benutzer oder neu in Rhino.Compute sind, diese Dokumentation wird Ihnen die notwendigen Schritte zum Einrichten Ihrer Entwicklungsumgebung und zum effektiven Debuggen zeigen.
Voraussetzungen
Bevor Sie mit der Einrichtung von Rhino.Compute auf Ihrem lokalen Rechner beginnen, müssen Sie sicherstellen, dass Sie die richtigen Werkzeuge haben. Das brauchen Sie dazu:
- Windows-Betriebssystem. Rhino.Compute läuft nur auf Windows.
- Entwicklungsumgebung. Sie benötigen Visual Studio 2022, um den Code zu kompilieren.
- Versionskontrolle. Git ist notwendig, um das compute.rhino3d-Repository zu klonen und Branches entsprechend Ihrer Rhino-Version zu verwalten.
- Rhino, Besuchen Sie unsere Download-Seite, um die neuesten Builds von Rhino 8 oder Rhino 7 zu erhalten. Nach dem Herunterladen und der Installation starten Sie bitte Rhino und folgen Sie den Anweisungen beim Start, um Ihre Lizenz auf Ihrem Computer oder über den Cloud Zoo zu validieren.
Klonen Sie das Repository
Um die neueste Version von Rhino.Compute zu erhalten, müssen Sie das Repository von unserem offiziellen Konto in Github klonen.
-
Gehen Sie zu https://github.com/mcneel/compute.rhino3d
-
Vergewissern Sie sich, dass Sie im Dropdown-Menü Branch entweder den 8.x- oder den 7.x-Branch zum Klonen auswählen.
-
Klicken Sie dort auf die grüne Schaltfläche “<> Code” und kopieren Sie die URL für das Repository.
-
Erstellen Sie auf Ihrem lokalen Computer einen Ordner, in den Sie das Repository klonen möchten.
-
Navigieren Sie über Ihre bevorzugte Eingabeaufforderung zu diesem Verzeichnis, geben Sie “git clone” ein und fügen Sie die URL ein, die Sie zuvor kopiert haben.
git clone https://github.com/mcneel/compute.rhino3d.git -
Nachdem der Klonvorgang abgeschlossen ist, sollten Sie eine Reihe von Dateien und Verzeichnissen sehen, die aus dem compute.rhino3d-Repository in den von Ihnen erstellten Ordner heruntergeladen wurden.
Anatomie der Lösung
Das Rhino.Compute-Repository besteht aus zwei Hauptprojekten, die jeweils unterschiedlichen Zwecken innerhalb des Frameworks dienen. Diese zu verstehen, kann helfen, die Funktionsweise von Rhino.Compute zu klären, insbesondere wenn Sie mit dem Programm arbeiten oder zu seiner Entwicklung beitragen möchten. Hier ist eine Aufschlüsselung der beiden Projekte:
-
compute.geometry. Dieses Projekt konzentriert sich in erster Linie auf die Aspekte der geometrischen Berechnung. Im Wesentlichen bietet compute.geometry eine REST-API, die die Geometrie-Engine von Rhino für die Verwendung über das Web zugänglich macht. Das bedeutet, dass geometrische Operationen auf einem Server durchgeführt und die Ergebnisse remote abgerufen werden können. Dies ist sehr nützlich für webbasierte Anwendungen oder Dienste, die eine komplexe geometrische Verarbeitung erfordern.
-
rhino.compute. Dieses Projekt kann als übergeordnete Service-Ebene betrachtet werden, die die Aufrufe der compute.geometry-API verwaltet und orchestriert und Aufgaben wie Authentifizierung, das Erzeugen von Untergeordneten-Prozessen und das Einrichten von Zeitlimits für das Herunterfahren des Prozesses übernimmt.
Kompilieren Sie die Lösung
Nun, da Sie den Code haben, ist es an der Zeit, das Projekt in Visual Studio 2022 zu öffnen und es für das Debugging vorzubereiten.
-
Navigieren Sie zu dem Verzeichnis, in das Sie das Repository geklont haben, und suchen Sie die Datei compute.sln. Doppelklicken Sie darauf, um das Projekt in Visual Studio 2022 zu öffnen.
-
Setzen Sie die Lösungskonfiguration in den Debug-Modus. Dadurch können Sie den Code mit allen Debugging-Funktionen ausführen, was es einfacher macht, den Code zu durchsuchen und Fehler zu finden.
-
Klicken Sie im Menü File auf Build -> Build Solution (Strg + Umschalt + B). Dadurch werden alle Projektdateien kompiliert.
-
Klicken Sie im Panel Solution Explorer mit der rechten Maustaste auf das Projekt rhino.compute und wählen Sie Set as Startup Project. Dadurch wird sichergestellt, dass Visual Studio beim Ausführen des Debuggers genau dieses Projekt startet.
-
Klicken Sie auf rhino.compute, um die Anwendung im Debugger zu starten. Eine Konsolenanwendung sollte in Ihrer Taskleiste erscheinen und den Status des Rhino.Compute-Ladevorgangs anzeigen.
-
Jetzt müssen Sie nur noch ein paar Sekunden warten, bis Rhino.Compute geladen ist. Bitte beachten Sie, dass die protokollierten Informationen von der Rhino-Version abhängen, die Sie zuvor ausgewählt hatten.
Einen Endpunkt testen
Wenn die Rhino.Compute-Konsolenanwendung läuft, navigieren Sie zu einem dieser Endpunkte, um zu überprüfen, ob alles funktioniert!
