Freigeben über


Verwenden des Azure DevOps-Plug-Ins für IntelliJ IDEA und Android Studio

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

IntelliJ IDEA ist eine von JetBrains produzierte IDE. Weitere Informationen dazu finden Sie unter https://www.jetbrains.com/idea/. Mit dem Azure DevOps-Plug-In für IntelliJ können Sie eine nahtlose und intuitive Verbindung mit Ihren Git-Repositorys mit Azure DevOps herstellen. Sie können dieses Plug-In auch verwenden, um Projekte in Azure Repos zu importieren oder Pullanforderungen in Ihrem Azure DevOps Git-Repository zu erstellen.

Voraussetzungen

Kategorie Anforderungen
Organisation Eine Organisation in Azure DevOps mit einem Git-Repository.
Werkzeuge - IntelliJ IDEA.
- IntelliJ-Plug-In.
- Git Credential Manager für Windows oder Git SCM für macOS und Linux.

Erstellen eines Repositorys

  1. Navigieren Sie zu Ihrem Projekt in Azure DevOps, indem Sie zu https://dev.azure.com/{your organization} Ihrem Projekt navigieren und den Namen Ihres Projekts auswählen. Sie können sie in der Liste "Alle Projekte" oder in der Liste " Zuletzt verwendete Projekte" auswählen, wenn Sie kürzlich darauf zugegriffen haben.

    Screenshot: Ausgewähltes Projekt.

    Hinweis

    Bei Azure DevOps Services lautet dev.azure.com/{your organization}/{your project}das Format für die Projekt-URL. Das vorherige Format, das auf das visualstudio.com Format verweist, wird jedoch weiterhin unterstützt. Weitere Informationen finden Sie unter Einführung in Azure DevOps, Wechseln vorhandener Organisationen zur Verwendung der neuen Domänennamen-URL.

  2. Wählen Sie im Projektbereich im Webportal "Code" aus, und wählen Sie dann die Dropdownliste neben dem aktuellen Repositorynamen aus, und wählen Sie "Neues Repository" aus.

    Screenshot: Auswählen eines neuen Repositorys aus dem Webportal.

  3. Überprüfen Sie im Dialogfeld " Neues Repository erstellen", ob Git der Repositorytyp ist, geben Sie DeepSpace für ihren neuen Repositorynamen ein, und wählen Sie "Erstellen" aus.

    Screenshot: Festlegen von Optionen für Ihr neues Repository im Dialogfeld

Hinzufügen von Beispielcode zu Ihrem Repository

  1. Wählen Sie "Klonen" in der oberen rechten Ecke des Codefensters aus, und kopieren Sie die Klon-URL.

    Screenshot: Abrufen der Klon-URL.

  2. Öffnen Sie das Git-Befehlsfenster (Git Bash auf Git für Windows), navigieren Sie zu dem Ordner, in dem der Code aus dem Repository auf Ihrem Computer gespeichert werden soll, und führen Sie git clone gefolgt vom Pfad aus der Klon-URL im vorherigen Schritt aus, wie im folgenden Beispiel gezeigt.

    git clone https://dev.azure.com/contoso-ltd/MyFirstProject/_git/DeepSpace
    
  3. Wechseln Sie zum DeepSpace-Ordner, indem Sie den folgenden Befehl ausführen.

    cd DeepSpace
    

    Lassen Sie dieses Fenster geöffnet, um es in nachfolgenden Schritten zu verwenden.

  4. Laden Sie den DeepSpace-Beispielcode herunter, und extrahieren Sie ihn in das lokale Verzeichnis auf Ihrem Computer, auf dem Sie das DeepSpace-Repository geklont haben.

  5. Wechseln Sie zurück zu Ihrem Git-Befehlsfenster, und führen Sie den folgenden Befehl aus, der die Beispielcodedateien in Ihr lokales Repository einleitet.

    git add --all
    

    Möglicherweise werden einige Warnungen angezeigt, die angeben, dass die Zeilenfeeds durch Wagenrücklaufzeilenfeeds ersetzt werden. Sie können diese Warnungen ignorieren.

  6. Führen Sie den folgenden Befehl aus, um die Dateien in das lokale Repository zu übernehmen.

    git commit -m "Committing DeepSpace sample files"
    
  7. Führen Sie den folgenden Befehl aus, um den Commit von DeepSpace-Beispieldateien an Ihr Azure Repos DeepSpace-Repository zu übertragen.

    git push
    
  8. Wechseln Sie zurück zum Azure DevOps-Webportal, und aktualisieren Sie es. Die Dateien wurden hinzugefügt.

    Screenshot zeigt DeepSpace-Dateien.

Klonen des Repositorys in IntelliJ

Nachdem wir nun ein Git-Repository mit einem Beispielcode haben, sehen wir uns an, wie wir mit dem Code von IntelliJ IDEA arbeiten können. Sie müssen die URL für das Repository nicht einmal kennen, um es zu klonen.

  1. Öffnen Sie IntelliJ IDEA, und wählen Sie im Versionssteuerelement aus, und wählen Sie dann VSTS Git aus.

    Screenshot der Aktion

  2. Melden Sie sich bei Azure DevOps an.

    Screenshot der Azure DevOps-Anmeldung.

  3. Wenn Sie "Anmelden" auswählen, wird ihnen die standardmäßige Azure DevOps-Anmeldebenutzeroberfläche angezeigt. Nach der Anmeldung sollte die Liste aller Repositorys angezeigt werden, auf die Sie auf Azure DevOps zugreifen können. Wählen Sie das richtige Repository, DeepSpace und dann die Schaltfläche "Klonen " aus. Ändern Sie auch das übergeordnete Verzeichnis, in dem Ihr Repository auf Ihrer Festplatte geklont wird.

    Screenshot zeigt das Klonen eines Repositorys.

  4. Nach Abschluss des Klons fragt IntelliJ Sie, ob Sie das Projekt öffnen möchten. Wählen Sie "Ja " aus, und Sie sollten mit dem DeepSpace-Projekt enden, das in IntelliJ IDEA geöffnet wurde.

    Screenshot des DeepSpace-Projekts.

Vornehmen einiger Änderungen in IntelliJ

  1. Stellen Sie sicher, dass das Projekt mithilfe desBuilderstellungsprojekts> erstellt wird. Wenn Sie aufgefordert werden, ein SDK für das Projekt hinzuzufügen, fügen Sie das neueste Java JDK auf Ihrem Computer hinzu.

    Führen Sie die folgenden Schritte aus, um das Projekt jetzt auszuführen, um zu sehen, was es tut:

    1. Führen Sie im DeepSpace-Stammordner in Ihrem Git-Repository den Befehl mvn jetty:runaus, der eine Maven-Installation erfordert.
    2. Wechseln Sie in einem Browser zu http://localhost:3030/.

    Sterne und Planeten sollten fliegen! Wenn Sie genau hinschauen, bemerken Sie vielleicht, dass die Erde nicht vorbeifliegen wird.

  2. In unserem DeepSpace-Beispiel gibt es einige Codeabschnitte, die auskommentiert sind. Wenn Sie die src/main/java/com.microsoft.tfs.demo/ImageService.java Datei in IntelliJ öffnen, können Sie einen der Abschnitte sehen.

    Screenshot zeigt, wie die Erde auskommentiert ist.

    Lassen Sie uns diesen Codeabschnitt lokal beheben. In der Regel sollten Sie beim Arbeiten in einem Git-Repository eine Verzweigung für Ihre Arbeit erstellen und diesen Verzweigung übernehmen. Erstellen Sie eine Verzweigung über IntelliJ mithilfe des integrierten VCS> Branches-Fensters>. Wenn Sie dazu aufgefordert werden, verwenden Sie den Verzweigungsnamen fixBugs. Sobald wir eine Verzweigung haben, in der wir unsere Änderungen vornehmen können, können wir den Code aufheben und das Projekt neu erstellen. Wenn Sie den vorherigen Anweisungen folgen, um das Programm erneut auszuführen, sollte die Erde fliegen.

  3. Nachdem unsere Änderungen erstellt und getestet wurden, können wir sie lokal mithilfe des Menüs "VCS>Commit-Änderungen" übernehmen . Im Dialogfeld "Commit" wird eine VSTS-Schaltfläche oberhalb des Textfelds für commit-Nachrichten angezeigt. Wählen Sie auf dieser Schaltfläche aus, um Ihre Liste der Ihnen zugewiesenen Arbeitsaufgaben anzuzeigen. Wählen Sie das Arbeitselement "Fehlende Erde hinzufügen " und dann "OK" aus. In einer Commitmeldung wird das Textfeld angezeigt, das mit dem Typ, der Nummer und dem Titel der Arbeitsaufgabe gefüllt ist, das die Arbeitsaufgabe diesem Commit zur späteren Rückverfolgbarkeit zuordnet.

    Screenshot zeigt Commit Earth.

    Diese Änderung erfolgt nur lokal; sie wird in unserem Azure DevOps-Repository noch nicht geändert.

Erstellen einer Pullanforderung

Sie können Ihre lokale Verzweigung an den Server übertragen und eine Pullanforderung für Ihr Team erstellen, um dies zu überprüfen. Unser Plug-In hilft Ihnen, die Pull-Anforderung basierend auf Ihrem aktuellen Kontext in IntelliJ zu erstellen. Mit dieser Aktion werden mehrere Schritte gespeichert und die Notwendigkeit beseitigt, dass Sie zu Ihrem Browser wechseln müssen, um die Pull-Anforderung zu erstellen.

Wählen Sie VCS>Git>Create Pull Request aus. Diese Aktion öffnet das Dialogfeld " Pullanforderung erstellen ". Dieses Dialogfeld enthält viele Informationen, einschließlich der Dateien, die geändert wurden, und die Commits, die verschoben werden sollen. Sie können der Pullanforderung einen Titel und eine Beschreibung zugeben.

Screenshot: Erstellter Pull-Anforderung.

Nachdem Sie " Pullanforderung erstellen" ausgewählt haben, sollten Sie eine Benachrichtigung erhalten, dass die Pullanforderung erstellt wurde. Sie enthält auch einen Link zur Pullanforderung, falls Sie bestimmte Bearbeiter oder Kommentare hinzufügen möchten. Sobald die Codeüberprüfungen abgeschlossen sind, können Sie die Pullanforderung in Ihre Hauptzweige zusammenführen.

Überprüfen des Buildstatus

Nachdem Sie Ihre Änderungen in Ihrer Hauptzweigung zusammengeführt haben, können Sie überprüfen, ob Ihr CI-Build innerhalb von IntelliJ erfolgreich war. In der unteren rechten Ecke befindet sich ein Symbol, das Ihren Buildstatus für Sie anzeigt. Wenn ein grünes Häkchen angezeigt wird, bedeutet dies, dass ihr Build erfolgreich war. Wenn ein rotes X angezeigt wird, ist der Build fehlgeschlagen. Wenn ein graues Fragezeichen angezeigt wird, wurde Ihr Build nicht gefunden, oder Ihre Anmeldeinformationen sind möglicherweise abgelaufen.

Screenshot zeigt Symbole für den Buildstatus.

Sie können auf dem Symbol weitere Optionen auswählen, z. B. Das Anzeigen von Builddetails, das Warteschlangen eines neuen Builds und das manuelle Aktualisieren des Status.

Screenshot des Menüs

Anzeigen von Pullanforderungen und Arbeitsaufgaben

Im Menü "Versionssteuerung " können Sie auf den Registerkarten " Pullanforderung " und " Arbeitselemente " die benötigten Informationen anzeigen, ohne die IDE verlassen zu müssen. Auf der Registerkarte "Pullanforderung " werden die aktuellen Pullanforderungen angezeigt, die von Ihnen erstellt und Ihnen zusammen mit ihrem Status zugewiesen wurden. Die Registerkarte bietet Ihnen auch die Möglichkeit, Pullanforderungen zu erstellen und/oder aufzugeben.

Screenshot des Pull-Anforderungsmenüs.

Auf der Registerkarte "Arbeitselemente " können Sie die Arbeitsaufgaben basierend auf von Ihnen erstellten Abfragen anzeigen oder die Standardabfrage verwenden, um Ihnen zugewiesene Arbeitsaufgaben anzuzeigen. Sie können auch eine Verzweigung basierend auf einer Arbeitsaufgabe erstellen, sodass Sie eine Arbeitsaufgabe mit Verzweigung zu zukünftigen Ablaufverfolgungszwecken verknüpfen können.

Screenshot des Menüs

Nächste Schritte