原始檔控制外掛程式架構
您可以藉由實作和附加原始檔控制外掛程式,將原始檔控制支援新增至 Visual Studio 整合的開發環境 (IDE)。 IDE 會透過定義完善的原始檔控制外掛程式 API 連線至原始檔控制外掛程式。 IDE 會藉由提供由工具列和功能表命令組成的使用者介面 (UI) 公開原始檔控制系統的版本控制功能。 原始檔控制外掛程式會實作原始檔控制功能。
原始檔控制外掛程式資源
原始檔控制外掛程式會提供資源,以協助建立您的版本設定應用程式,並將其連線至 Visual Studio IDE。 原始檔控制外掛程式包含 API 規格,此規格必須由原始檔控制外掛程式實作,才能整合至 Visual Studio IDE。 原始檔控制外掛程式也包含程式碼範例 (以 C++ 撰寫) 以實作基本架構原始檔控制外掛程式,展示實作與原始檔控制外掛程式 API 相容的基本函式實作。
如果您建立一個原始檔控制 DLL,其中包含根據原始檔控制外掛程式 API 實作所需的函式集,原始檔控制外掛程式 API 規格可讓您利用選擇的任何原始檔控制系統。
元件
圖表中的原始檔控制配接器套件是 IDE 的元件,會將使用者對原始檔控制作業的要求轉譯為原始檔控制外掛程式支援的函數呼叫。 若要讓這種情況發生,IDE 和原始檔控制外掛程式必須具備有效的對話方塊,以在 IDE 與外掛程式之間來回傳遞資訊。 若要進行此對話,兩者必須使用相同的語言。 本文件中概述的原始檔控制外掛程式 API 是此交換的共通詞彙。
展示 VS 與原始檔控制外掛模組之間互動的結構圖表
如架構圖所示,標示為圖中 VS 殼層的 Visual Studio 殼層,會裝載使用者的工作專案和相關聯的元件,例如編輯器和方案總管。 原始檔控制配接器套件會處理 IDE 與原始檔控制外掛程式之間的互動。 原始檔控制配接器套件會提供自己的原始檔控制 UI。 這是使用者為了起始及定義原始檔控制作業範圍而與其互動的最上層 UI。
原始檔控制外掛程式可以有自己的 UI,其中可能包含兩個部分,如下圖所示。 標示「廠商 UI」的方塊,代表做為原始檔控制外掛程式建立者的自訂使用者介面元素。 當使用者叫用進階原始檔控制作業時,原始檔控制外掛程式會直接顯示這些項目。 標示「協助程式 UI」方塊是一組可透過 IDE 間接叫用之原始檔控制外掛程式 UI 功能。 原始檔控制外掛程式會透過 IDE 所提供的特殊回呼函式,將與 UI 相關的訊息傳遞至 IDE。 協助程式 UI 輔助與 IDE 更順暢整合 (通常是透過使用進階按鈕),進而提供更統一的終端使用者體驗。
原始檔控制外掛程式無法變更 Visual Studio 殼層,因此無法變更原始檔控制配接器套件,或 IDE 所提供的原始檔控制 UI。 該程式必須充分利用透過實作各種原始檔控制外掛程式 API 函式所提供的彈性,為終端使用者提供整合式體驗。 原始檔控制外掛程式 API 文件的參考區段包含一些進階原始檔控制外掛程式功能的資訊。 若要善加運用這些功能,原始檔控制外掛程式必須在初始化期間將其進階功能宣告至 IDE,並且必須針對每個功能實作特定的進階函式。