Debugging-Aufgaben
RGeschrieben vonRiku Virtanen Vor über einer Woche aktualisiertDebuggen von Aufgaben in Visual Studio
Aufgaben für FreundeUndAufgaben der Freundesgemeinschaftsind größtenteils Open Source, sodass Sie den Quellcode der Aufgaben überprüfen können, die Sie in Prozessen verwenden. Sie können auch Änderungen an diesen Aufgaben vornehmen und sie hinzufügen alsBenutzerdefinierte Aufgabenzu Ihrer Frends-Umgebung. Wenn Sie Probleme mit Aufgaben haben, können Sie den Frends-Support unter folgender Adresse kontaktieren:support@frends.com. Zusätzlich zur Kontaktaufnahme mit Frends Support können Sie Probleme in den Aufgaben selbst debuggen. Sehen wir uns an, wie Sie Probleme in Aufgaben debuggen können, indem SieVisual Studio.
Den Quellcode von GitHub abrufen
Nehmen wir an, Sie haben Probleme mit demFreunde.Datei.LesenAufgabe, die Sie selbst debuggen möchten. Sie können die Quelle der Aufgabe klonen mitGit. Sie können beispielsweise den Quellcode des Frends.File-Pakets, das die Frends.File.Read-Aufgabe enthält, mit dem folgenden Befehl klonen.
Git-Klon https://github.com/FrendsPlatform/Frends.File.git
Nachdem Sie den Quellcode geklont haben, können Sie das Projekt aus der Datei Frends.File.sln öffnen. Wenn Sie diese Datei in Visual Studio öffnen, wird das gesamte Projekt geöffnet.
Ausführen von Unittests
Es empfiehlt sich, Task-Unittests auszuführen, bevor Sie Änderungen vornehmen oder mit dem Debuggen eines Problems beginnen, um sicherzustellen, dass die aktuellen Tests funktionieren. Der Quellcode aller Tasks sollte Unittests enthalten, die funktionieren sollten. Einige Tasks erfordern ein Zielsystem, damit Unittests funktionieren. Lesen Sie daher die Datei README.md, um Anweisungen zum Ausführen von Unittests zu erhalten. Die meisten Tasks erfordern kein Zielsystem für Unittests. Sie sollten sie daher sofort ausführen können, nachdem Sie das Projekt in Visual Studio geöffnet haben.
Zurück zu unserem Frends.File.Read-Task-Beispiel: Nachdem wir die Lösung in Visual Studio geöffnet haben, sollten wir Unit-Tests ausführen, um zu prüfen, ob sie funktionieren. Dies ist ganz einfach möglich, indem Sie im Solution Explorer mit der rechten Maustaste auf „Frends.File.Tests“ klicken und „Tests ausführen“ auswählen. Dadurch wird die Lösung erstellt und Unit-Tests ausgeführt.
Nach dem Klicken auf „Tests ausführen“ wird das Fenster „Test Explorer“ geöffnet, in dem der Status des Unit-Testlaufs angezeigt wird. Wenn alle Tests grün angezeigt werden, können Sie mit der Fehlerbehebung Ihres Problems beginnen oder Änderungen an den Aufgaben vornehmen.
Debuggen des Problems
Die beste Möglichkeit, herauszufinden, was ein Problem in der Aufgabe verursachen könnte, besteht darin, das Problem in Unit-Tests zu replizieren. Wenn Sie einen Test erstellen können, der das Problem repliziert, ist es einfacher, genau zu bestimmen, wo das Problem auftreten könnte. Nachdem Sie das Problem behoben haben, können Sie auch überprüfen, ob das Problem tatsächlich behoben ist, indem Sie denselben Unit-Test verwenden, den Sie zum Replizieren des Problems verwendet haben.
Die einfachste Möglichkeit, einen neuen Unit-Test zum Testen einer Funktion zu erstellen, besteht darin, einen vorhandenen Unit-Test zu kopieren und ihn entsprechend zu ändern. Wenn Sie das Problem in Frends reproduzieren können, sollte das gleiche Problem in Unit-Tests auftreten, wenn Sie der Task-Methode dieselben Parameter übergeben wie in Frends. Wenn Sie das Problem in Unit-Tests nicht reproduzieren können, deutet dies darauf hin, dass das Problem nicht in der Task selbst liegt, sondern möglicherweise beim Agenten, der den Prozess ausführt, oder an einer anderen Stelle außerhalb des Task-Quellcodes.
Behebung des Problems
Wenn Sie das Problem in Unit-Tests reproduzieren konnten und einen Fix für das Problem veröffentlichen möchten, gibt es drei Möglichkeiten. Die erste Möglichkeit besteht darin, ein neues Problem im Task-Paket-Repository mit Details zum Problem und dazu, wie Sie es in Frends oder im Quellcode reproduzieren konnten, zu erstellen und dann Kontakt aufzunehmensupport@frends.commit einer kurzen Beschreibung des Problems und einem Link zum GitHub-Problem, das alle Details enthält. Die zweite Möglichkeit besteht darin, das Repository auf Ihr eigenes Konto zu verzweigen, die Änderung an Ihrem eigenen Fork vorzunehmen, einen Pull Request an das ursprüngliche Repository zu erstellen und dann Kontakt aufzunehmensupport@frends.com. Diese Beitragsanweisungen finden Sie in allen Repositorien (zum BeispielFreunde.Datei). Die dritte Möglichkeit besteht darin, eine benutzerdefinierte Aufgabe zu erstellen, in die Sie den Quellcode der Aufgabe kopieren und diese benutzerdefinierte Aufgabe dann in Ihre Freunde importieren.
Der nächste Artikel istEinführung in Kompilierungsfehler in Frends
Verwandte ArtikelEinführung in AufgabenBeispiel für AufgabenEinführung in „Wann sollten Sie Codeelemente anstelle von Frends-Aufgaben verwenden?“Einführung in den Unterschied zwischen Freundesaufgaben, Community-Aufgaben und benutzerdefinierten AufgabenBeispiel zum Importieren benutzerdefinierter Aufgaben