逐步解說:使用 C# 建立 SDK
在這個逐步解說中,您將學習如何建立簡單數學程式庫 SDK 使用 Visual C# 然後包裝 SDK 做為 Visual Studio Extension (VSIX) 中。 您將完成下列程序:
必要條件
您必須具有 Visual Studio 2012 和在您的電腦上安裝 Visual Studio 2012 SDK 。 您可以從 Visual Studio 下載 頁面的 SDK。
建立 SimpleMath Windows 執行階段元件
在功能表列上,選擇 [檔案]],則 [新增], [新的專案]。
在範本清單中,展開 [Visual C#] 或 [Visual Basic]],選取 [Windows 市集] 節點,然後選取 [Windows 執行階段元件] 範本。
在 [名稱] 方塊中,指定 SimpleMath,然後選擇 [OK] 按鈕。
在 [方案總管] 中,開啟 [SimpleMath] 節點的捷徑功能表,然後選擇 [屬性]。
將 [Class1.cs] 重新命名為 Arithmetic.cs 並更新為符合下列程式碼:
在 [方案總管] 中,開啟 [方案「SimpleMath」] 節點的捷徑功能表,然後選擇 [組態管理員]。
[組態管理員] 對話方塊便會開啟。
在 [使用中方案組態] 清單中,選取 [版本]。
在 [組態] 欄位中,確認 [SimpleMath] 資料行設為 [版本]],然後選擇 [關閉] 按鈕以接受變更。
重要
SimpleMath 元件的 SDK 只包含一個組態。這個組態必須是發行的組建 (Release Build),或是使用元件的應用程式不會透過Windows 市集的認證。
在 [方案總管] 中,開啟 [SimpleMath] 節點的捷徑功能表,然後選擇 [組建]。
建立 SimpleMathVSIX 擴充功能專案
在 [方案「SimpleMath」] 節點的捷徑功能表上,選擇 [加入]],則 [新的專案]。
在範本清單中,展開 [Visual C#] 或 [Visual Basic]],選取 [擴充性] 節點,然後選取 [VSIX 專案] 範本。
在 [名稱] 方塊中,指定 SimpleMathVSIX,然後選擇 [OK] 按鈕。
在 [方案總管] 中,選取 [source.extension.vsixmanifest] 項目。
在功能表列上,選擇 [檢視]],則 [程式碼]。
以下列 XML 取代現有的 XML:
在 [方案總管] 中,選取 [SimpleMathVSIX] 專案。
在功能表列上,選擇 [專案]],則 [加入新項目。]。
在 [一般項目] 清單中,展開 [資料],然後選取 [XML 檔案]。
在 [名稱] 方塊中,指定 SDKManifest.xml,然後選擇 [加入] 按鈕。
在 [方案總管] 中,開啟 SDKManifest.xml的捷徑功能表,選擇 [屬性]],然後變更 [在 VSIX 中包含] 屬性的值變更為 [true]。
以下列 XML 取代檔案的內容:
在 [方案總管] 中,開啟 [SimpleMathVSIX] 專案的捷徑功能表,選擇 [加入]],然後選取 [新的資料夾]。
將這個資料夾重新命名為 參考。
開啟 [參考] 資料夾的捷徑功能表,選擇 [加入]],然後選取 [新的資料夾]。
將這個的子資料夾重新命名為 commonconfiguration,建立子資料夾中,而且命名這個子資料夾命名為 中性。
重複前四個步驟,將第一個資料夾重新命名的動作設定為 可轉散發。
專案現在包含下列資料夾結構:
references\commonconfiguration\neutral redist\commonconfiguration\neutral
在 [方案總管] 中,開啟 [SimpleMath] 專案的捷徑功能表,然後選擇 [開啟檔案總管的資料夾]。
在 [檔案總管] 中,對 Bin \ Release 資料夾中,巡覽 SimpleMath.winmd 開啟檔案的捷徑功能表,然後選擇 [複製]。
在 [方案總管] 中,貼上檔案 references\commonconfiguration\neutral 資料夾在 [SimpleMathVSIX] 專案。
重複上述步驟,貼上 SimpleMath.pri 檔案放入 redist \ commonconfiguration 中性\資料夾中的 [SimpleMathVSIX] 專案。
在 [方案總管] 中,選取 [SimpleMath.winmd]。
在功能表列上,選擇 [檢視], [屬性] (鍵盤:選取 F4 鍵)。
在 [屬性] 視窗中,將 [建置動作。] 屬性變更為 [內容]],然後將 [在 VSIX 中包含] 屬性變更為 [true]。
在 [方案總管] 中,複製 [SimpleMath.pri] 重複這個程序。
在 [方案總管] 中,選取 [SimpleMathVSIX] 專案。
在功能表列上,選擇 [組建]],則 [組建 SimpleMathVSIX]。
在 [方案總管] 中,開啟 [SimpleMathVSIX] 專案的捷徑功能表,然後選擇 [開啟檔案總管的資料夾]。
在 [檔案總管] 中,巡覽至\ bin \ Release 資料夾安裝並執行的 SimpleMathVSIX.vsix。
選擇 [安裝] 按鈕,等待安裝完成,然後重新啟動 Visual Studio。
若要使用類別庫的範例應用程式
在功能表列上,選擇 [檔案]],則 [新增], [新的專案]。
在範本清單中,展開 [Visual C#] 或 [Visual Basic]],然後選取 [Windows 市集] 節點。
選取 [保持空白應用程式] 範本,將專案命名 ArithmeticUI,然後選擇 [OK] 按鈕。
在 [方案總管] 中,開啟 [ArithmeticUI] 專案的捷徑功能表,然後選擇 [加入參考]。
在參考型別清單中,展開 [視窗],然後選取 [擴充功能]。
在詳細資料窗格中,選取 [簡單算術 SDK] 擴充功能。
如需您的 SDK 的其他資訊隨即出現。 您可以選擇 [詳細資訊] 連結以開啟 http://www.msdn.microsoft.com,,如同您在 SDKManifest.xml 檔案指定稍早在本逐步解說。
在 [參考管理員] 對話方塊中,選取 [簡單算術 SDK] 核取方塊,然後選擇 [OK] 按鈕。
在功能表列上,選擇 [檢視]],則 [物件瀏覽器]。
在 [瀏覽] 清單中,選取 [簡單算術]。
您現在可以探索以及 SDK。
在 [方案總管] 中,開啟 MainPage.xaml,並取代其與下列 XAML 內容:
符合下列程式碼中更新 MainPage.xaml.cs:
選擇 F5 鍵執行應用程式。
在應用程式中,輸入任何兩個數字,選取作業,然後選擇 [=] 按鈕。
正確結果隨即出現。
您已成功建立並使用了擴充功能 SDK。