Использование подключаемого модуля Azure DevOps для IntelliJ IDEA и Android Studio

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

IntelliJ IDEA — это интегрированная среда разработки, созданная JetBrains. Вы можете узнать больше об этом на https://www.jetbrains.com/idea/. Подключаемый модуль Azure DevOps для IntelliJ позволяет подключаться к репозиториям Git в Azure DevOps простым и интуитивно понятным способом. Этот подключаемый модуль также можно использовать для импорта проектов в Azure Repos или создания запросов на вытягивание в репозитории Azure DevOps Git.

Предпосылки

Создание репозитория

1. Перейдите к проекту в Azure DevOps, перейдя по адресу https://dev.azure.com/{your organization} и выбрав имя проекта. Вы можете выбрать его в списке "Все проекты" или в списке "Последние проекты", если вы недавно к ним обращаетесь.

   

   Замечание

   При использовании Azure DevOps Services формат URL-адреса проекта — dev.azure.com/{your organization}/{your project}это формат. Однако предыдущий формат, ссылающийся на visualstudio.com формат, по-прежнему поддерживается. Дополнительные сведения см. в статье "Знакомство с Azure DevOps" для переключения существующих организаций на использование нового URL-адреса доменного имени.

2. В области "Проект " на веб-портале выберите код, а затем щелкните раскрывающийся список рядом с текущим именем репозитория и выберите новый репозиторий.

   

3. В диалоговом окне "Создание нового репозитория " убедитесь, что Git является типом репозитория, введите DeepSpace для нового имени репозитория и нажмите кнопку "Создать".

   

Добавление примера кода в репозиторий

1. Выберите "Клонировать " в правом верхнем углу окна "Код" и скопируйте URL-адрес клонирования.

   

2. Откройте командное окно Git (Git Bash в Git для Windows), перейдите в папку, в которой требуется код из репозитория, хранящегося на компьютере, и запустите git clone путь, скопированный из URL-адреса клонирования на предыдущем шаге, как показано в следующем примере.

   git clone https://dev.azure.com/contoso-ltd/MyFirstProject/_git/DeepSpace
   

3. Перейдите в папку DeepSpace, выполнив следующую команду.

   cd DeepSpace
   

   Сохраните это окно открытым для использования в последующих шагах.

4. Скачайте пример кода DeepSpace и извлеките его в локальный каталог на компьютере, где вы клонировали репозиторий DeepSpace.

5. Вернитесь в командное окно Git и выполните следующую команду, которая фиксирует примеры файлов кода в локальном репозитории.

   git add --all
   

   Вы можете увидеть некоторые предупреждения о том, что каналы строк заменяются на каналы возвращаемой строки каретки. Эти предупреждения можно игнорировать.

6. Зафиксируйте файлы в локальном репозитории, выполнив следующую команду.

   git commit -m "Committing DeepSpace sample files"
   

7. Выполните следующую команду, чтобы отправить фиксацию примеров файлов DeepSpace в репозиторий Azure Repos DeepSpace.

   git push
   

8. Вернитесь на веб-портал Azure DevOps и обновите его. Добавлены файлы.

   

Клонирование репозитория в IntelliJ

Теперь, когда у нас есть репозиторий Git с некоторыми примерами кода, давайте рассмотрим, как мы можем работать с кодом из IntelliJ IDEA. Вам даже не нужно знать URL-адрес репозитория, чтобы клонировать его.

1. Откройте IntelliJ IDEA и выберите "Извлечь из системы управления версиями" , а затем выберите VSTS Git.

   

2. Войдите в Azure DevOps.

   

3. При нажатии кнопки "Вход" отображается стандартный пользовательский интерфейс входа Azure DevOps. После входа вы увидите список всех репозиториев, к которых у вас есть доступ к Azure DevOps. Выберите правильный репозиторий, DeepSpace и нажмите кнопку "Клонировать ". Также измените родительский каталог, где репозиторий клонируется на жесткий диск.

   

4. После завершения клона IntelliJ попросит вас открыть проект. Выберите "Да ", и в конечном итоге проект DeepSpace открыт в IntelliJ IDEA.

   

Внесение некоторых изменений в IntelliJ

1. Убедитесь, что проект выполняет сборку с помощью проекта Build>Make. Если вам будет предложено добавить пакет SDK для проекта, добавьте последнюю версию Java JDK, установленную на компьютере.

   Чтобы запустить проект, чтобы узнать, что это делает, сделайте следующее:

   1. В корневой папке DeepSpace в репозитории Git выполните команду mvn jetty:run, требующую установки Maven.
   2. В браузере перейдите в раздел http://localhost:3030/.

   Звезды и планеты должны летать! Если вы внимательно посмотрите, вы можете заметить, что Земля не летает.

2. В нашем примере DeepSpace есть некоторые разделы кода, которые закомментированы. Если открыть src/main/java/com.microsoft.tfs.demo/ImageService.java файл в IntelliJ, вы увидите один из разделов.

   

   Давайте исправим этот раздел кода локально. Как правило, при работе в репозитории Git необходимо создать ветвь для работы и зафиксировать ее. Создайте ветвь с помощью IntelliJ с помощью встроенного окнаветвей>>. При появлении запроса используйте имя ветви fixBugs. После того как у нас есть ветвь для внесения изменений, мы можем раскомментировать код и перестроить проект. Если вы следуйте предыдущим инструкциям, чтобы снова запустить программу, вы увидите Землю летать.

3. Теперь, когда наши изменения созданы и протестированы, мы можем зафиксировать их локально с помощью меню"Изменения фиксации>". В диалоговом окне фиксации появится кнопка VSTS над текстовым полем фиксации. Нажмите эту кнопку, чтобы просмотреть список рабочих элементов, назначенных вам. Выберите элемент "Добавить недостающую землю " и нажмите кнопку "ОК". Сообщение о фиксации отображает текстовое поле, заполненное типом, номером и заголовком рабочего элемента, которое связывает рабочий элемент с этой фиксацией для отслеживания в будущем.

   

   Это изменение выполняется только локально; Это еще не изменилось в репозитории Azure DevOps.

Создание pull request

Вы можете отправить локальную ветвь на сервер и создать запрос на вытягивание для проверки команды. Наш подключаемый модуль помогает создать запрос на вытягивание на основе текущего контекста в IntelliJ. Это действие сохраняет несколько шагов и устраняет необходимость переключиться в браузер для создания запроса на вытягивание.

Выберите VCS>Git>Create Pull Request. Это действие открывает диалоговое окно "Создать запрос на вытягивание ". В этом диалоговом окне содержится много сведений, включая измененные файлы и фиксации для отправки. Вы можете предоставить запрос на вытягивание заголовок и описание.

После нажатия кнопки "Создать запрос на вытягивание" необходимо получить уведомление о создании запроса на вытягивание. Она также содержит ссылку на запрос на вытягивание в случае добавления определенных рецензентов или комментариев. После завершения проверки кода можно объединить запрос на вытягивание в основную ветвь.

Проверка состояния сборки

После слияния изменений в основную ветвь можно проверить, успешно ли выполнена сборка CI из IntelliJ. В правом нижнем углу появится значок, в котором отображается состояние сборки. Если вы видите зеленый флажок, это означает, что сборка выполнена успешно. Если вы видите красный X, то сбой сборки. Если вы видите серый вопросительный знак, сборка не найдена или учетные данные могут быть просроченными.

Вы можете выбрать значок для получения дополнительных параметров, таких как просмотр сведений о сборке, очередь новой сборки и обновление состояния вручную.

Просмотр запросов на вытягивание и рабочих элементов

В меню "Управление версиями " вкладки "Запрос на вытягивание " и " Рабочие элементы " позволяют просматривать необходимые сведения без выхода из интегрированной среды разработки. На вкладке "Запрос на вытягивание" отображаются текущие запросы на вытягивание, созданные вами и назначенные вам вместе с их состоянием. На вкладке также можно создавать запросы на вытягивание или отказаться от нее.

На вкладке "Рабочие элементы" можно просмотреть рабочие элементы на основе созданных запросов или использования запроса по умолчанию для просмотра рабочих элементов, назначенных вам. Вы также можете создать ветвь на основе рабочего элемента, чтобы связать рабочий элемент с ветвью для будущих целей трассировки.

Дальнейшие шаги

Связанные статьи

• Просмотр часто задаваемых вопросов о подключаемом модуле IntelliJ