Tag im Leben eines Devops-Entwicklers: Anhalten der Arbeit, Beheben eines Fehlers und Durchführen einer Codeüberprüfung

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Die Features " Meine Arbeit " und "Codeüberprüfung " von Visual Studio unterstützen den Kontextwechsel von einem Arbeitsthread zu einem anderen. Außerdem können Teammitglieder nachrichten über vorgeschlagene Änderungen am Code problemlos austauschen. Dieser Artikel veranschaulicht diese Features und setzt das Lernprogramm von Day im Leben eines Entwicklers fort: Schreiben Sie neuen Code für eine Benutzergeschichte.

In diesem Lernprogramm wird beschrieben, wie Sie die Arbeit an einer aktuellen Aufgabe anhalten können, um sofort einen Fehler zu beheben, der Teamkollegen in einer anderen Arbeitsaufgabe blockiert. Nach dem Beheben des Fehlers können Sie Kollegen bitten, den Fix zu überprüfen, und nachdem die Überprüfung bestanden wurde, überprüfen Sie den Fix, und setzen Sie die Arbeit an der ursprünglichen Aufgabe fort.

Aktuelle Arbeit anhalten

Während Sie an einem Backlog-Element arbeiten, erfahren Sie möglicherweise einen Fehler in einem anderen Element, das Teamkollegen blockiert. Wenn es sich um einen Bereich handelt, mit dem Sie vertraut sind, können Sie eine Aufgabe erstellen, um den Fehler zu beheben und sie sich selbst zuzuweisen, um sofort zu arbeiten.

Bevor Sie mit der Arbeit am neuen Fehler beginnen, sollten Sie sicherstellen, dass Ihre aktuelle Arbeit an einem sicheren Ort auf dem Server des Teams reserviert ist. Wählen Sie im Visual Studio-Team-Explorer auf der Seite "Meine Arbeit" die Option "Anhalten" aus, um sie auf dem Server zu speichern:

• Die gesamte Arbeit, die Sie erledigt haben, einschließlich Änderungen an Code, Tests und anderen Dateien.

• Öffnen Sie Lösungen, Fenster, Haltepunkte, Überwachungsfenstervariablen und andere Bits des Visual Studio-Zustands.

Nachdem Ihr Arbeitsbereich sauber ist, ziehen Sie die neue Aufgabe aus "Verfügbare Arbeitselemente " in "In Bearbeitung". Sie sind bereit, den Fix zu recherchieren und zu schreiben.

So setzen Sie die aktuelle Arbeit aus, und beginnen Sie mit der Arbeit an einer anderen Aufgabe

Wechseln Des Arbeitskontexts:

1. Wenn Sie noch nicht mit dem Projekt verbunden sind, in dem Sie arbeiten möchten, stellen Sie eine Verbindung mit dem Projekt her.

2. Wählen Sie auf der Startseite des Team-Explorers"Meine Arbeit" aus.

3. Wählen Sie auf der Seite "Meine Arbeit" im Abschnitt " In Bearbeitung arbeit " die Option "Anhalten" aus.

4. Ändern Sie im daraufhin angezeigten Feld optional den Namen, den Sie diesem Satz angehaltener Arbeit zuweisen möchten, und wählen Sie dann "Anhalten" aus. Das Element wird unter "Angehaltene Arbeit" angezeigt.

   

5. Ziehen Sie eine Arbeitsaufgabe aus "Verfügbare Arbeitselemente " in "In Bearbeitung". Sie können auch zu einer Arbeitsaufgabe wechseln, die Sie zuvor angehalten haben, indem Sie sie aus "Angehaltene Arbeit" ziehen.

   Wenn die Arbeitsaufgabe, die Sie selbst zuweisen möchten, unter "Verfügbare Arbeitsaufgaben" nicht angezeigt wird, können Sie:

   • Erstellen Sie eine neue Aufgabe oder eine andere Arbeitsaufgabe, indem Sie "Neu" auswählen.
   • Wählen Sie eine andere Abfrage aus, indem Sie "Abfrage öffnen" auswählen.

Untersuchen des Fehlers

Öffnen Sie den neuen Fehler, und lesen Sie die Beschreibung. In diesem Beispiel gibt die Beschreibung eines Mitglieds des Testteams an, dass eine kostenpflichtige Rechnung manchmal falsch als unbezahlt gekennzeichnet ist. Eine Momentaufnahme der Lab-Umgebung ist an die Fehlerarbeitsaufgabe angefügt. Sie öffnen den virtuellen Computer (VM), auf dem der Test ausgeführt wurde, sehen Sie die falsche Rechnung, und kehren Sie durch das IntelliTrace-Protokoll zurück. Sie können den Fehler auf die folgende Methode nachverfolgen:

public class LocalMath
{
    public static bool EqualTo(double a, double b)
    {
        return a == b;
    }

Aus dem IntelliTrace-Protokoll sehen Sie, dass die Methode manchmal "false" zurückgibt, da sich die Parameter von einer extrem kleinen Menge unterscheiden. Sie wissen, dass Rundungsfehler dieser Art in Gleitkommaarithmetik unvermeidbar sind und dass es schlecht ist, Gleitkommazahlen auf Gleichheit zu testen.

Erweitern der Tests, um den Fehler anzuzeigen

Wenn ein Fehler gefunden wird, zeigt es, dass in den Komponententests eine Lücke aufgetreten ist oder dass der Test nicht den tatsächlichen Anforderungen der Benutzer entspricht. Fügen Sie daher vor dem Beheben des Fehlers einen Test hinzu, der das Vorhandensein dieses Fehlers veranschaulicht:

// Added 2022-02-02 for bug 654321:
/// <summary>
/// Make sure that number equality test allows for 
/// small rounding errors.
/// </summary>
[TestMethod]
public void TestDoublesEqual()
{
    // Allow a rounding error of 1 in 1000000:
    TestEqual(1, 1e-7, true); // Less than allowed error
    TestEqual(1, 1e-5, false); // More than allowed error
    TestEqual(1000, 1e-7, true); // Less than allowed error
    TestEqual(1000, 1e-5, false); // More than allowed error
}
private void TestEqual(double value, double error, bool result)
{
    // Try different combinations of error and value:
    Assert.IsTrue(result == LocalMath.EqualTo(value + error, value));
    Assert.IsTrue(result == LocalMath.EqualTo(value, value + error));
    Assert.IsTrue(result == LocalMath.EqualTo(value - error, value));
    Assert.IsTrue(result == LocalMath.EqualTo(value, value - error));
}

Führen Sie den Test aus, und es schlägt wie erwartet fehl.

Bestehen der Tests

Beheben Sie den Code:

public static bool EqualTo(double a, double b)
{
    // Allow for rounding errors.
    // For example, a == 2.0 and b = 1.99999999999

    const double allowedError = 1/1000000;
    return System.Math.Abs(a - b) < allowedError;
}

Der Test besteht jetzt:

Anfordern eines Code Reviews

Wenn Sie mit Ihrem Fix für den Fehler zufrieden sind, überprüfen Sie Ihre Arbeit noch nicht. Teams verwenden Codeüberprüfungen, um die allgemeine Codequalität zu erhöhen und das Risiko zu verringern, mehr Fehler zu erstellen. Verwenden Sie Team Explorer , um Codeüberprüfungen von Teamkollegen anzufordern.

So fordern Sie eine Codeüberprüfung an

1. Wählen Sie im Team-Explorer auf der Seite "Meine Arbeit" unter " In Bearbeitung arbeit" die Option "Überprüfen anfordern" aus.

   Die Seite " Neue Codeüberprüfung" wird angezeigt.

   

   • Geben Sie im Feld "Bearbeiter" den Namen eines Bearbeiterfelds ein oder mehrere Bearbeiter ein, und drücken Sie nach jeder Auswahl die EINGABETASTE.
   • Ändern Sie im nächsten Feld den Namen der Rezension, wenn Sie möchten.
   • Stellen Sie im nächsten Feld sicher, dass der richtige Bereichspfad angezeigt wird.
   • Geben Sie im nächsten Feld eine optionale Beschreibung ein.

2. Wählen Sie "Anforderung senden" aus.

Die Prüfer werden per E-Mail über die Anfrage benachrichtigt.

Sie können auch eine Codeüberprüfung der angehaltenen Arbeit, eines Regals oder eines Changeets anfordern. Um eine Liste der Changesets anzuzeigen, öffnen Sie den Quellcodeverwaltungs-Explorer , und wählen Sie die Schaltfläche "Verlauf " aus.

Ausführen einer Codeüberprüfung

Ein Prüfer kann die Codeüberprüfungsanforderung akzeptieren. Der Prüfer überprüft den Code, schreibt einige Kommentare auf Datei- und Codeblockebenen und sendet dann die Codeüberprüfung an Sie zurück. Ein angeforderter Prüfer, der zu beschäftigt ist, um den Code zu überprüfen, kann die Überprüfung ablehnen.

In den Kommentaren weist der Prüfer darauf hin, dass der Test falsch ist. Der zulässige Fehler sollte ein angegebener Bruchteil der Eingabewerte und keine konstante Menge sein. Daher sollte der Test den Fehler mit dem Wert multiplizieren.

// We allow a rounding error of 1 in 1000000
// as a fraction of the value:
TestEqual(1, 1e-7, true); // Less than allowed error
TestEqual(1, 1e-5, false); // More than allowed error
TestEqual(1000, 1000*1e-7, true); // Less than allowed error
TestEqual(1000, 1000*1e-5, false); // More than allowed error

So führen Sie eine Codeüberprüfung durch

1. Klicken Sie auf der Seite "Meine Arbeit" im Team-Explorer mit der rechten Maustaste auf die Codeüberprüfung im Abschnitt "Codeüberprüfungen ", und wählen Sie "Öffnen" aus.

   Die Seite "Codeüberprüfung " wird angezeigt.

   

2. Auf der Seite "Codeüberprüfung " haben Sie folgende Möglichkeiten:

   • Wählen Sie "Bearbeiter hinzufügen" , um der Codeüberprüfungsanforderung weitere Bearbeiter hinzuzufügen.

   • Wählen Sie jeden Dateilink aus, um die Änderungen an den Dateien anzuzeigen, die für diese Arbeitsaufgabe aktualisiert wurden.

   • Verwenden Sie Kommentare , um die Änderungen mit dem Autor und anderen Bearbeitern zu besprechen.

     So fügen Sie Kommentare hinzu:

     • Wählen Sie "Gesamtkommentar hinzufügen " aus, um der Rezension einen Gesamtkommentar hinzuzufügen.
     • Wenn Sie eine Datei anzeigen, wählen Sie eine Zeile oder einen Codeblock aus, klicken Sie mit der rechten Maustaste, und wählen Sie "Kommentar hinzufügen" aus.

     Nachdem Sie jeden Kommentar hinzugefügt haben, wählen Sie "Speichern" aus, oder drücken Sie STRG+EINGABETASTE.

3. Wenn Sie mit der Eingabe von Kommentaren fertig sind, wählen Sie "Kommentare senden " aus, um Ihre Beiträge für den Autor und andere Bearbeiter sichtbar zu machen.

Antworten auf eine Codeüberprüfung

Sie erhalten und beantworten die Codeüberprüfung von den Prüfern. Sie und die Prüfer können Kommentare beliebig oft austauschen. Die Überprüfung endet, wenn Sie sie schließen.

So reagieren Sie auf eine Codeüberprüfung

1. Wechseln Sie im Team-Explorer auf der Seite "Meine Arbeit " zum Abschnitt "Codeüberprüfungen ", und doppelklicken Sie auf die Anforderung, oder klicken Sie mit der rechten Maustaste auf die Anforderung, und wählen Sie "Öffnen" aus.

   Die Seite "Codeüberprüfung " wird angezeigt.

   

2. Lesen Sie im Abschnitt "Kommentare " die Kommentare, und antworten Sie bei Bedarf darauf. Um auf einen Kommentar zu antworten, wählen Sie "Antworten" aus, geben Sie Ihren Kommentar in das daraufhin angezeigte Feld ein, und wählen Sie dann "OK" aus.

3. Um eine Datei anzuzeigen und die Codeblöcke mit Kommentaren anzuzeigen oder eine Datei zu bearbeiten oder zu kommentieren, wechseln Sie zum Unterabschnitt "Dateien ". Klicken Sie mit der rechten Maustaste auf die Datei, und wählen Sie eine der folgenden Optionen aus:

   • Vergleichen (Nur-Lese)
   • Lokale Datei bearbeiten oder
   • Dateikommentar hinzufügen

   Sie können auch das Kontrollkästchen neben einem Kommentar aktivieren, um anzugeben, dass der Kommentar adressiert wurde.

4. Um Ihre Kommentare zu senden, wählen Sie "Kommentare senden" aus.

5. Wenn Sie und die anderen Bearbeiter fertig sind, auf die Kommentare der anderen zu antworten und Sie bereit sind, die Rezension zu schließen, wählen Sie "Überprüfen schließen" aus, und wählen Sie dann Folgendes aus:

   • Abgeschlossen , um anzugeben, dass die Überprüfung abgeschlossen ist, oder
   • Verlassen Sie sich, um anzugeben, dass Sie die Rezension abbrechen.

Beheben des Tests und des Codes

Nachdem Sie die Rezensionskommentare gelesen haben, können Sie den Komponententest wie vorgeschlagen korrigieren. Der Test schlägt jetzt fehl. Dies zeigt, dass der Code noch nicht korrekt ist.

Sie beheben den Code:

/// <summary>
/// Returns true if two numbers are equal.
/// </summary>
public static bool EqualTo(double a, double b)
{
    // Allow for rounding errors.
    const double allowedErrorMultiple = 1/1000000;
    double allowedError = (System.Math.Abs(a) + System.Math.Abs(b)) * allowedErrorMultiple/2;
    return System.Math.Abs(a - b) < allowedError;
}

Der Test bestanden erneut.

Jetzt wenden Sie sich an den Testfall, in dem der Fehler entdeckt wurde. Die Schritte zum Reproduzieren des Fehlers werden im Arbeitselement "Testfall" deutlich beschrieben. Sie führen die Schritte aus und stellen fest, dass die Rechnungen richtig aufgelistet sind.

Einchecken des Fixs

Sie überprüfen den festen Code und die Komponententests. Der Status des Fehlers wird automatisch auf "Behoben" festgelegt, und der Wert " Zugewiesen an" wird automatisch dem Mitglied des Testteams zugewiesen, das den Fehler entdeckt hat. Dieses Teammitglied überprüft, ob der Fehler behoben und die Arbeitsaufgabe geschlossen wurde.

So überprüfen Sie den Fix

1. Wählen Sie im Team-Explorer auf der Seite "Meine Arbeit " die Option " Einchecken" aus, um die Seite "Ausstehende Änderungen " zu öffnen.

   

2. Stellen Sie auf der Seite "Ausstehende Änderungen " folgendes sicher:

   • Alle relevanten Änderungen werden in den enthaltenen Änderungen aufgeführt.

   • Alle relevanten Arbeitsaufgaben werden in verwandten Arbeitsaufgaben aufgeführt.

3. Geben Sie einen Kommentar ein, um Ihrem Team zu helfen, den Zweck dieser Änderungen zu verstehen, wenn sie den Versionssteuerungsverlauf der geänderten Dateien und Ordner betrachten.

4. Wählen Sie "Einchecken" aus.

Fortsetzen der Arbeit an einem Vorgang

Arbeiten an Der ursprünglichen Aufgabe fortsetzen. Sie können schnell wieder arbeiten, da alle Codeänderungen zusammen mit wichtigen Statusbits wie geöffneten Fenstern, Haltepunkten und Überwachungsfenstervariablen in Ihrem Arbeitsbereich wie geöffneten Fenstern, Haltepunkten und Überwachungsfenstervariablen wiederhergestellt werden.

So setzen Sie die Arbeit an einer Aufgabe fort

• Wählen Sie im Team-Explorer auf der Seite "Meine Arbeit" Ihre ursprüngliche Arbeitsaufgabe unter "Angehaltene Arbeit " und dann " Fortsetzen" aus.

  

  Oder wenn Sie Ihre angehaltene Arbeit mit ausstehenden Änderungen in Ihrem Arbeitsbereich zusammenführen möchten, wählen Sie "Zusammenführen" mit "In Bearbeitung" aus.

Wenn Sie Ihre Arbeit fortsetzen, stellt Visual Studio Folgendes wieder her:

• Ihre offene Lösung
• Ihre Codeänderungen
• Status und Position von geöffneten Fenstern
• Breakpoints
• Überwachen von Fenstervariablen und Ausdrücken
• Lesezeichen