Пошаговое руководство. Создание пакета SDK с помощью C# или Visual Basic

В этом пошаговом руководстве вы узнаете, как создать простой пакет SDK для библиотеки математики с помощью Visual C# и упаковать пакет SDK в виде расширения Visual Studio (VSIX). Выполните следующие процедуры:

• Создание компонента SimpleMath среда выполнения Windows

• Создание проекта расширения SimpleMathVSIX

• Создание примера приложения, использующего библиотеку классов

Необходимые компоненты

Для выполнения этого пошагового руководства необходимо установить пакет SDK для Visual Studio. См. дополнительные сведения о пакете SDK для Visual Studio.

Создание компонента SimpleMath среда выполнения Windows

1. В строке меню выберите Файл >Создать >Проект.

2. В списке шаблонов разверните Visual C# или Visual Basic, выберите узел Магазина Windows, а затем выберите шаблон компонента среда выполнения Windows.

3. В поле "Имя" укажите SimpleMath и нажмите кнопку "ОК".

4. В Обозреватель решений откройте контекстное меню узла проекта SimpleMath и выберите "Свойства".

5. Переименуйте Class1.cs, чтобы Arithmetic.cs и обновите его, чтобы он соответствовал следующему коду:

   C#

   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);
           }
       }
   }
   

   VB

   Public NotInheritable Class Arithmetic
       Public Function Add(ByVal firstNumber As Single, ByVal secondNumber As Single) As Single
           Return (firstNumber + secondNumber)
       End Function
   
       Public Function Subtract(ByVal firstNumber As Single, ByVal secondNumber As Single) As Single
           Return (firstNumber - secondNumber)
       End Function
   
       Public Function Multiply(ByVal firstNumber As Single, ByVal secondNumber As Single) As Single
           Return (firstNumber * secondNumber)
       End Function
   
       Public Function Divide(ByVal firstNumber As Single, ByVal secondNumber As Single) As Single
           Return (firstNumber / secondNumber)
       End Function
   End Class
   

6. В Обозреватель решений откройте контекстное меню узла Решения SimpleMath и выберите Configuration Manager.

   Откроется диалоговое окно Configuration Manager .

7. В списке конфигурации активного решения выберите "Выпуск".

8. В столбце конфигурации убедитесь, что для строки SimpleMath задано значение Release, а затем нажмите кнопку "Закрыть ", чтобы принять это изменение.

   Внимание

   Пакет SDK для компонента SimpleMath включает только одну конфигурацию. Эта конфигурация должна быть сборкой выпуска или приложениями, которые используют компонент, не будут проходить сертификацию для Microsoft Store.

9. В Обозреватель решений откройте контекстное меню узла проекта SimpleMath и выберите "Сборка".

Создание проекта расширения SimpleMathVSIX

1. В контекстном меню узла Решения SimpleMath нажмите кнопку "Добавить>новый проект".

2. В списке шаблонов разверните Visual C# или Visual Basic, выберите узел расширяемости и выберите шаблон проекта VSIX.

3. В поле "Имя" укажите SimpleMathVSIX и нажмите кнопку "ОК".

4. В Обозреватель решений выберите элемент source.extension.vsixmanifest.

5. В строке меню выберите Вид>Код.

6. Замените существующий XML следующим XML-кодом:

   <PackageManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011" xmlns:d="http://schemas.microsoft.com/developer/vsx-schema-design/2011">
     <Metadata>
       <Identity Id="SimpleMath" Version="1.0" Language="en-US" Publisher="[YourName]" />
       <DisplayName>SimpleMath Library</DisplayName>
       <Description xml:space="preserve">Basic arithmetic operations in a WinRT-compatible library. Implemented in C#.</Description>
     </Metadata>
     <Installation Scope="Global" AllUsers="true">
       <InstallationTarget Id="Microsoft.ExtensionSDK" TargetPlatformIdentifier="Windows" TargetPlatformVersion="v8.0" SdkName="SimpleMath" SdkVersion="1.0" />
     </Installation>
     <Prerequisites>
       <Prerequisite Id="Microsoft.VisualStudio.Component.CoreEditor" Version="[14.0,16.0]" />
     </Prerequisites>
     <Dependencies>
       <Dependency Id="Microsoft.Framework.NDP" DisplayName="Microsoft .NET Framework" d:Source="Manual" Version="4.5" />
     </Dependencies>
     <Assets>
       <Asset Type="Microsoft.ExtensionSDK" d:Source="File" Path="SDKManifest.xml" />
     </Assets>
   </PackageManifest>
   

7. В Обозреватель решений выберите проект SimpleMathVSIX.

8. В строке меню выберите Проект>Добавить новый элемент.

9. В списке распространенных элементов разверните узел "Данные" и выберите XML-файл.

10. В поле "Имя" укажите SDKManifest.xmlи нажмите кнопку "Добавить".

11. В Обозреватель решений откройте контекстное меню SDKManifest.xml, выберите "Свойства", а затем измените значение include в свойстве VSIX на True.

12. Замените содержимое файла следующим XML-кодом.

    C#

    <FileList
      DisplayName="WinRT Math Library (CS)"
      MinVSVersion="11.0"
      TargetFramework=".NETCore,version=v4.5"
      AppliesTo="WindowsAppContainer"
      SupportsMultipleVersions="Error"
      MoreInfo="https://msdn.microsoft.com/">
    </FileList>
    

    Visual Basic

    <FileList
      DisplayName="WinRT Math Library (VB)"
      MinVSVersion="11.0"
      TargetFramework=".NETCore,version=v4.5"
      AppliesTo="WindowsAppContainer"
      SupportsMultipleVersions="Error"
      MoreInfo="https://msdn.microsoft.com/">
    </FileList>
    

13. В Обозреватель решений откройте контекстное меню проекта SimpleMathVSIX, нажмите кнопку "Добавить", а затем выберите "Создать папку".

14. Переименуйте папку в references.

15. Откройте контекстное меню папки "Ссылки" , нажмите кнопку "Добавить" и выберите " Создать папку".

16. Переименуйте вложенную папку, создайте в ней вложенную папку commonconfigurationи назовите вложенную папку neutral.

17. Повторите предыдущие четыре шага, на этот раз переименовав первую папку redistв .

    Теперь проект содержит следующую структуру папок:

    references\commonconfiguration\neutral
    redist\commonconfiguration\neutral
    

18. В Обозреватель решений откройте контекстное меню проекта SimpleMath и выберите команду "Открыть папку" в проводник.

19. В проводник перейдите в папку bin\Release, откройте контекстное меню файла SimpleMath.winmd и нажмите кнопку "Копировать".

20. В Обозреватель решений вставьте файл в папку references\commonconfiguration\neutral в проекте SimpleMathVSIX.

21. Повторите предыдущий шаг, вставив файл SimpleMath.pri в папку redist\commonconfiguration\neutral в проекте SimpleMathVSIX .

22. В Обозреватель решений выберите SimpleMath.winmd.

23. В строке меню выберите "Просмотреть>свойства " (клавиатура: выберите клавишу F4 ).

24. В окне свойств измените свойство действия сборки на Content, а затем измените свойство Include в свойстве 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. В области сведений выберите расширение библиотеки математики WinRT.

   Появится дополнительная информация о пакете SDK. Вы можете выбрать ссылку "Дополнительные сведения" , чтобы открыть https://msdn.microsoft.com/ее, как указано в файле SDKManifest.xml ранее в этом пошаговом руководстве.

7. В диалоговом окне "Диспетчер ссылок" выберите проверка библиотеку математики WinRT, а затем нажмите кнопку "ОК".

8. В строке меню выберите просмотр>браузера объектов.

9. В списке "Обзор" выберите "Простая математика".

   Теперь вы можете изучить, что есть в пакете SDK.

10. В Обозреватель решений откройте MainPage.xaml и замените его содержимое следующим кодом XAML:

    C#

    <Page
        x:Class="ArithmeticUI.MainPage"
        IsTabStop="False"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="using:SimpleMath"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d">
    
        <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
            <TextBox x:Name="_firstNumber" HorizontalAlignment="Left" Margin="414,370,0,0" TextWrapping="Wrap" Text="First Number" VerticalAlignment="Top" Height="32" Width="135" TextAlignment="Center"/>
            <TextBox x:Name="_secondNumber" HorizontalAlignment="Left" Margin="613,370,0,0" TextWrapping="Wrap" Text="Second Number" VerticalAlignment="Top" Height="32" Width="135" TextAlignment="Center"/>
            <Button Content="+" HorizontalAlignment="Left" Margin="557,301,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="-" HorizontalAlignment="Left" Margin="557,345,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="*" HorizontalAlignment="Left" Margin="557,389,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="/" HorizontalAlignment="Left" Margin="557,433,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="=" HorizontalAlignment="Left" Margin="755,367,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnResultsClick"/>
            <TextBox x:Name="_result" HorizontalAlignment="Left" Margin="809,370,0,0" TextWrapping="Wrap" Text="Result" VerticalAlignment="Top" Height="32" Width="163" TextAlignment="Center" IsReadOnly="True"/>
        </Grid>
    </Page>
    

    Visual Basic

    <Page
        x:Class="ArithmeticUI.MainPage"
        IsTabStop="False"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="using:SimpleMath"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d">
    
        <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
            <TextBox x:Name="_firstNumber" HorizontalAlignment="Left" Margin="414,370,0,0" TextWrapping="Wrap" Text="First Number" VerticalAlignment="Top" Height="32" Width="135" TextAlignment="Center"/>
            <TextBox x:Name="_secondNumber" HorizontalAlignment="Left" Margin="613,370,0,0" TextWrapping="Wrap" Text="Second Number" VerticalAlignment="Top" Height="32" Width="135" TextAlignment="Center"/>
            <Button Content="+" HorizontalAlignment="Left" Margin="557,301,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="-" HorizontalAlignment="Left" Margin="557,345,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="*" HorizontalAlignment="Left" Margin="557,389,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="/" HorizontalAlignment="Left" Margin="557,433,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnOperatorClick"/>
            <Button Content="=" HorizontalAlignment="Left" Margin="755,367,0,0" VerticalAlignment="Top" Height="39" Width="49" Click="OnResultsClick"/>
            <TextBox x:Name="_result" HorizontalAlignment="Left" Margin="809,370,0,0" TextWrapping="Wrap" Text="Result" VerticalAlignment="Top" Height="32" Width="163" TextAlignment="Center" IsReadOnly="True"/>
        </Grid>
    </Page>
    

11. Обновите MainPage.xaml.cs , чтобы соответствовать следующему коду:

C#

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 ArithmeticUI
{
    /// <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);

                SimpleMath.Arithmetic math = new SimpleMath.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 #";
            }
        }
    }
}

VB

' The Blank Page item template is documented at http://go.microsoft.com/fwlink/?LinkId=234238

''' <summary>
''' An empty page that can be used on its own or navigated to within a Frame.
''' </summary>
Public NotInheritable Class MainPage
    Inherits Page

    ''' <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 Overrides Sub OnNavigatedTo(e As Navigation.NavigationEventArgs)
    
    End Sub

    Public Shared operation As String = Nothing

    ''' <summary>
    ''' Sets the operator chosen by the user
    ''' </summary>
    ''' <param name="sender"></param>
    ''' <param name="e"></param>
    Private Sub OnOperatorClick(ByVal sender As Object, ByVal e As RoutedEventArgs)
        operation = If(TypeOf sender Is Button, CType(sender, Button), Nothing).Content.ToString()
    End Sub

    ''' <summary>
    ''' Calls the SimpleMath SDK to do simple arithmetic
    ''' </summary>
    ''' <param name="sender"></param>
    ''' <param name="e"></param>
    Private Sub OnResultsClick(ByVal sender As Object, ByVal e As RoutedEventArgs)

        Try

            Dim firstNumber As Single = Single.Parse(Me._firstNumber.Text)
            Dim secondNumber As Single = Single.Parse(Me._secondNumber.Text)

            Dim math As New SimpleMath.Arithmetic()

            Select Case (operation)

                Case "+"
                    Me._result.Text = (math.Add(firstNumber, secondNumber)).ToString()

                Case "-"
                    Me._result.Text = (math.Subtract(firstNumber, secondNumber)).ToString()
                Case "*"
                    Me._result.Text = (math.Multiply(firstNumber, secondNumber)).ToString()
                Case "/"
                    Me._result.Text = (math.Divide(firstNumber, secondNumber)).ToString()
                Case Else
                    Me._result.Text = "Choose operator"

            End Select

        Catch
            Me._result.Text = "Enter valid #"
        End Try
    End Sub
End Class

12. Выберите клавишу F5 для запуска приложения.

13. В приложении введите два числа, выберите операцию и нажмите кнопку = .

    Отображается правильный результат.

    Вы успешно создали и использовали пакет SDK расширения.

Связанный контент

• Пошаговое руководство. Создание пакета SDK с помощью C++
• Пошаговое руководство. Создание пакета SDK с помощью JavaScript
• Создание пакета средств разработки программного обеспечения