Wtyczka Usługi Azure DevOps dla środowiska IntelliJ IDEA i programu Android Studio

Artykuł
04/04/2024

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

IntelliJ IDEA to środowisko IDE produkowane przez JetBrains. Więcej informacji na ten temat można znaleźć na stronie https://www.jetbrains.com/idea/. Wtyczka Azure DevOps dla środowiska IntelliJ umożliwia łączenie się z repozytoriami Git w usługach Azure DevOps Services i Team Foundation Server (TFS) w sposób bezproblemowy i intuicyjny. Możesz również użyć tej wtyczki do importowania projektów do usługi Azure Repos lub tworzenia żądań ściągnięcia w repozytorium Git usługi Azure DevOps Services/TFS.

W tym przewodniku pokazano, jak utworzyć repozytorium Git przy użyciu portalu internetowego usługi Azure DevOps Services, dodać przykładowy kod, a następnie sklonować repozytorium i utworzyć żądania ściągnięcia z poziomu środowiska IntelliJ IDEA.

Wymagania wstępne

Aby wykonać kroki opisane w tym przewodniku, potrzebne są następujące elementy:

Organizacja w usłudze Azure DevOps. Jeśli nie masz organizacji, możesz zarejestrować się bezpłatnie. Każda organizacja obejmuje bezpłatne, nieograniczone prywatne repozytoria Git.
Środowisko IntelliJ IDEA zainstalowane na maszynie. Jeśli go nie masz, pobierz środowisko IntelliJ IDEA.
Wtyczka Usługi Azure DevOps dla środowiska IntelliJ. Aby uzyskać instrukcje instalacji, zobacz stronę pobierania wtyczki IntelliJ. Ta wtyczka jest zgodna z wersjami IntelliJ IDEA Ultimate i Community, Android Studio, RubyMine, WebStorm, PhpStorm, PyCharm, AppCode, MPS, 0xDBE i CLion.
Narzędzia wiersza polecenia usługi Git.
- Aby zainstalować narzędzie Git dla systemu Windows, w tym Menedżera poświadczeń Git, zobacz Instalowanie menedżera poświadczeń Git.
- Aby zainstalować narzędzia Git dla systemów macOS i Linux, zobacz git-scm.com.

Tworzenie repozytorium

Przejdź do projektu w usłudze Azure DevOps, przechodząc do https://dev.azure.com/{your organization} i wybierając nazwę projektu. Możesz wybrać go z listy Wszystkie projekty lub z listy Ostatnio używane projekty, jeśli masz do niego dostęp ostatnio.

Uwaga

W przypadku usługi Azure DevOps Services format adresu URL projektu to dev.azure.com/{your organization}/{your project}. Jednak poprzedni format odwołujący visualstudio.com się do formatu jest nadal obsługiwany. Aby uzyskać więcej informacji, zobacz Wprowadzenie do usługi Azure DevOps, Przełącz istniejące organizacje, aby używać nowego adresu URL nazwy domeny.
W obszarze Projekt w portalu internetowym wybierz pozycję Kod, a następnie wybierz listę rozwijaną obok bieżącej nazwy repozytorium i wybierz pozycję Nowe repozytorium.
W oknie dialogowym Tworzenie nowego repozytorium sprawdź, czy usługa Git jest typem repozytorium, wprowadź wartość DeepSpace jako nazwę nowego repozytorium, a następnie kliknij przycisk Utwórz.

Dodawanie przykładowego kodu do repozytorium

Wybierz pozycję Clone (Klonuj) w prawym górnym rogu okna Code (Kod) i skopiuj wartość Clone URL (Klonuj adres URL).
Otwórz okno polecenia Git (Powłoka Git Bash w usłudze Git dla systemu Windows), przejdź do folderu, w którym chcesz utworzyć kod z repozytorium przechowywanego na komputerze, a następnie uruchom git clone ścieżkę skopiowaną z adresu URL klonowania w poprzednim kroku, jak pokazano w poniższym przykładzie.
```
git clone https://dev.azure.com/contoso-ltd/MyFirstProject/_git/DeepSpace
```
Przejdź do folderu DeepSpace, uruchamiając następujące polecenie.
```
cd DeepSpace
```
Pozostaw to okno otwarte, ponieważ będzie ono używane do kolejnych kroków.
Pobierz przykładowy kod deepspace i wyodrębnij go do katalogu lokalnego na komputerze, na którym sklonowane repozytorium DeepSpace.
Wróć do okna poleceń usługi Git i uruchom następujące polecenie, które zatwierdza przykładowe pliki kodu do lokalnego repozytorium.
```
git add --all
```
Mogą pojawić się ostrzeżenia informujące o tym, że kanały informacyjne linii zostaną zastąpione kanałami powrotnymi karetki (tj. Ostrzeżenie: LF zostanie zastąpiony przez CRLF). Te ostrzeżenia można zignorować.
Zatwierdź pliki w repozytorium lokalnym, uruchamiając następujące polecenie.
```
git commit -m "Committing DeepSpace sample files"
```
Uruchom następujące polecenie, aby wypchnąć zatwierdzenie przykładowych plików deepspace do repozytorium DeepSpace platformy Azure.
```
git push
```
Wróć do portalu internetowego usług Azure DevOps Services i odśwież go i zobaczysz dodane pliki.

Klonowanie repozytorium w środowisku IntelliJ

Teraz, gdy mamy repozytorium Git z przykładowym kodem, przyjrzyjmy się, jak możemy pracować z kodem z środowiska IntelliJ IDEA. Aby sklonować repozytorium usługi VSTS w środowisku IntelliJ, jest bardzo proste. Nie musisz nawet znać adresu URL repozytorium.

Otwórz środowisko IntelliJ IDEA i wybierz pozycję Wyewidencjonuj z kontroli wersji, a następnie wybierz pozycję VSTS Git.
Następnie zaloguj się do usług Azure DevOps Services...
Po kliknięciu pozycji Zaloguj zostanie wyświetlony standardowy interfejs użytkownika logowania usługi Azure DevOps Services. Po zalogowaniu powinna zostać wyświetlona lista wszystkich repozytoriów, do których masz dostęp w usłudze Azure DevOps Services. Wybierz odpowiednie repozytorium, DeepSpace i kliknij przycisk Klonuj. (Możesz również wybrać miejsce, w którym na dysku twardym sklonowane jest repozytorium, zmieniając katalog nadrzędny).
Po zakończeniu klonowania intelliJ wyświetli pytanie, czy chcesz otworzyć projekt. Kliknij przycisk Tak , a projekt DeepSpace powinien zostać otwarty w środowisku IntelliJ IDEA.

Wprowadzanie pewnych zmian w środowisku IntelliJ

Zacznij od upewnienia się, że projekt jest kompilowany przy użyciu polecenia Kompiluj>projekt Make. Jeśli zostanie wyświetlony monit o dodanie zestawu SDK dla projektu, po prostu dodaj najnowszy zestaw Java JDK zainstalowany na maszynie.

Jeśli chcesz teraz uruchomić projekt, aby zobaczyć, co robi, możesz wykonać następujące czynności:
1. W folderze głównym DeepSpace w repozytorium git uruchom polecenie mvn jetty:run (wymaga to zainstalowania narzędzia Maven)
2. W przeglądarce przejdź do strony http://localhost:3030/
Powinny być widoczne gwiazdy i planety latające! Jeśli przyjrzysz się bliżej, możesz zauważyć, że Ziemia nie lata.
W naszym przykładzie deepspace istnieją niektóre sekcje kodu, które zostały skomentowane. Jeśli otworzysz src/main/java/com.microsoft.tfs.demo/ImageService.java plik w środowisku IntelliJ, zobaczysz jedną z sekcji.

Naprawimy tę sekcję kodu lokalnie. Zazwyczaj podczas pracy w repozytorium Git należy utworzyć gałąź dla swojej pracy i zatwierdzić w tej gałęzi. Utwórz gałąź za pomocą środowiska IntelliJ przy użyciu wbudowanego okna Gałęzie Git> VCS.> Po wyświetleniu monitu użyj poprawki nazwy gałęziBugs. Po wprowadzeniu zmian w gałęzi możemy usunąć komentarz z kodu i ponownie skompilować projekt. Jeśli wykonasz powyższe instrukcje, aby ponownie uruchomić program, powinien zostać wyświetlony lot Ziemi.
Teraz, gdy nasze zmiany zostały skompilowane i przetestowane, możemy zatwierdzić je lokalnie przy użyciu menu Zatwierdź zmiany VCS>. W oknie dialogowym zatwierdzania zostanie wyświetlony przycisk usługi VSTS nad polem tekstowym komunikatu zatwierdzenia. Kliknij ten przycisk, aby wyświetlić listę elementów roboczych przypisanych do Ciebie. Wybierz element roboczy Add Missing Earth (Dodaj brak ziemi), a następnie kliknij przycisk OK. Zostanie wyświetlone pole tekstowe komunikatu zatwierdzenia wypełnione typem, liczbą i tytułem elementu roboczego. Spowoduje to skojarzenie elementu roboczego z tym zatwierdzeniem w celu śledzenia w przyszłości.

Należy pamiętać, że ta zmiana jest wykonywana tylko lokalnie; nie została jeszcze zmieniona w naszym repozytorium usługi Azure DevOps Services.

Tworzenie żądania ściągnięcia

Możesz wypchnąć gałąź lokalną do serwera i utworzyć żądanie ściągnięcia dla zespołu, aby go przejrzeć. Nasza wtyczka ułatwia tworzenie żądania ściągnięcia na podstawie bieżącego kontekstu w środowisku IntelliJ. Spowoduje to zapisanie kilku kroków i wyeliminowanie konieczności przełączenia się do przeglądarki w celu utworzenia żądania ściągnięcia.

Aby to zrobić, po prostu wybierz pozycję GIT Utwórz żądanie ściągnięcia vcS>>. Spowoduje to otwarcie okna dialogowego Tworzenie żądania ściągnięcia. To okno dialogowe zawiera wiele informacji, w tym pliki, które uległy zmianie, oraz zatwierdzenia, które zostaną wypchnięte. Możesz nadać żądaniu ściągnięcia tytuł i opis.

Tworzenie żądania ściągnięcia

Po kliknięciu przycisku Utwórz żądanie ściągnięcia powinno zostać wyświetlone powiadomienie o utworzeniu żądania ściągnięcia. Zawiera również link do żądania ściągnięcia w przypadku dodania określonych recenzentów lub komentarzy. Po zakończeniu przeglądów kodu można scalić żądanie ściągnięcia z gałęzią główną.

Sprawdzanie stanu kompilacji

Po scaleniu zmian w gałęzi głównej możesz sprawdzić, czy kompilacja ciągłej integracji zakończyła się pomyślnie z poziomu środowiska IntelliJ. W prawym dolnym rogu znajduje się ikona, która wyświetla stan kompilacji. Jeśli zostanie wyświetlony zielony znacznik wyboru, oznacza to, że kompilacja zakończyła się pomyślnie. Jeśli zostanie wyświetlony czerwony znak X, kompilacja nie powiodła się. Jeśli widzisz szary znak zapytania, kompilacja nie została znaleziona lub poświadczenia mogły wygasły.

Ikony stanu kompilacji

Możesz kliknąć ikonę, aby uzyskać więcej opcji, takich jak wyświetlanie szczegółów kompilacji, kolejkowanie nowej kompilacji i ręczne aktualizowanie stanu.

Wyświetlanie żądań ściągnięcia i elementów roboczych

W menu Kontrola wersji istnieje karta Żądanie ściągnięcia i karta Elementy robocze, aby umożliwić łatwe wyświetlanie potrzebnych informacji bez opuszczania środowiska IDE. Na karcie Żądanie ściągnięcia są wyświetlane bieżące żądania ściągnięcia utworzone przez Ciebie i przypisane do Ciebie wraz z ich stanem. Karta umożliwia również tworzenie i/lub porzucanie żądań ściągnięcia.

Na karcie Elementy robocze można wyświetlić elementy robocze na podstawie utworzonych zapytań lub użyć domyślnego zapytania, aby wyświetlić przypisane elementy robocze. Można również utworzyć gałąź opartą na elemencie roboczym, aby można było skojarzyć element roboczy z gałęzią w celu zapewnienia przyszłej możliwości śledzenia.