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

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

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

пакета

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

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

Синтаксис

<Application
  EntryPoint? = 'See the Attributes table for more info.'
  Executable?
  uap10:HostId?
  Id
  uap10:Parameters?
  ResourceGroup?
  uap10:RuntimeBehavior?
  StartPage?
  desktop4:Subsystem?
  uap10:Subsystem?
  desktop4:SupportsMultipleInstances?
  uap10:SupportsMultipleInstances?
  uap10:TrustLevel?
  uap16:BaseNamedObjectsIsolation?
  uap17:BaseNamedObjectsIsolation?
  desktop11:AppLifecycleBehavior?
  uap11:CurrentDirectoryPath?
  uap11:Parameters?

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

</Application>

Ключ

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

Атрибуты и элементы

Атрибуты

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

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

Замечания

Элемент 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 области приложения. Если они не указаны в расширении, они наследуются от родительского приложения. Эти атрибуты указываются в сочетаниях: например, 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 одновременно. Но если это сделать, то это ошибка, если они противоречат.

Для активации приложений универсальной платформы Windows (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 .

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

Требования