Azure DevOps Plug-In für IntelliJ IDEA und Android Studio

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

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 auf Azure DevOps Services und Team Foundation Server (TFS) herstellen. Sie können dieses Plug-In auch verwenden, um Projekte in Azure Repos zu importieren oder Pullanforderungen in Ihrem Azure DevOps Services/TFS Git-Repository zu erstellen.

In diesem Leitfaden zeigen wir Ihnen, wie Sie ein Git-Repo mithilfe des Azure DevOps Services Webportals erstellen, Beispielcode hinzufügen und dann das Repo klonen und Pullanforderungen alle innerhalb von IntelliJ IDEA erstellen.

Voraussetzungen

Um die Schritte in diesem Leitfaden auszuführen, benötigen Sie Folgendes:

  • Eine Organisation in Azure DevOps. Wenn Sie keine Organisation haben, können Sie sich kostenlos für eine organisation registrieren . Jede Organisation enthält kostenlose, unbegrenzte private Git-Repositorys.
  • IntelliJ IDEA auf Ihrem Computer installiert. Wenn Sie dies nicht haben, erhalten Sie IntelliJ IDEA.
  • Das Azure DevOps Plug-In für IntelliJ. Anweisungen zum Installieren finden Sie auf der Downloadseite des IntelliJ-Plug-Ins . Dieses Plug-In ist kompatibel mit IntelliJ IDEA Ultimate und Community Editionen, Android Studio, RubyMine, WebStorm, PhpStorm, PyCharm, AppCode, MPS, 0xDBE und CLion.
  • Git-Befehlszeilentools.

Erstellen eines Repositorys

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

    Select project

    Hinweis

    Bei Azure DevOps Services ist 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 in der Einführung in Azure DevOps, indem Sie vorhandene Organisationen wechseln, um die neue Domänennamen-URL zu verwenden.

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

    Choose new repository from the web portal

  3. Stellen Sie im Dialogfeld "Neues Repository erstellen " sicher, dass Git der Repositorytyp ist, geben Sie DeepSpace für Ihren neuen Repositorynamen ein, und klicken Sie auf "Erstellen".

    Set options for your new repo in the Create a Git repo dialog

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.

    Retrieve the clone 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 auf Ihrem Computer gespeicherten Repository gespeichert werden soll, und führen Sie git clone den Pfad aus, der im vorherigen Schritt kopiert wurde, 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, während Sie es für nachfolgende Schritte verwenden.

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

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

    git add --all
    

    Möglicherweise werden einige Warnungen angezeigt, die angeben, dass die Zeilenfeeds durch Wagenrücklauffeeds ersetzt werden (z. B. Warnung: LF wird durch CRLF ersetzt). Diese Warnungen können ignoriert werden.

  6. Übernehmen Sie die Dateien an das lokale Repository, indem Sie den folgenden Befehl ausführen.

    git commit -m "Committing DeepSpace sample files"
    
  7. Führen Sie den folgenden Befehl aus, um den Commit von DeepSpace-Beispieldateien bis zu Ihrem Azure Repos DeepSpace-Repo hochzuschieben.

    git push
    
  8. Wechseln Sie zurück zum Azure DevOps Services-Webportal und aktualisieren Sie, und Sie können die hinzugefügten Dateien sehen.

    DeepSpace files

Klonen Despo in IntelliJ

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

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

    Clone repo

  2. Melden Sie sich als Nächstes bei Azure DevOps Services an...

    Azure DevOps Services Sign-in

  3. Wenn Sie auf "Anmelden" klicken, erhalten Sie die Standard-Azure DevOps Services Anmelde-UI. Nach der Anmeldung sollte die Liste aller Repositorys angezeigt werden, auf die Sie auf Azure DevOps Services zugreifen können. Wählen Sie das richtige Repository, DeepSpace aus, und klicken Sie auf die Schaltfläche " Klonen ". (Möglicherweise möchten Sie auch auswählen, wo auf Ihrer Festplatte das Repo geklont wird, indem Sie das übergeordnete Verzeichnis ändern.)

    Screenshot that shows cloning a repo.

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

    DeepSpace project

Nehmen Sie einige Änderungen in IntelliJ vor

  1. Stellen Sie zunächst sicher, dass die Projektbuilds mithilfe des BuildMake-Projekts> erstellt werden. Wenn Sie aufgefordert werden, ein SDK für das Projekt hinzuzufügen, fügen Sie einfach das neueste Java JDK hinzu, das auf Ihrem Computer installiert ist.

    Wenn Sie das Projekt jetzt ausführen möchten, um zu sehen, was es tut, können Sie folgendes tun:

    1. Führen Sie aus dem DeepSpace-Stammordner in Ihrem Git-Repo den Befehl mvn jetty:run aus (dies erfordert, dass maven installiert werden muss)
    2. Wechseln Sie von einem Browser zu http://localhost:3030/

    Sie sollten Sterne und Planeten sehen, die fliegen! Wenn Sie genau schauen, können Sie feststellen, dass die Erde nicht vorbei fliegt.

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

    Earth commented out

    Lassen Sie uns diesen Codeabschnitt lokal beheben. Normalerweise sollten Sie bei der Arbeit in einem Git-Repo eine Verzweigung für Ihre Arbeit erstellen und diesen Verzweigung übernehmen. Erstellen Sie eine Verzweigung über IntelliJ mithilfe des integrierten VCSGitBranches-Fensters>>. Wenn Sie dazu aufgefordert werden, verwenden Sie den Verzweigungsnamen fixBugs. Sobald wir eine Verzweigung haben, um unsere Änderungen vorzunehmen, können wir den Code aufheben und das Projekt neu erstellen. Wenn Sie den obigen Anweisungen folgen, um das Programm erneut auszuführen, sollten Sie die Erde fliegen sehen.

  3. Nachdem unsere Änderungen erstellt und getestet wurden, können wir sie lokal mithilfe des VCSCommit-Menüs>"Änderungen" übernehmen. Im Commit-Dialogfeld wird oberhalb des Textfelds für Commitnachrichten eine VSTS-Schaltfläche angezeigt. Klicken Sie auf diese Schaltfläche, um Ihre Liste der Ihnen zugewiesenen Arbeitselemente anzuzeigen. Wählen Sie das Arbeitselement "Fehlende Erde hinzufügen " aus, und klicken Sie auf "OK". Das Textfeld "Commitnachricht" wird mit dem Typ, der Nummer und dem Titel des Arbeitselements aufgefüllt. Dadurch wird die Arbeitsaufgabe diesem Commit für die Rückverfolgbarkeit in der Zukunft zugeordnet.

    Commit Earth

    Beachten Sie, dass diese Änderung nur lokal erfolgt; es wurde noch nicht in unserem Azure DevOps Services-Repo geändert.

Erstellen eines Pull Request

Sie können Ihre lokale Verzweigung an den Server senden und eine Pullanforderung für Ihr Team erstellen, um die Überprüfung zu überprüfen. Unser Plug-In hilft Ihnen, die Pullanforderung basierend auf Ihrem aktuellen Kontext innerhalb von IntelliJ zu erstellen. Dadurch werden mehrere Schritte gespeichert und die Notwendigkeit beseitigt, dass Sie zu Ihrem Browser wechseln müssen, um die Pullanforderung zu erstellen.

Um dies zu erreichen, wählen Sie einfach VCSGitCreate>>Pull Request aus. Dadurch wird das Dialogfeld "Pullanforderung erstellen" geöffnet. Dieses Dialogfeld enthält viele Informationen, einschließlich der Dateien, die geändert wurden, und die Commits, die pusht werden. Sie können der Pullanforderung einen Titel und eine Beschreibung geben.

Create pull request

Nachdem Sie auf " Pullanforderung erstellen" geklickt haben, sollten Sie eine Benachrichtigung erhalten, dass die Pullanforderung erstellt wurde. Es enthält auch einen Link zur Pullanforderung, wenn Sie bestimmte Prüfer 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 Ihre Hauptzweige zusammengeführt haben, können Sie überprüfen, ob Ihr CI-Build innerhalb von IntelliJ erfolgreich war. In der unteren rechten Ecke gibt es ein Symbol, das Ihren Buildstatus für Sie anzeigt. Wenn ein grünes Häkchen angezeigt wird, bedeutet das, dass Ihr Build erfolgreich war. Wenn ein rotes X angezeigt wird, ist ihr Build fehlgeschlagen. Wenn ein graues Fragezeichen angezeigt wird, wurde Ihr Build nicht gefunden, oder Ihre Anmeldeinformationen sind möglicherweise abgelaufen.

Build status icons

Sie können auf das Symbol klicken, um weitere Optionen zu erhalten, z. B. das Anzeigen von Builddetails, das Anstehen eines neuen Builds und das manuelle Aktualisieren des Status.

Build status menu

Anzeigen von Pullanforderungen und Arbeitselementen

Im Menü "Versionssteuerung " ist eine Registerkarte " Pull-Anforderung " und " Arbeitselemente " vorhanden, damit Sie die benötigten Informationen einfach anzeigen können, ohne die IDE verlassen zu müssen. Auf der Registerkarte "Pullanforderung" werden die aktuellen Pull-Anforderungen angezeigt, die Von Ihnen erstellt wurden und Ihnen zusammen mit ihrem Status zugewiesen sind. Die Registerkarte bietet Ihnen auch die Möglichkeit, Pull-Anforderungen zu erstellen und/oder aufzugeben.

Pull request menu

Auf der Registerkarte "Arbeitselemente " können Sie die Arbeitselemente basierend auf Abfragen anzeigen, die Sie erstellt haben oder die Standardabfrage verwenden, um Arbeitselemente anzuzeigen, die Ihnen zugewiesen sind. Sie können auch eine Verzweigung basierend auf einem Arbeitselement erstellen, sodass Sie ein Arbeitselement mit Zweig für zukünftige Ablaufverfolgungszwecke zuordnen können.

Work items menu

Nächste Schritte