Приложение (Windows 10)

Представляет приложение, включающее часть или все функциональные возможности, предоставляемые в пакете.

Иерархия элементов

<Пакет>

    <Приложения>

         <Приложение>

Синтаксис

<Application
  Id = 'An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.'
  Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  StartPage = 'Any valid URI or IRI (the non-ASCII version of a URI). See below for more details.' 
  ResourceGroup = 'An alphanumeric string between 1 and 255 characters in length. Must begin with an letter.'
  desktop4:Subsystem = 'A string that can have one of the following values: "console" or "windows".'
  uap10:Subsystem = 'A string that can have one of the following values: "console" or "windows".'
  desktop4:SupportsMultipleInstances = 'An optional boolean value.'
  uap10:SupportsMultipleInstances = 'An optional boolean value.'
  uap10:TrustLevel = 'A string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'A string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters   = 'A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  uap:VisualElements
  uap:ApplicationContentUriRules?
  Extensions?

</Application>

Клавиши

? необязательный (ноль или один) & соединитель взаимодействия (может происходить в любом порядке)

Элементы и атрибуты

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Id Уникальный идентификатор приложения в пакете. Оно также иногда называется связанным с пакетом идентификатором приложения (PRAID). Идентификатор уникален в пакете, но не глобально. Другой пакет в системе может использовать такой же идентификатор. Один и тот же идентификатор нельзя использовать несколько раз в одном пакете. При использовании шаблона Visual Studio значение по умолчанию этого атрибута — App. Разработчики должны вручную изменить это в манифесте. Идентификатор приложения не следует изменять после публикации приложения в Microsoft Store; это приведет к нарушению положения плитки на начальном экране. Строка ASCII длиной от 1 до 64 символов. Эта строка содержит буквенно-цифровые поля, разделенные точками. Каждое поле должно начинаться с буквенного символа ASCII. Эти значения нельзя использовать в качестве значений полей: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 и LPT9. Да
EntryPoint Идентификатор активируемых классов (например, "Office.Winword.Class"). Если этот атрибут указан, необходимо также указать исполняемый атрибут. При указании этого атрибута не следует указывать атрибут StartPage . Строка длиной от 1 до 256 символов, представляющая задачу, обрабатывающую расширение. Как правило, соответствует полному имени пространства имен типа среды выполнения Windows. Если EntryPoint не указан, вместо этого используется точка входа, определенная для приложения. Нет
Исполняемый объект Исполняемый файл запуска по умолчанию для приложения. Этот файл должен присутствовать в пакете. При указании этого атрибута необходимо указать атрибут EntryPoint . При указании этого атрибута не следует указывать атрибут StartPage . Строка длиной от 1 до 256 символов, которая должна заканчиваться .exe и не может содержать следующие символы: <, , >*:"|?или . Он задает исполняемый файл по умолчанию для расширения. Если этот параметр не указан, используется исполняемый файл, определенный для приложения. При указании также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется entryPoint, определенная для приложения. Нет
StartPage Веб-страница, обрабатывающая точку расширения. Строка со значением от 1 до 256 символов длиной, которая не может содержать следующие символы: <, , >*:"|?или . Нет
ResourceGroup Необязательный тег, используемый для объединения активаций расширений для управления ресурсами (например, ЦП и памяти). См. раздел "Примечания " в Application@ResourceGroup. Буквенно-цифровые строки длиной от 1 до 255 символов. Должно начинаться с буквы. Нет
desktop4:Subsystem Указывает, является ли приложение стандартным приложением UWP или консольным приложением UWP. Строка, которая может быть любым из следующих значений: консоль или окна. Нет
uap10:Subsystem Указывает, является ли приложение стандартным приложением UWP или консольным приложением UWP. Строка, которая может быть любым из следующих значений: conole или windows. Нет
desktop4:SupportsMultipleInstances Указывает поддержку нескольких отдельных экземпляров приложений UWP. Дополнительные сведения см. в разделе примечаний. Необязательное логическое значение Нет
uap10:SupportsMultipleInstances Указывает поддержку нескольких отдельных экземпляров приложений UWP. Дополнительные сведения см. в разделе примечаний. Необязательное логическое значение. Нет
uap10:TrustLevel Указывает уровень доверия приложения. Строка, которая может быть любым из следующих значений: appContainer или mediumIL. Нет
uap10:RuntimeBehavior Указывает поведение времени выполнения приложения. Строка, которая может быть любым из следующих значений: "windowsApp", "packagedClassicApp" или "win32App". Нет
uap10:HostId Это значение указывает идентификатор приложения ведущего приложения для текущего приложения. Этот атрибут используется для размещенных приложений. Буквенно-цифровые строки длиной от 1 до 255 символов. Должно начинаться с буквы. Нет
uap10:Parameters Содержит параметры командной строки для передачи в приложение. Поддерживается только для классических приложений с удостоверением пакета. Строка длиной от 1 до 32767 символов с символом без пробелов в начале и конце. Нет

Дочерние элементы

Дочерний элемент Описание
Расширения (тип: CT_ApplicationExtensions) Определяет одну или несколько точек расширяемости для приложения.
uap:ApplicationContentUriRules Указывает, какие страницы в веб-контексте имеют доступ к устройствам географического расположения системы (если приложение имеет разрешение на доступ к этой возможности) и доступ к буферу обмена.
uap:VisualElements Описывает визуальные аспекты приложения: его плитка по умолчанию, изображения логотипа, цвета текста и фона, начальная ориентация экрана, экран-заставка и внешний вид плитки экрана блокировки.
uap7:Properties Задает свойства приложения.

Родительские элементы

Родительский элемент Описание
Приложения Представляет одно или несколько приложений, составляющих пакет.

Remarks

Элемент Application содержит атрибуты, общие для точек расширяемости, относящихся к приложению. Эти сведения используются другими точками расширяемости для получения сведений о приложении. Кроме того, атрибуты приложения используются в начале и управлении экземпляром приложения.

StartPage применяется только к приложению JavaScript. Если Параметр StartPage не указан, необходимо указать атрибуты Исполняемого файла и EntryPoint , и это относится только к приложению C#, C++или VB.

Важные примечания о приложениях с несколькими экземплярами:

  • Если приложение объявляет supportsMultipleInstances в элементе Application , то все расширения переднего плана также будут многоэкземплярными.
  • Если приложение объявляет SupportsMultipleInstances в элементе Application , то его не нужно объявлять на уровне расширений (например, в элементе BackgroundTasks или AppService ).
  • Приложение должно объявлять только supportsMultipleInstances в фоновых задачах, фоновом звуке или службах приложений.
  • Консольные приложения всегда будут иметь несколько экземпляров и должны явно объявлять SupportsMultipleInstances.
  • Приложения могут использовать объявление ResourceGroup в манифесте для группировки нескольких фоновых задач на одном узле. Это конфликтует с моделью с несколькими экземплярами, где каждая активация переходит в отдельный хост-процесс. Поэтому приложение не может объявлять в манифесте как SupportsMultipleInstances, так и ResourceGroup .

Дополнительные сведения об использовании атрибута SupportsMultipleInstances для поддержки нескольких отдельных экземпляров приложений UWP см. в статье "Создание универсального приложения для Windows с несколькими экземплярами".

Требования

Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/uap/windows10
Атрибуты desktop4 http://schemas.microsoft.com/appx/manifest/desktop/windows10/4
Атрибуты uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10