通过

使用用于 IntelliJ IDEA 和 Android Studio 的 Azure DevOps 插件

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

IntelliJ IDEA 是由 JetBrains 生成的 IDE。 你可以在其中 https://www.jetbrains.com/idea/找到更多关于它的信息。 借助用于 IntelliJ 的 Azure DevOps 插件，可以无缝直观地连接到 Git 存储库到 Azure DevOps。 还可以使用此插件将项目导入 Azure Repos，或在 Azure DevOps Git 存储库中创建拉取请求。

先决条件

类别 要求
组织 包含 Git 存储库 的 Azure DevOps 中的组织 。
工具 - IntelliJ IDEA。
- IntelliJ 插件。
- 适用于 Windows 的 Git 凭据管理器或适用于 macOS 和 Linux 的 Git SCM。

创建存储库

  1. 浏览 https://dev.azure.com/{your organization} 到并选择项目名称，导航到 Azure DevOps 中的项目。 可以从“ 所有 项目”列表中选择它，也可以从最近 访问的项目列表中 选择它。

    屏幕截图显示了“所选项目”。

    注释

    使用 Azure DevOps Services 时，项目 URL 的格式为 dev.azure.com/{your organization}/{your project}。 但是，仍支持引用该格式的 visualstudio.com 上一种格式。 有关详细信息，请参阅 Azure DevOps 简介，切换现有组织以使用新的域名 URL。

  2. 在 Web 门户的 “项目 ”区域中，选择 “代码”，然后选择当前存储库名称旁边的下拉列表，然后选择“ 新建存储库”。

    屏幕截图显示从 Web 门户选择新存储库。

  3. 在“ 创建新存储库 ”对话框中，验证 Git 是否为存储库类型，输入 DeepSpace 以获取新存储库名称，然后选择“ 创建”。

    屏幕截图显示“创建 Git 存储库”对话框中新存储库的“设置选项”。

将示例代码添加到存储库

  1. 选择“代码”窗口右上角的“克隆”，并复制“克隆 URL”。

    屏幕截图显示“检索克隆 URL”。

  2. 打开 Git 命令窗口（Git for Windows 上的 Git Bash），导航到要从存储在计算机上的存储库中的代码的文件夹，然后运行 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 Web 门户并刷新。 添加了文件。

    屏幕截图显示了 DeepSpace 文件。

在 IntelliJ 中克隆存储库

现在，我们有了一些示例代码的 Git 存储库，接下来让我们看看如何使用 IntelliJ IDEA 中的代码。 你甚至不需要知道存储库的 URL 才能克隆它。

  1. 打开 IntelliJ IDEA，然后 从版本控制中选择“签出 ”，然后选择 VSTS Git。

    屏幕截图显示了“克隆存储库”作。

  2. 登录到 Azure DevOps。

    屏幕截图显示了 Azure DevOps 登录。

  3. 选择 “登录”时，会显示标准的 Azure DevOps 登录 UI。 登录后，应会看到在 Azure DevOps 上有权访问的所有存储库的列表。 选择正确的存储库、 DeepSpace，然后选择“ 克隆 ”按钮。 此外，更改父目录，将存储库克隆到硬盘驱动器。

    屏幕截图显示了克隆存储库。

  4. 克隆完成后，IntelliJ 会询问你是否要打开该项目。 选择 “是 ”，最终应在 IntelliJ IDEA 中打开 DeepSpace 项目。

    显示 DeepSpace 项目的屏幕截图。

在 IntelliJ 中进行更改

  1. 确保使用 生成>生成项目生成项目。 如果系统提示你为项目添加 SDK，请添加计算机上安装的最新 Java JDK。

    若要立即运行项目以查看其用途，请执行以下步骤：

    1. 在 git 存储库中的 DeepSpace 根文件夹中，运行需要 Maven 安装的命令 mvn jetty:run。
    2. 从浏览器转到 http://localhost:3030/.

    恒星和行星应该飞来！ 如果你仔细观察，你可能会注意到地球不会飞来。

  2. 在我们的 DeepSpace 示例中，有一些代码部分已注释掉。如果在 IntelliJ 中打开 src/main/java/com.microsoft.tfs.demo/ImageService.java 该文件，可以看到其中一个部分。

    屏幕截图显示已注释掉地球。

    让我们在本地修复此代码部分。 通常，在 Git 存储库中工作时，应为工作创建分支并提交到该分支。 使用内置的 VCS>Git> 分支窗口通过 IntelliJ 创建分支。 出现提示时，请使用分支名称 fixBugs。 有了一个分支即可进行更改后，可以取消注释代码并重新生成项目。 如果按照前面的说明再次运行程序，则应看到地球飞过。

  3. 生成和测试更改后，可以使用 VCS>提交更改菜单在本地提交这些更改 。 在提交对话框中，会看到提交消息文本框上方的 VSTS 按钮。 选择该按钮可查看分配给你的工作项列表。 选择 “添加缺失地球 ”工作项，然后选择“ 确定”。 提交消息显示用工作项的类型、编号和标题填充的文本框，该文本框将工作项与将来的可跟踪性关联到此提交。

    屏幕截图显示了提交地球。

    此更改仅在本地完成;它尚未在我们的 Azure DevOps 存储库中更改。

创建拉取请求

可以将本地分支推送到服务器，并为团队创建拉取请求以供评审。 我们的插件可帮助你根据 IntelliJ 中的当前上下文创建拉取请求。 此作将保存几个步骤，无需切换到浏览器来创建拉取请求。

选择 VCS>Git>创建拉取请求。 此作将打开“ 创建拉取请求 ”对话框。 此对话框提供了许多信息，包括已更改的文件和要推送的提交。 可以向拉取请求提供标题和说明。

屏幕截图显示了“已创建拉取请求”。

选择“ 创建拉取请求”后，应会收到请求创建的通知。 如果想要添加特定审阅者或批注，它还包含拉取请求的链接。 代码评审完成后，可以将拉取请求合并到主分支。

检查生成状态

将更改合并到主分支后，可以在 IntelliJ 中检查 CI 生成是否成功。 在右下角，有一个图标显示生成状态。 如果看到绿色复选标记，则表示生成成功。 如果看到红色 X，则生成失败。 如果看到灰色问号，则找不到生成，或者凭据可能已过期。

屏幕截图显示了“生成”状态图标。

可以在图标上选择更多选项，例如查看生成详细信息、排队新生成和手动更新状态。

屏幕截图显示“生成状态”菜单。

查看拉取请求和工作项

在 “版本控制 ”菜单下，“ 拉取请求 ”和 “工作项 ”选项卡使你无需离开 IDE 即可查看所需的信息。 “ 拉取请求 ”选项卡显示你创建的当前拉取请求，并分配给你及其状态。 该选项卡还提供创建和/或放弃拉取请求的功能。

屏幕截图显示了“拉取请求”菜单。

在 “工作项 ”选项卡下，可以根据创建的查询查看工作项，或使用默认查询查看分配给你的工作项。 还可以基于工作项创建分支，以便可以将工作项与分支相关联，以便将来的可跟踪性目的。

屏幕截图显示了“工作项”菜单。

后续步骤

使用 DeepSpace IntelliJ 教程