共用方式為


使用適用於 IntelliJ IDEA 和 Android Studio 的 Azure DevOps 外掛程式

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

IntelliJ IDEA 是由 JetBrains 產生的 IDE。 您可以在 https://www.jetbrains.com/idea/了解更多信息。 適用於 IntelliJ 的 Azure DevOps 外掛程式 可讓您以順暢且直覺的方式連線到 Git 存放庫至 Azure DevOps。 您也可以使用此外掛程式將專案匯入 Azure Repos,或在 Azure DevOps Git 存放庫中建立提取要求。

先決條件

類別 需求
組織 Azure DevOps 中具有 Git 存放庫的 組織。
工具 - IntelliJ IDEA
- IntelliJ 外掛程式
- 適用於 Windows 的 Git 認證管理員,或macOS和Linux Git SCM

建立存放庫

  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 作為新存放庫名稱,然後選取 [建立 ]。

    螢幕快照:顯示 [建立 Git 存放庫] 對話框中新存放庫的 [設定選項]。

將範例程式代碼新增至存放庫

  1. 選取 [程式代碼] 視窗右上角的 [ 複製版本],然後複製 複製 URL

    螢幕快照顯示取得克隆 URL。

  2. 開啟 Git 命令行窗口 (在 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 入口網站並重新整理。 已新增檔案。

    螢幕快照顯示 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 根資料夾,執行命令 mvn jetty:run,這需要 Maven 安裝。
    2. 從瀏覽器移至 http://localhost:3030/.

    恆星和行星應該正在快速掠過! 如果您仔細觀察,您可能會注意到地球不會飛來飛去。

  2. 在我們的 DeepSpace 範例中,有一些程式代碼區段已標記為批註。如果您在 IntelliJ 中開啟 src/main/java/com.microsoft.tfs.demo/ImageService.java 檔案,您可以看到其中一個區段。

    螢幕快照顯示地球已被註解掉。

    讓我們在本機修正這段程式碼。 一般而言,在 Git 存放庫中工作時,您應該為工作建立分支,並將修改提交到該分支。 使用內建 VCS>Git>Branch 視窗,透過 IntelliJ 建立分支。 出現提示時,請使用分支名稱 fixBugs。 一旦有分支可進行變更,就可以取消批注程式代碼並重建專案。 如果您遵循先前的指示再次執行程式,您應該會看到地球飛來飛去。

  3. 既然我們的變更已建置和測試,我們可以使用 VCS>認可變更 功能表,在本機認可這些變更。 在 [認可] 對話框中,您會看到 [認可消息] 文本框上方的 [VSTS] 按鈕。 在該按鈕上選取,以檢視指派給您的工作項目清單。 選取 [新增遺漏地球 工作專案],然後選取 [確定] [確定]。 認可訊息會顯示填入工作專案類型、編號和標題的文字方塊,將工作專案連結於此認可,以利未來追蹤。

    螢幕快照顯示 [認可地球]。

    這項變更只會在本機完成;Azure DevOps 存放庫中尚未變更。

建立提取要求

您可以將本機分支推送至伺服器,並建立提取要求以供小組檢閱。 我們的外掛程式可協助您根據 IntelliJ 中的目前內容建立提取要求。 此操作可省去多個步驟,也無需切換至瀏覽器來建立拉取請求。

選取 VCS>Git>建立提取要求。 此動作會開啟 建立拉取請求 對話框。 此對話框提供許多資訊,包括修改的檔案以及要推送的提交。 您可以提供提取要求標題和描述。

螢幕快照顯示已建立的提取要求。

選取 [建立提取要求之後,您應該會收到提取要求已建立的通知。 它也包含提取要求的連結,以防您想要新增特定的檢閱者或批注。 程式代碼檢閱完成後,您可以將拉取請求合併到主分支。

檢查組建狀態

將變更合併到主要分支之後,您可以檢查 CI 組建是否從 IntelliJ 內成功。 在右下角,有一個圖示會顯示您的組建狀態給您。 如果您看到綠色對勾,這代表您的組建成功。 如果您看到紅色 X,則組建失敗。 如果您看到灰色問號,則找不到您的組建,或您的認證可能已過期。

螢幕快照顯示 [建置狀態] 圖示。

您可以選取圖示以取得更多選項,例如檢視組建詳細數據、排入新組建佇列,以及手動更新狀態。

截圖顯示建置狀態功能表。

檢視提取要求和工作專案

在 [版本控制] 功能表下,[拉取請求] 和 [工作專案] 標籤可讓您檢視所需的資訊,而無需離開 IDE。 [拉取請求] 索引標籤顯示您目前所建立的拉取請求及指派給您的拉取請求,並顯示它們的狀態。 索引標籤也可讓您建立和/或放棄提取要求。

螢幕快照顯示 [提取要求] 功能表。

在 [工作專案] 索引標籤底下,您可以根據您所建立的查詢檢視工作專案,或使用預設查詢來查看指派給您的工作專案。 您也可以根據工作專案建立分支,以便建立工作專案與分支的關聯,以供日後追蹤之用。

螢幕快照顯示 [工作項目] 功能表。

後續步驟