Application

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

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

<Package>
   └─ <Applications>
      └─ <Application>

Syntax

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10">
  ...
  <Application
    Id = 'A required value. <!-- TODO: Add description for t:ST_ApplicationId -->'
    Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
    StartPage = 'An optional value. <!-- TODO: Add description for t:ST_ApplicationStartPage -->'
    ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
    desktop4:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
    iot2:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
    uap10:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
    desktop4:SupportsMultipleInstances = 'An optional boolean value.'
    iot2:SupportsMultipleInstances = 'An optional boolean value.'
    uap10:SupportsMultipleInstances = 'An optional boolean value.'
    uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
    uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    previewsecurity:TrustLevel = 'An optional string that can have one of the following values: "appContainer", "mediumIL", or "appSilo".'
    uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer", or "mediumIL".'
    uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
    uap10:HostId = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
    uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    previewsecurity2:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", "win32App", or "appSilo".'
    uap16:BaseNamedObjectsIsolation = 'An optional string that can have one of the following values: "none", or "package".'
    uap17:BaseNamedObjectsIsolation = 'An optional string that can have one of the following values: "none", or "package".'
    desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".' >

    <!-- Child elements -->
    VisualElementsChoice
    ApplicationContentUriRules?
    Extensions?
    Properties?

  </Application>
</Package>

Ключ

? необязательный (ноль или один)

Атрибуты

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

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

Требования

Замечания

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

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

uap10 появился в Windows 10 версии 2004 (10.0; Сборка 19041)

Пространство имен uap10 (для uap10:RuntimeBehavior и uap10:TrustLevel) было введено в Windows 10 версии 2004 (10.0; Сборка 19041). Если пакет устанавливается в системах старше этого, необходимо предоставить эквивалентное сочетание атрибутов (см. следующий раздел), в противном случае сведения о активации будут неполными, а установка завершится ошибкой.

Но если пакет имеет <TargetDeviceFamily MinVersion="10.0.19041.0">или выше, он устанавливается только в системах, поддерживающих uap10 пространство имен. В этом случае следует использовать uap10:RuntimeBehavior и uap10:TrustLevel атрибуты в предпочтениях более старых эквивалентных сочетаний (см. следующий раздел).

Сочетания атрибутов сведений о активации

В элементе можно указать атрибуты сведений Application об активации. При необходимости их можно указать в элементе extension области приложения. Если они не указаны в extension, они наследуются от родительского Applicationэлемента. Эти атрибуты указываются в сочетаниях: например, EntryPoint, RuntimeBehavior и TrustLevel имеют перекрывающееся значение, и они указываются (и/или наследуются) в сочетаниях. Ниже приведены некоторые допустимые сочетания атрибутов сведений о активации.

1. Исполняемый файл, uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel=["mediumIL", или "appContainer" (по умолчанию, если опущен)]
2. Исполняемый файл, uap10:RuntimeBehavior="win32App", uap10:TrustLevel="mediumIL" (для других требований см. описание выше в этом разделе для uap10:RuntimeBehavior).
3. Исполняемый файл, EntryPoint="windows.fullTrustApplication" (эквивалент uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="mediumIL")
4. Исполняемый файл, EntryPoint="windows.partialTrustApplication" (эквивалент uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="appContainer")
5. Исполняемый файл, EntryPoint="<что-нибудь еще>"

Как видно, если целевая система не поддерживает uap10 пространство имен, можно указать атрибут EntryPoint . Аналогичным образом эквивалент uap10:TrustLevel="appContainer" в старых системах — EntryPoint="windows.partialTrustApplication".

Но это избыточно, чтобы указать uap10:RuntimeBehavior/uap10:TrustLevel и EntryPoint одновременно. Но если это сделать, то это ошибка, если они противоречат.

Universal Windows Platform (UWP) активации приложений требуют EntryPoint. Поэтому если указать исполняемый файл и uap10:RuntimeBehavior="windowsApp" (без EntryPoint), это ошибка. В этом же случае EntryPoint будет указывать что-то, отличное от "windows.fullTrustApplication" и "windows.partialTrustApplication"; и значения, отличные от этих двух, уже говорят то же самое, что и uap10:RuntimeBehavior="windowsApp". Поэтому uap10:RuntimeBehavior будет избыточным в этом случае, и вы указали исполняемый файл и EntryPoint.

Настройка uap10:RuntimeBehavior="win32App" и uap10:TrustLevel="appContainer" не поддерживается.

Для параметра uap10:TrustLevel="mediumIL" в то время как uap10:RuntimeBehavior="windowsApp" требуется Microsoft.coreAppActivation_8wekyb3d8bbwe настраиваемые возможности.

Это также верно, если uap10:TrustLevel="mediumIL" и EntryPoint является любым другим значением, кроме "windows.fullTrustApplication" или "windows.partialTrustApplication".

Дополнительные сведения об этой пользовательской возможности см. в разделе "Пользовательские возможности".

Важные заметки о многоуровневых приложениях

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

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

Примеры