Azure DevOpsный подключаемый модуль для идеи и Android Studio IntelliJ

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015

IntelliJ идея — это интегрированная среда разработки, созданная JetBrains. Дополнительные сведения можно найти по адресу https://www.jetbrains.com/idea/ . подключаемый модуль Azure DevOps для IntelliJ позволяет подключаться к репозиториям Git на Azure DevOps Services и Team Foundation Server (TFS) простым и интуитивно понятным способом. этот подключаемый модуль также можно использовать для импорта проектов в Azure Repos или создания запросов на вытягивание в репозитории Azure DevOps Services/тфс Git.

в этом руководство мы покажем, как создать репозиторий Git с помощью веб-портала Azure DevOps Services, добавить пример кода, а затем клонировать репозиторий и создавать запросы на вытягивание из IntelliJ идеи.

Предварительные требования

Для выполнения действий, описанных в этом руководстве, необходимо следующее.

  • Организация в Azure DevOps. Если у вас нет организации, вы можете зарегистрироваться на нее бесплатно. Каждая организация включает бесплатные, неограниченные частные репозитории Git.
  • IntelliJ идея, установленная на компьютере. Если у вас ее нет, получите INTELLIJ идею.
  • подключаемый модуль Azure DevOps для IntelliJ. Инструкции по установке см. на странице загрузки подключаемого модуля IntelliJ . этот подключаемый модуль совместим с IntelliJ edition Ultimate и Community, Android Studio, рубимине, фпсторм, PyCharm, затраченный, MPS, 0xDBE и клион.
  • Средства командной строки Git.

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

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

    Выбор проекта

    Примечание

    Project url-адреса были изменены в выпуске Azure DevOps Services и теперь имеют формат dev.azure.com/{your organization}/{your project} , но можно использовать существующий visualstudio.com формат. дополнительные сведения см. в разделе Visual Studio Team Services теперь Azure DevOps Services.

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

    Выбор нового репозитория на веб-портале

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

    Задание параметров для нового репозитория в диалоговом окне

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

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

    Получение URL-адреса клона

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

    git clone https://dev.azure.com/contoso-ltd/MyFirstProject/_git/DeepSpace
    
  3. Перейдите в папку Дипспаце, выполнив следующую команду.

    cd DeepSpace
    

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

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

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

    git add --all
    

    Вы можете увидеть некоторые предупреждения о том, что каналы перевода строки будут заменены каналами возврата каретки (т. е. Предупреждение: LF будет заменено на CRLF). Эти предупреждения можно игнорировать.

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

    git commit -m "Committing DeepSpace sample files"
    
  7. выполните следующую команду, чтобы отправить фиксацию образцов файлов дипспаце в репозиторий дипспаце Azure Repos.

    git push
    
  8. вернитесь на веб-портал Azure DevOps Services и обновите, и вы увидите добавленные файлы.

    Файлы Дипспаце

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

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

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

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

  2. Затем просто войдите в Azure DevOps Services...

    Azure DevOps Services вход

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

    Снимок экрана, показывающий Клонирование репозитория.

  4. После завершения клонирования IntelliJ запросит, хотите ли вы открыть проект. Нажмите кнопку Да , и вы получите проект дипспаце , Открытый в идее IntelliJ.

    Проект Дипспаце

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

  1. Сначала убедитесь, что проект строится с помощью сборкиmake Project. Если будет предложено добавить пакет SDK для проекта, просто добавьте последнюю версию Java JDK, установленную на компьютере.

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

    1. Из корневой папки Дипспаце в репозитории Git выполните команду mvn jetty:run (для этого требуется установка Maven).
    2. В браузере перейдите по адресу http://localhost:3030/

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

  2. В нашем примере дипспаце есть несколько разделов кода, которые были добавлены в комментарий. Если открыть файл в IntelliJ, можно увидеть один из разделов.

    Земля — комментарий

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

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

    Фиксация земли

    Обратите внимание, что это изменение выполняется только локально. он еще не был изменен в нашем репозитории Azure DevOps Services.

Создание запроса на включение изменений

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

Чтобы сделать это, просто выберите VCSGitсоздать запрос на вытягивание. Откроется диалоговое окно Создание запроса на вытягивание . В этом диалоговом окне содержится много информации, включая измененные файлы и фиксации, которые будут отправлены. Можно дать запросу на вытягивание заголовок и описание.

Создать запрос на вытягивание

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

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

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

Значки состояния сборки

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

Меню

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

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

Меню запроса на вытягивание

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

Меню

Next Steps