檢閱提取要求 - Amazon CodeCatalyst

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

檢閱提取要求

您可以使用 Amazon CodeCatalyst 主控台協同審查提取請求中包含的變更並加上註解。您可以在來源分支和目的地分支之間的差異,或者提取請求修訂之間的差異,將註解新增至個別程式碼行。您可以選擇建立提取要求中程式碼變更留下的註解摘要,以協助您快速瞭解其他使用者留下的意見反應。您也可以選擇建立開發環境來處理程式碼。

注意
注意

由 Amazon 基岩提供支援: AWS 實自動濫用偵測。由於為我撰寫說明建立內容摘要推薦任務使用 Amazon Q 建立或新增功能至專案,以及使用 Amazon Q 軟體開發功能將問題指派給 Amazon Q 功能,因此使用者可以充分利用 Amazon Beddrock 中實作的控制來強制執行安全性、安全性和負責任的人工智慧 (AI)。

提示

您可以配置哪些拉請求事件,您將收到有關電子郵件作為您的個人資料的一部分。如需詳細資訊,請參閱從發送 Slack 和電子郵件通知 CodeCatalyst

提取要求會顯示提取要求的修訂版本與您建立提取要求時目的地分支提示的提交之間的差異。這就是所謂的合併基礎。有關 Git 中差異和合併基礎的更多信息,請參閱 Git 文檔git-merge-base中的。

提示

在控制台中工作時,特別是如果您已經打開了一段時間的提取請求,請考慮重新整理瀏覽器,以確保您在開始審核提取請求之前擁有最新版本可用於提取請求。

在 CodeCatalyst 主控台中檢閱提取要求
  1. 導航到您的項目。

  2. 執行下列其中一項作業,以瀏覽至提取要求:

    • 如果提取請求列在項目頁面上,請從列表中選擇它。

    • 如果提取請求未列在專案頁面上,請選擇 [檢視全部]。使用篩選器並排序來尋找提取請求,然後從清單中選擇。

    • 在功能窗格中,選擇 [程式],然後選擇 [提取要求]。

  3. 從清單中選擇您要檢閱的提取請求。您可以在篩選列中輸入提取要求的一部分名稱來篩選提取要求清單。

  4. 概觀中,您可以查看提取請求的名稱和標題。您可以創建和查看提取請求本身留下的註釋。您也可以檢視提取請求的詳細資訊,包括工作流程執行、連結問題、檢閱者、提取請求的作者,以及可行合併策略的相關資訊。

    注意

    在特定程式碼行上留下的註解會出現在變更中。

  5. (選擇性) 若要新增套用至整個提取要求的註解,請展開提取要求的註解,然後選擇 [建立註解]。

  6. (選擇性) 若要檢視此提取請求修訂版本變更所留下的所有註解摘要,請選擇「建立註解摘要」。

    注意

    此功能需要為該空間啟用生成 AI 功能,並且僅在美國西部 (奧勒岡) 區域提供。如需詳細資訊,請參閱管理生成 AI 功能

  7. 變更中,您可以看到目的地分支與提取請求的最新修訂版之間的差異。如果有多個修訂版,您可以變更要比較哪些修訂版本,以及它們之間的差異。如需修訂的詳細資訊,請參閱修訂

    提示

    您可以在「檔案變更」中快速檢視提取要求中有多少檔案有變更,以及提取請求中的哪些檔案有其註解。資料夾旁邊顯示的註解數目表示該資料夾中檔案的註解數目。展開資料夾以檢視資料夾中每個檔案的注釋數量。

  8. 若要變更差異的顯示方式,請選擇「統一」和「分割」。

  9. 若要將註解新增至提取要求的行,請前往您要加上註解的行。選擇該行顯示的註解圖示,輸入註解,然後選擇 [儲存]。

  10. 若要檢視提取請求中修訂之間的變更,或在其來源與目的地分支之間檢視變更,請從比較中的可用選項中選擇。修訂中的行的註解會保留在這些修訂中。

  11. 如果您已將工作流程設定為針對提取要求觸發程式產生程式碼涵蓋範圍報告,則可以在相關提取要求中檢視明細行與分支涵蓋範圍的發現項目。若要隱藏程式碼涵蓋範圍發現項目,請選擇隱藏程式 如需詳細資訊,請參閱代碼覆蓋率報告

  12. 如果您想要變更提取要求的程式碼,您可以從提取要求建立開發環境。選擇 [建立開發環境]。選擇性地新增開發環境的名稱或編輯其組態,然後選擇 [建立]。

  13. 在「報表」中,您可以在此提取請求中查看質量報表。如果有多個修訂版,您可以變更要比較哪些修訂版本,以及它們之間的差異。您可以按名稱、狀態、工作流程、操作和類型來過濾報表。

    注意

    工作流程必須設定為產生報表,以便它們顯示在您的提取請求中。如需詳細資訊,請參閱在操作中配置質量報表

  14. 若要檢視特定報告,請從清單中選擇該報告。如需詳細資訊,請參閱以工作流程測試

  15. 如果您被列為此提取請求的複查者,並且想要核准變更,請確定您正在檢視最新的版次,然後選擇「核准」。

    注意

    所有必要的審核者都必須先核准提取請求,才能合併提取請求。