Создание компонентов пакета MSIX Generating MSIX package components

В этой статье показано, как создавать компоненты пакета MSIX для упаковки приложения с помощью программ командной строки (без использования Visual Studio или средства формирования пакетов MSIX). This article shows you how to generate MSIX package components for packaging your application using command line tools (without using Visual Studio or the MSIX Packaging Tool).

Чтобы упаковать приложение вручную, необходимо создать файл манифеста пакета, добавить компоненты пакета, а затем запустить программу командной строки MakeAppx.exe для создания пакета MSIX. To manually package your app, you need to create a package manifest file, add your package components and then run the MakeAppx.exe command line tool to generate an MSIX package.

Сначала подготовьте приложения к упаковке First, prepare to package

Если вы еще не сделали этого, ознакомьтесь со статьей What to know before packaging your desktop application (Что необходимо знать перед упаковкой классического приложения). If you haven’t yet, review this section on what you need to know before packaging your application.

Создайте манифест пакета Create a package manifest

Создайте файл, назовите его appxmanifest.xml, а затем добавьте в него XML-код, представленный ниже. Create a file, name it appxmanifest.xml, and then add this XML to it.

Это базовый шаблон, который содержит элементы и атрибуты, требуемые для вашего пакета. It’s a basic template that contains the elements and attributes that your package needs. Мы добавим для них значения в следующем разделе. We’ll add values to these in the next section.

Заполните элементы уровня пакета для файла Fill in the package-level elements of your file

Заполните этот шаблон сведениями о вашем пакете. Fill in this template with information that describes your package.

Сведения об удостоверении Identity information

Вот пример элемента Identity с замещающим текстом для атрибутов. Here’s an example Identity element with placeholder text for the attributes. Вы можете задать атрибуту ProcessorArchitecture значение x64 или x86 . You can set the ProcessorArchitecture attribute to x64 or x86 .

Если вы зарезервировали имя приложения в Microsoft Store, значения для «Name» (Имя) и «Publisher» (Издатель) можно получить с помощью Центра партнеров. If you’ve reserved your application name in the Microsoft Store, you can obtain the Name and Publisher by using Partner Center. Если планируется, что приложение будет загружено на другие системы в неопубликованном виде, вы можете указать для этих атрибутов собственные имена при условии, что имя издателя совпадает с именем, указанным в сертификате, который используется для подписания приложения. If you plan to sideload your application onto other systems, you can provide your own names for these as long as the publisher name that you choose matches the name on the certificate you use to sign your app.

Свойства Properties

Элемент Properties имеет три обязательных дочерних элемента. The Properties element has 3 required child elements. Вот пример узла Properties с замещающим текстом для элементов. Here is an example Properties node with placeholder text for the elements. DisplayName — это имя приложения, которое вы резервируете в Store для отправляемых в этот Store приложений. The DisplayName is the name of your application that you reserve in the Store, for apps which are uploaded to the Store.

Ресурсы Resources

Вот пример узла Resources. Here is an example Resources node.

Зависимости Dependencies

Для классических приложений, для которых вы создаете пакет, всегда задавайте для атрибута Name значение Windows.Desktop . For desktop apps that you create a package for, always set the Name attribute to Windows.Desktop .

Характеристики Capabilities

Для классических приложений, для которых вы создаете пакет, необходимо добавить возможность runFullTrust . For desktop apps that you create a package for, you’ll have to add the runFullTrust capability.

Заполните элементы уровня приложения Fill in the application-level elements

Заполните этот шаблон сведениями о вашем приложении. Fill in this template with information that describes your app.

Элемент приложения Application element

Для классических приложений, для которых вы создаете пакет, атрибут EntryPoint элемента «Application» всегда имеет значение Windows.FullTrustApplication . For desktop apps that you create a package for, the EntryPoint attribute of the Application element is always Windows.FullTrustApplication .

Визуальные элементы Visual elements

Вот пример узла VisualElements. Here is an example VisualElements node.

Добавление специальных ресурсов без покрытия (необязательно) (Optional) Add Target-based unplated assets

Специальные ресурсы предназначены для значков и плиток, которые отображаются на панели задач Windows, в представлении задач, в окне, вызываемом сочетанием клавиш ALT+TAB, в Snap Assist и в правом нижнем углу плиток начального экрана. Target-based assets are for icons and tiles that appear on the Windows taskbar, task view, ALT+TAB, snap-assist, and the lower-right corner of Start tiles. Подробнее об этом см. здесь. You can read more about them here.

Получите правильные изображения 44×44 и скопируйте их в папку с изображениями (например, «Ресурсы»). Obtain the correct 44×44 images and then copy them into the folder that contains your images (i.e., Assets).

Создайте копию каждого изображения 44×44 в той же папке и добавьте .targetsize-44_altform-unplated к имени файла. For each 44×44 image, create a copy in the same folder and append .targetsize-44_altform-unplated to the file name. Вам потребуются две копии каждого значка, каждый из которых должен быть назван особым образом. You should have two copies of each icon, each named in a specific way. Например, после завершения процесса папка ресурсов может содержать файлы MYAPP_44x44.png и MYAPP_44x44.targetsize 44_altform unplated.png. For example, after completing the process, your assets folder might contain MYAPP_44x44.png and MYAPP_44x44.targetsize-44_altform-unplated.png.

В этом примере значок MYAPP_44x44.png — это значок, который вы укажете в атрибуте логотипа Square44x44Logo вашего пакета MSIX. In this example, the icon named MYAPP_44x44.png is the icon that you’ll reference in the Square44x44Logo logo attribute of your MSIX package.

В файле манифеста задайте BackgroundColor для каждого значка, который должен быть прозрачным. In the manifest file, set the BackgroundColor for every icon you are making transparent.

Перейдите к следующему подразделу для создания нового файла индекса ресурсов пакета. Continue to the next subsection to generate a new Package Resource Index file.

Создание файла индекса ресурсов пакета (PRI) с помощью MakePri Generate a Package Resource Index (PRI) file using MakePri

Для создания специальных ресурсов, как описано в приведенном выше разделе, или изменения каких-либо визуальных ресурсов приложения после создания пакета, необходимо создать новый файл PRI. If you create target-based assets as described in the section above, or you modify any of the visual assets of your application after you’ve created the package, you’ll have to generate a new PRI file.

В зависимости от пути установки пакета SDK MakePri.exe может находиться в следующих расположениях на компьютере с Windows 10: Based on your installation path of the SDK, this is where MakePri.exe is on your Windows 10 PC:

• x86: C:\Program Files (x86)\Windows Kits\10\bin\ \x86\makepri.exe x86: C:\Program Files (x86)\Windows Kits\10\bin\ \x86\makepri.exe
• X64: C:\Program Files (x86)\Windows Kits\10\bin\ \x64\makepri.exe x64: C:\Program Files (x86)\Windows Kits\10\bin\ \x64\makepri.exe

Версия ARM этого средства отсутствует. There is no ARM version of this tool.

Откройте командную строку или окно PowerShell. Open a Command Prompt or PowerShell window.

Смените каталог на корневую папку пакета и создайте файл priconfig.xml с помощью команды

\makepri.exe createconfig /cf priconfig.xml /dq en-US . Change directory to the package’s root folder, and then create a priconfig.xml file by running the command

\makepri.exe createconfig /cf priconfig.xml /dq en-US .

Создайте файлы resources.pri с помощью команды

\makepri.exe new /pr

\priconfig.xml . Create the resources.pri file(s) by using the command

\makepri.exe new /pr

Например, команда для вашего приложения может выглядеть так:

\makepri.exe new /pr c:\MYAPP /cf c:\MYAPP\priconfig.xml . For example, the command for your application might look like this:

\makepri.exe new /pr c:\MYAPP /cf c:\MYAPP\priconfig.xml .

Упакуйте приложение, руководствуясь инструкциями в следующем шаге. Package your application by using the instructions in the next step.

Протестируйте приложение перед упаковкой Test your application before packaging

Вы можете развернуть неупакованное приложение и протестировать его перед упаковкой или подписанием. You can deploy your non-packaged application and test it before packaging or signing. Для этого запустите нижеприведенную команду из окна PowerShell. To do so, run the cmdlet below from a PowerShell window. Обязательно передайте файл манифеста вашего приложения, расположенный в корне каталога вашего пакета, со всеми другими вашими компонентами пакета. Make sure to pass in your application’s manifest file located in the root of your package directory with all your other package components:

Add-AppxPackage –Register AppxManifest.xml

Как только это будет выполнено, Once this is done. ваше приложение необходимо развернуть в системе. Перед упаковкой вы можете протестировать его, чтобы удостовериться, что все работает. Your app should be deployed on the system and you can test it to make sure everything works before packaging. Чтобы обновить файлы .exe или .dll приложения, замените существующие файлы в пакете новыми, повысьте номер версии в AppxManifest.xml, а затем выполните указанную выше команду повторно. To update your app’s .exe or .dll files, replace the existing files in your package with the new ones, increase the version number in AppxManifest.xml, and then run the above command again.

Упакуйте ваши компоненты в MSIX Package your components into an MSIX

Следующий шаг. Используйте MakeAppx.exe для создания MSIX-пакета для вашего приложения. The next step is to use MakeAppx.exe to generate an MSIX package for your application. Makeappx.exe входит в пакет Windows 10 SDK, и если у вас установлена Visual Studio, доступ к нему можно получить через командную строку разработчика Visual Studio. Makeappx.exe is included with the Windows 10 SDK, and if you have Visual Studio installed, it can be easily accessed through the Developer Command Prompt for Visual Studio.

Упакованное приложение всегда выполняется от лица текущего пользователя, а диск, на который производится установка приложения, должен быть отформатирован в NTFS. A packaged application always runs as an interactive user, and any drive that you install your packaged application on to must be formatted to NTFS format.

Создание классических приложений для компьютеров с Windows Build desktop apps for Windows PCs

Эта статья содержит сведения, необходимые, чтобы приступить к созданию классических приложений для Windows или обновления существующих классических приложений для использования новейших возможностей Windows 10 This article provides the info you need to get started building desktop apps for Windows or updating existing desktop apps to adopt the latest experiences in Windows 10.

Платформы для классических приложений Platforms for desktop apps

Существуют четыре основные платформы для создания классических приложений для компьютеров с Windows. There are four main platforms for building desktop apps for Windows PCs. Каждая платформа предоставляет модель приложения, определяющую жизненный цикл приложения, полную инфраструктуру пользовательского интерфейса и набор элементов управления пользовательского интерфейса, которые позволяют создавать классические приложения, такие как Word, Excel и Photoshop, и получать доступ к исчерпывающему набору управляемых или собственных API-интерфейсов для использования функций Windows. Each platform provides an app model that defines the lifecycle of the app, a complete UI framework and set of UI controls that let you create desktop apps like Word, Excel, and Photoshop, and access to a comprehensive set of managed or native APIs for using Windows features.

Подробное сравнение этих платформ и дополнительные материалы по каждой платформе доступны в разделе Выбор платформы для приложения. For an in-depth comparison of these platforms along with additional resources for each platform, see Choose your app platform.

Передовая платформа для приложений и игр для, предназначенных для Windows 10. The leading-edge platform for Windows 10 apps and games. Вы можете создавать приложения UWP, которые используют только элементы управления и интерфейсы API универсальной платформы Windows (UWP), или использовать эти элементы управления и API в классических приложениях, созданных с помощью одной из других платформ. You can build UWP apps that exclusively use UWP controls and APIs, or you can use UWP controls and APIs in desktop apps that are built using one of the other platforms.

Предпочтительная платформа для собственных приложений для Windows, которым требуется прямой доступ к Windows и оборудованию. The platform of choice for native Windows apps that require direct access to Windows and hardware.

Общепризнанная платформа на основе .NET для преимущественно графических приложений для Windows, использующих модель пользовательского интерфейса XAML. The established .NET-based platform for graphically-rich managed Windows apps with a XAML UI model. Эти приложения могут быть нацелены на .NET Core 3 или полную платформу .NET Framework. These apps can target .NET Core 3 or the full .NET Framework.

Платформа на основе .NET, предназначенная для управляемых бизнес-приложений, использующих упрощенную модель пользовательского интерфейса. A .NET-based platform that is designed for managed line-of-business apps with a lightweight UI model. Эти приложения могут быть нацелены на .NET Core 3 или полную платформу .NET Framework. These apps can target .NET Core 3 or the full .NET Framework.

Стратегия развития Future roadmap

В будущем мы планируем улучшать платформы разработки приложений для Windows с помощью библиотеки пользовательского интерфейса Windows (WinUI) и Project Reunion. Looking forward, we are evolving the Windows app development platforms with the Windows UI Library (WinUI) and Project Reunion.

WinUI — это собственная среда взаимодействия с пользователем для приложений Windows 10. WinUI is a native user experience (UX) framework for Windows 10 apps. Библиотека WinUI разрабатывалась как набор средств. Она предоставляла новые и обновленные версии элементов управления WinRT для приложений UWP, предназначенных для более ранних версий Windows 10. WinUI started as a toolkit that provides new and updated versions of WinRT controls for UWP apps that target down-level versions of Windows 10. Область действия WinUI расширилась, и WinUI 3 представляет собой современную нативную платформу пользовательского интерфейса для приложений Windows 10 в UWP, .NET и Win32. As of WinUI 3, WinUI is growing in scope to become the premier native user interface (UI) framework for Windows 10 apps across UWP, .NET, and Win32 app platforms.

Project Reunion — это кодовое название для широкого спектра новых компонентов и инструментов для разработчиков. Это новый этап развития платформы для разработки приложений Windows. Project Reunion is the code name for a broad set of new developer components and tools that represents the next evolution in the Windows app development platform. Project Reunion включает единый набор API и инструментов, которые могут согласованно использоваться любыми приложениями в различных целевых версиях ОС Windows 10. Project Reunion provides a unified set of APIs and tools that can be used in a consistent way by any app on a broad set of target Windows 10 OS versions. Project Reunion дополняет имеющиеся платформы и среды приложений Windows, такие как UWP, нативная среда Win32 и .NET, общим набором API и инструментов, которые упрощают работу разработчиков. Project Reunion complements existing Windows app platforms and frameworks such as UWP and native Win32, and .NET with a common set of APIs and tools that developers can rely on across these platforms.

Дополнительные сведения см. в статье Project Reunion. For more information, see Project Reunion.

Обновление существующих классических приложений для Windows 10 Update existing desktop apps for Windows 10

Если у вас есть классические приложения WPF, Windows Forms или собственные классические приложения Win32, в Windows 10 и универсальной платформе Windows (UWP) предлагается много возможностей для реализации современных функций в имеющихся приложениях. If you have an existing WPF, Windows Forms, or native Win32 desktop app, Windows 10 and the Universal Windows Platform (UWP) offer many features you can use to deliver a modern experience in your app. Большинство этих функций доступны в виде модульных компонентов, которые можно внедрить в приложение в своем собственном темпе, не переписывая код приложения для другой платформы. Most of these features are available as modular components that you can adopt in your app at your own pace without having to rewrite your app for a different platform.

Ниже приведено лишь несколько функций, позволяющих улучшить существующие классические приложения. Here are just a few of the features available to enhance your existing desktop apps:

• Используйте MSIX для упаковки и развертывания классических приложений. Use MSIX to package and deploy your desktop apps. MSIX — это современный формат пакета приложения для Windows, позволяющий упаковывать любые приложения для Windows. MSIX is a modern Windows app package format that provides a universal packaging experience for all Windows apps. Этот безопасный и надежный формат упаковки сочетает в себе преимущества технологий установки с использованием MSI-файлов, APPX-файлов, App-V и ClickOnce. MSIX brings together the best aspects of MSI, .appx, App-V and ClickOnce installation technologies and is built to be safe, secure, and reliable.
• Интегрируйте возможности Windows 10 в свое классическое приложение с помощью расширений пакетов. Integrate your desktop app with Windows 10 experiences by using package extensions. Например, закрепите свое приложение в меню «Пуск», предоставьте к нему общий доступ или отправляйте всплывающие уведомления из приложения. For example, point Start tiles to your app, make your app a share target, or send toast notifications from your app.
• Используйте острова XAML для размещения элементов управления XAML UWP в своем классическом приложении. Use XAML Islands to host UWP XAML controls in your desktop app. Многие последние функции пользовательского интерфейса Windows 10 доступны только для элементов управления XAML UWP. Many of the latest Windows 10 UI features are only available to UWP XAML controls.

Дополнительные сведения доступны в приведенных ниже статьях. For more information, see these articles.

Платформа Platform	Описание Description	Документация и ресурсы Docs and resources
Универсальная платформа Windows (UWP) Universal Windows Platform (UWP)

Статья Article	Описание Description
Модернизация классических приложений Modernize desktop apps	Описываются последние возможности разработки для Windows 10 и UWP, которые можно использовать в любом классическом приложении, включая приложения WPF, Windows Forms и приложения Win32 на C++. Describes the latest Windows 10 and UWP development features you can use in any desktop app, including WPF, Windows Forms, and C++ Win32 apps.
Руководство. Модернизация приложения WPF Tutorial: Modernize a WPF app	Следуйте пошаговым инструкциям, чтобы модернизировать существующий пример бизнес-приложения WPF, добавив элементы управления рукописным вводом и календарем UWP в приложение и упаковав его в пакет MSIX. Follow step-by-step instructions to modernize an existing WPF line-of-business sample app by adding UWP Ink and calendar controls to the app and packaging it in an MSIX package.

Создание классических приложений Create new desktop apps

Ниже приведены некоторые ресурсы, которые помогут вам приступить к созданию классического приложения для Windows. If you are creating a new desktop app for Windows, here are some resources to help get you started.