建議使用 Visual Studio 2017

逐步解說: 建立使用 C# 或 Visual Basic 的 SDK

 

發行︰ 2016年7月

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

在此逐步解說中,您將學習如何使用 Visual C# 中建立簡單的數學程式庫 SDK,然後再封裝 SDK 為 Visual Studio 擴充功能 (VSIX)。 您將完成下列程序︰

若要依照本逐步解說執行作業,您必須安裝 Visual Studio SDK。 如需詳細資訊,請參閱Visual Studio SDK

  1. 在功能表列上選擇 [檔案新增新的專案

  2. 在範本清單中,展開Visual C#Visual Basic,選擇 [ Windows 市集節點,然後選擇 [ Windows 執行階段元件範本。

  3. 名稱方塊中,指定SimpleMath,然後選擇 [確定] 按鈕。

  4. 方案總管] 中,開啟捷徑功能表SimpleMath專案節點,然後按一下屬性

  5. 重新命名Class1.csArithmetic.cs並進行更新以符合下列程式碼︰

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using System.Threading.Tasks;
    
    namespace WinRTMath
    {
        public sealed class Arithmetic
        {
            public float add(float firstNumber, float secondNumber)
            {
                return (firstNumber + secondNumber);
            }
    
            public float subtract(float firstNumber, float secondNumber)
            {
                return (firstNumber - secondNumber);
            }
    
            public float multiply(float firstNumber, float secondNumber)
            {
                return (firstNumber * secondNumber);
            }
    
            public float divide(float firstNumber, float secondNumber)
            {
                return (firstNumber / secondNumber);
            }
        }
    }
    

  6. 方案總管] 中,開啟捷徑功能表方案 'SimpleMath'節點,然後選擇 [ Configuration Manager

    Configuration Manager對話方塊隨即開啟。

  7. 作用中方案組態清單中,選擇版本

  8. 組態資料行中,確認SimpleMath資料列設為版本,然後選擇 [關閉] 按鈕以接受變更。

    System_CAPS_ICON_important.jpg 重要

    SimpleMath 元件 SDK 包含只有一個組態。 此設定必須是發行的組建,或使用元件的應用程式將不會通過憑證Windows 市集。

  9. 方案總管] 中,開啟捷徑功能表SimpleMath專案節點,然後按一下建置

  1. 在捷徑功能表上方案 'SimpleMath'節點,選擇新增新的專案

  2. 在範本清單中,展開Visual C#Visual Basic,選擇 [擴充性節點,然後選擇 [ VSIX 專案範本。

  3. 名稱方塊中,指定SimpleMathVSIX,然後選擇 [確定] 按鈕。

  4. 方案總管] 中,選擇 [ source.extension.vsixmanifest項目。

  5. 在功能表列上選擇 [檢視] 、[程式碼] 。

  6. 以下列 XML 取代現有的 XML:

  7. 方案總管] 中,選擇 [ SimpleMathVSIX專案。

  8. 在功能表列上選擇 [專案加入新項目

  9. 在清單中一般項目,依序展開資料,然後選擇 [ XML 檔案

  10. 名稱方塊中,指定SDKManifest.xml,然後選擇 [新增] 按鈕。

  11. 方案總管] 中,開啟捷徑功能表SDKManifest.xml,選擇屬性,然後將變更的值Include in VSIX屬性True

  12. 以下列 XML 取代檔案的內容:

  13. 方案總管] 中,開啟捷徑功能表SimpleMathVSIX專案中,選擇 [新增,然後選擇 [新資料夾

  14. 若要將資料夾重新命名references

  15. 開啟捷徑功能表參考資料夾中,選擇 [新增,然後選擇 [新資料夾

  16. 重新命名的子資料夾commonconfiguration,建立的子資料夾中,並將子資料夾neutral

  17. 重複上述四個步驟,重新命名的第一個資料夾,以這次redist

    專案現在會包含下列資料夾結構︰

    references\commonconfiguration\neutral  
    redist\commonconfiguration\neutral  
    
    
  18. 方案總管] 中,開啟捷徑功能表SimpleMath專案,然後再選擇在檔案總管] 中開啟資料夾

  19. 檔案總管、 瀏覽至 bin\debug 資料夾、 開啟 SimpleMath.winmd 檔案的捷徑功能表,然後選擇複製

  20. 方案總管] 中,將檔案貼到 references\commonconfiguration\neutral 資料夾SimpleMathVSIX專案。

  21. 重複上述步驟,將 SimpleMath.pri 檔案貼到 [redist\commonconfiguration\neutral] 資料夾中SimpleMathVSIX專案。

  22. 方案總管] 中,選擇 [ SimpleMath.winmd

  23. 在功能表列上選擇 [檢視屬性(鍵盤︰ 選擇 F4 鍵)。

  24. 屬性] 視窗中,變更建置動作屬性內容,然後變更Include in VSIX屬性True

  25. 方案總管] 中,重複此程序SimpleMath.pri

  26. 方案總管] 中,選擇 [ SimpleMathVSIX專案。

  27. 在功能表列上選擇 [建置建置 SimpleMathVSIX

  28. 方案總管] 中,開啟捷徑功能表SimpleMathVSIX專案,然後再選擇在檔案總管] 中開啟資料夾

  29. 檔案總管,瀏覽至 \bin\Release 資料夾,然後再執行 SimpleMathVSIX.vsix 安裝它。

  30. 選擇安裝] 按鈕,等候安裝完成,然後再重新啟動 Visual Studio。

  1. 在功能表列上選擇 [檔案新增新的專案

  2. 在範本清單中,展開Visual C#Visual Basic,然後選擇 [ Windows 市集節點。

  3. 選擇空白應用程式範本,將專案ArithmeticUI,然後選擇 [確定] 按鈕。

  4. 方案總管] 中,開啟捷徑功能表ArithmeticUI專案,然後再選擇新增參考

  5. 在參考型別清單中,展開Windows,然後選擇 [延伸

  6. 在詳細資料窗格中,選擇 [簡單數學 SDK延伸模組。

    您的 SDK 的其他資訊隨即顯示。 您可以選擇更多資訊開啟 http://www.msdn.microsoft.com,如您稍早在本逐步解說 SDKManifest.xml 檔案中所指定的連結。

  7. 參考管理員對話方塊中,選取簡單數學 SDK核取方塊,然後按一下確定] 按鈕。

  8. 在功能表列上選擇 [檢視物件瀏覽器

  9. 瀏覽清單中,選擇簡單的數學

    您現在可以瀏覽 SDK 的功能。

  10. 方案總管] 中,開啟 MainPage.xaml,並將其內容取代下列 XAML:

  11. 更新 MainPage.xaml.cs 以符合下列程式碼︰

    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using Windows.Foundation;
    using Windows.Foundation.Collections;
    using Windows.UI.Xaml;
    using Windows.UI.Xaml.Controls;
    using Windows.UI.Xaml.Controls.Primitives;
    using Windows.UI.Xaml.Data;
    using Windows.UI.Xaml.Input;
    using Windows.UI.Xaml.Media;
    using Windows.UI.Xaml.Navigation;
    
    // The Blank Page item template is documented at http://go.microsoft.com/fwlink/?LinkId=234238
    
    namespace WinRTMathTestCS
    {
        /// <summary>
        /// An empty page that can be used on its own or navigated to within a Frame.
        /// </summary>
        public sealed partial class MainPage : Page
        {
            public static string operation = null;
    
            public MainPage()
            {
                this.InitializeComponent();
            }
    
            /// <summary>
            /// Invoked when this page is about to be displayed in a Frame.
            /// </summary>
            /// <param name="e">Event data that describes how this page was reached.  The Parameter
            /// property is typically used to configure the page.</param>
            protected override void OnNavigatedTo(NavigationEventArgs e)
            {
            }
    
            /// <summary>
            /// Sets the operator chosen by the user
            /// </summary>
            /// <param name="sender"></param>
            /// <param name="e"></param>
            private void OnOperatorClick(object sender, RoutedEventArgs e)
            {
                operation = (sender as Button).Content.ToString();
            }
    
            /// <summary>
            /// Calls the SimpleMath SDK to do simple arithmetic
            /// </summary>
            /// <param name="sender"></param>
            /// <param name="e"></param>
            private void OnResultsClick(object sender, RoutedEventArgs e)
            {
                try
                {
                    float firstNumber = float.Parse(this._firstNumber.Text);
                    float secondNumber = float.Parse(this._secondNumber.Text);
    
                    WinRTMath.Arithmetic math = new WinRTMath.Arithmetic();
    
                    switch (operation)
                    {
                        case "+":
                            this._result.Text = (math.add(firstNumber, secondNumber)).ToString();
                            break;
                        case "-":
                            this._result.Text = (math.subtract(firstNumber, secondNumber)).ToString();
                            break;
                        case "*":
                            this._result.Text = (math.multiply(firstNumber, secondNumber)).ToString();
                            break;
                        case "/":
                            this._result.Text = (math.divide(firstNumber, secondNumber)).ToString();
                            break;
                        default:
                            this._result.Text = "Choose operator";
                            break;
                    }
                }
                catch
                {
                    this._result.Text = "Enter valid #";
                }
            }
        }
    }
    

  12. 選擇 F5 鍵以執行應用程式。

  13. 在應用程式中,輸入任何兩個數字,並選擇了作業,然後選擇** = ** ] 按鈕。

    正確的結果會出現。

您已成功建立和使用擴充功能 SDK。

逐步解說︰ 建立使用 c + + 的 SDK
逐步解說︰ 建立使用 JavaScript 的 SDK
建立軟體開發套件

顯示: