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

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

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

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

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

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

  2. В списке шаблонов разверните visual C++>Windows Universal, а затем выберите шаблон DLL (универсальные приложения Windows). В поле "Имя" укажите NativeMathи нажмите кнопку "ОК".

  3. Обновите NativeMath.h , чтобы соответствовать следующему коду.

    #pragma once
    
    class __declspec(dllexport) BasicMath 
    {
    public:
        BasicMath();
        double add(double firstNumber, double secondNumber);
        double subtract(double firstNumber, double secondNumber);
    };
    
  4. Обновите NativeMath.cpp , чтобы соответствовать этому коду:

    // NativeMath.cpp : Defines the exported functions for the DLL application.
    //
    
    #include "pch.h"
    #include "NativeMath.h"
    
    
    BasicMath::BasicMath()
    {
    }
    
    double BasicMath::add(double firstNumber, double secondNumber)
    {
        return firstNumber + secondNumber;
    }
    
    double BasicMath::subtract(double firstNumber, double secondNumber)
    {
        return firstNumber - secondNumber;
    }
    
  5. В Обозреватель решений откройте контекстное меню решения NativeMath и нажмите кнопку "Добавить>новый проект".

  6. В списке шаблонов разверните Visual C++, а затем выберите шаблон компонента среда выполнения Windows. В поле "Имя" укажите NativeMathWRTи нажмите кнопку "ОК".

  7. Обновите класс1.h , чтобы соответствовать этому коду:

    #pragma once
    
    namespace NativeMathWRT
    {
        public ref class BasicMathWinMD sealed
        {
        public:
            BasicMathWinMD(){};
            double multiply(double firstNumber, double secondNumber);
            double divide(double firstNumber, double secondNumber);
        };
    }
    
  8. Обновите класс1.cpp , чтобы соответствовать этому коду:

    // Class1.cpp
    #include "pch.h"
    #include "Class1.h"
    
    using namespace NativeMathWRT;
    using namespace Platform;
        
    double BasicMathWinMD::multiply(double firstNumber, double secondNumber)
    {
        return firstNumber * secondNumber;
    }
    
    double BasicMathWinMD::divide(double firstNumber, double secondNumber)
    {
        if(0 == secondNumber) 
            return -1;
    
        return firstNumber / secondNumber;
    }
    
  9. В строке меню последовательно выберите Сборка>Собрать решение.

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

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

  2. В списке шаблонов разверните узел Visual C#>Расширяемость и выберите проект VSIX. В поле "Имя" укажите NativeMathVSIX и нажмите кнопку "ОК".

  3. В Обозреватель решений откройте контекстное меню для source.extension.vsixmanifest и выберите команду View Code.

  4. Используйте следующий 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="NativeMathVSIX..c6b3cae1-e7e2-4e71-90f6-21017ea0dff7" Version="1.0" Language="en-US" Publisher="MyName" />
        <DisplayName>Native Math SDK</DisplayName>
        <Description>Native Math Library w/ Windows Runtime Additions</Description>
      </Metadata>
      <Installation Scope="Global" AllUsers="true">
        <InstallationTarget Id="Microsoft.ExtensionSDK" TargetPlatformIdentifier="Windows" TargetPlatformVersion="v8.0" SdkName="NativeMathSDK" SdkVersion="1.0" />
      </Installation>
      <Dependencies>
      </Dependencies>
      <Assets>
        <Asset Type="Microsoft.ExtensionSDK" d:Source="File" Path="SDKManifest.xml" />
      </Assets>
    </PackageManifest>
    
  5. В Обозреватель решений откройте контекстное меню проекта NativeMathVSIX и нажмите кнопку "Добавить>новый элемент".

  6. В списке элементов Visual C# разверните узел "Данные" и выберите XML-файл. В поле "Имя" укажите SDKManifest.xmlи нажмите кнопку "ОК".

  7. Используйте этот XML-код для замены содержимого файла:

    <FileList
      Identity = "NativeMathSDK, Version=1.0"
      DisplayName = "Native Math SDK"
      MinVSVersion = "11.0"
      AppliesTo = "WindowsAppContainer + (CSharp | VB | VisualC)">
      <File Reference="NativeMathWRT.winmd" Implementation="NativeMathWRT.dll" />
    </FileList>
    
  8. В Обозреватель решений в проекте NativeMathVSIX создайте эту структуру папок:

    \DesignTime
          \CommonConfiguration
                \Neutral
                      \Include
          \Debug
                \x86
    \Redist
          \Debug
                \x86
    \References
          \CommonConfiguration
                \Neutral
    
  9. В Обозреватель решений откройте контекстное меню решения NativeMath и выберите команду "Открыть папку" в проводник.

  10. В проводник скопируйте $SolutionRoot$\NativeMath\NativeMath.h, а затем в Обозреватель решений в проекте NativeMathVSIX вставьте его в папку $SolutionRoot$\NativeMathVSIX\DesignTime\CommonConfiguration\Neutral\Include\.

    Скопируйте $SolutionRoot$\Debug\NativeMath\NativeMath.lib, а затем вставьте его в папку $SolutionRoot$\NativeMathVSIX\DesignTime\Debug\x86\ .

    Скопируйте $SolutionRoot$\Debug\NativeMath\NativeMath.dll и вставьте его в папку $SolutionRoot$\NativeMathVSIX\Redist\Debug\x86\ .

    Скопируйте $SolutionRoot$\Debug\NativeMathWRT\NativeMathWRT.dll и вставьте его в папку $SolutionRoot$\NativeMathVSIX\Redist\Debug\x86 . Скопируйте $SolutionRoot$\Debug\NativeMathWRT\NativeMathWRT.winmd и вставьте его в папку $SolutionRoot$\NativeMathVSIX\References\CommonConfiguration\Neutral .

    Скопируйте $SolutionRoot$\Debug\NativeMathWRT\NativeMathWRT.pri и вставьте его в папку $SolutionRoot$\NativeMathVSIX\References\CommonConfiguration\Neutral .

  11. В папке $SolutionRoot$\NativeMathVSIX\DesignTime\Debug\x86\ создайте текстовый файл с именем NativeMathSDK.props, а затем вставьте в него следующее содержимое:

    <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
      <PropertyGroup>
        <NativeMathSDKPath>$(FrameworkSDKRoot)\..\..\UAP\v0.8.0.0\ExtensionSDKs\NativeMathSDK\1.0\</NativeMathSDKPath>
        <IncludePath>$(NativeMathSDKPath)DesignTime\CommonConfiguration\Neutral\Include;$(IncludePath)</IncludePath>
        <LibraryPath>$(NativeMathSDKPath)DesignTime\Debug\x86;$(LibraryPath)</LibraryPath>
      </PropertyGroup>
      <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
         <Link>
           <AdditionalDependencies>NativeMath.lib;%(AdditionalDependencies)</AdditionalDependencies>
         </Link>
      </ItemDefinitionGroup>
    </Project>
    
  12. В строке меню выберите "Просмотреть>другие свойства Windows">(клавиатура: выберите клавишу F4).

  13. В Обозреватель решений выберите файл NativeMathWRT.winmd. В окне свойств измените свойство действия сборки на Content, а затем измените свойство Include в свойстве VSIX на True.

    Повторите этот процесс для файла NativeMath.h .

    Повторите этот процесс для файла NativeMathWRT.pri .

    Повторите этот процесс для файла NativeMath.Lib .

    Повторите этот процесс для файла NativeMathSDK.props .

  14. В Обозреватель решений выберите файл NativeMath.h. В окне свойств измените значение Include в свойстве VSIX на True.

    Повторите этот процесс для файла NativeMath.dll .

    Повторите этот процесс для файла NativeMathWRT.dll .

    Повторите этот процесс для файла SDKManifest.xml .

  15. В строке меню последовательно выберите Сборка>Собрать решение.

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

  17. В проводник перейдите к папке $SolutionRoot$\NativeMathVSIX\bin\Debug, а затем запустите NativeMathVSIX.vsix, чтобы начать установку.

  18. Нажмите кнопку "Установить ", дождитесь завершения установки и откройте Visual Studio.

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

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

  2. В списке шаблонов разверните visual C++>Windows Universal и выберите пустое приложение. В поле "Имя" укажите NativeMathSDKSample и нажмите кнопку "ОК".

  3. В Обозреватель решений откройте контекстное меню проекта NativeMathSDKSample и нажмите кнопку "Добавить>ссылку".

  4. В диалоговом окне "Добавить ссылку" в списке ссылочных типов разверните универсальные окна и выберите "Расширения". Наконец, выберите проверка пакета SDK для машинного математики и нажмите кнопку "ОК".

  5. Отображение свойств проекта для NativeMathSDKSample.

    Свойства, определенные в NativeMathSDK.props , применяются при добавлении ссылки. Вы можете проверить, примененные свойства, проверив свойство каталогов VC++ свойств конфигурации проекта.

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

    <Page
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="using:NativeMathSDKSample"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        x:Class="NativeMathSDKSample.MainPage"
        IsTabStop="false"
        mc:Ignorable="d">
    
        <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
            <TextBox x:Name="FirstNumber" HorizontalAlignment="Left" Margin="327,123,0,0" TextWrapping="Wrap" Text="1" VerticalAlignment="Top" Height="84" Width="259" FontSize="48"/>
            <TextBox x:Name="SecondNumber" HorizontalAlignment="Left" Margin="687,123,0,0" TextWrapping="Wrap" Text="1" VerticalAlignment="Top" Height="84" Width="271" FontSize="48"/>
            <Button x:Name="Execute" Content="=" HorizontalAlignment="Left" Margin="478,387,0,0" VerticalAlignment="Top" Height="63" Width="332" Click="Execute_Click"/>
            <RadioButton Name="add" Content="Add" HorizontalAlignment="Left" Margin="273,262,0,0" VerticalAlignment="Top" GroupName="Operation" IsChecked="True"/>
            <RadioButton Name="subtract" Content="Subtract" HorizontalAlignment="Left" Margin="453,262,0,0" VerticalAlignment="Top" GroupName="Operation" IsChecked="False"/>
            <RadioButton Name="multiplyWRT" Content="Multiply(WRT)" HorizontalAlignment="Left" Margin="615,262,0,0" VerticalAlignment="Top" GroupName="Operation" IsChecked="False"/>
            <RadioButton Name="divideWRT" Content="Divide(WRT)" HorizontalAlignment="Left" Margin="891,262,0,0" VerticalAlignment="Top" GroupName="Operation" IsChecked="False"/>
            <TextBlock Name="resultText" HorizontalAlignment="Left" Margin="478,525,0,0" TextWrapping="Wrap" Text="TextBlock" VerticalAlignment="Top" Width="332" Height="70" FontSize="48"/>
        </Grid>
    </Page>
    
  7. Обновите Mainpage.xaml.h , чтобы соответствовать этому коду:

    //
    // MainPage.xaml.h
    // Declaration of the MainPage class.
    //
    
    #pragma once
    
    #include "MainPage.g.h"
    
    namespace NativeMathSDKSample
    {
        /// <summary>
        /// An empty page that can be used on its own or navigated to within a Frame.
        /// </summary>
        public ref class MainPage sealed
        {
        public:
            MainPage();
    
        protected:
            virtual void OnNavigatedTo(Windows::UI::Xaml::Navigation::NavigationEventArgs^ e) override;
            virtual void Execute_Click(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e);
        };
    }
    
  8. Обновите MainPage.xaml.cpp , чтобы соответствовать этому коду:

    //
    // MainPage.xaml.cpp
    // Implementation of the MainPage class.
    //
    
    #include "pch.h"
    #include "MainPage.xaml.h"
    
    #include <sstream>
    
    #include "NativeMath.h"
    
    using namespace NativeMathSDKSample;
    
    using namespace Platform;
    using namespace Windows::Foundation;
    using namespace Windows::Foundation::Collections;
    using namespace Windows::UI::Xaml;
    using namespace Windows::UI::Xaml::Controls;
    using namespace Windows::UI::Xaml::Controls::Primitives;
    using namespace Windows::UI::Xaml::Data;
    using namespace Windows::UI::Xaml::Input;
    using namespace Windows::UI::Xaml::Media;
    using namespace Windows::UI::Xaml::Navigation;
    
    using namespace NativeMathWRT;
    
    // The Blank Page item template is documented at http://go.microsoft.com/fwlink/?LinkId=234238
    
    MainPage::MainPage()
    {
        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>
    void MainPage::OnNavigatedTo(NavigationEventArgs^ e)
    {
    }
    
    void NativeMathSDKSample::MainPage::Execute_Click(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
    {
        double iFirstNumber = _wtof(FirstNumber->Text->Data());
        double iSecondNumber = _wtof(SecondNumber->Text->Data());
        double result = 0;
    
        BasicMathWinMD^ basicMathWinMD = ref new BasicMathWinMD();
        BasicMath basicMath;
    
        if(add->IsChecked->Value == true)
        {
            result = basicMath.add(iFirstNumber, iSecondNumber);
        }
        else if(subtract->IsChecked->Value == true)
        {
            result = basicMath.subtract(iFirstNumber, iSecondNumber);
        }
        else if(multiplyWRT->IsChecked->Value == true)
        {
            result = basicMathWinMD->multiply(iFirstNumber, iSecondNumber);
        }
        else if (divideWRT->IsChecked->Value == true)
        {
            result = basicMathWinMD->divide(iFirstNumber, iSecondNumber);
        }
    
        std::wstringstream s;
        s << result;
    
        resultText->Text = ref new String(s.str().c_str());
    
    }
    
  9. Выберите клавишу F5 для запуска приложения.

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

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

    В этом пошаговом руководстве показано, как создать и использовать пакет SDK расширения для вызова библиотеки среда выполнения Windows и библиотеки, отличной от среда выполнения Windows.