uap:Extension (Windows 10)

Объявляет точку расширяемости для приложения.

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

<Пакет>

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

         <Развертывание>

              <Модули>

                   <uap:Extension>

Синтаксис

<uap:Extension
  Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
  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.'
  RuntimeType = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
  uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'

  <!-- Child elements -->
  uap:FileTypeAssociation?
  uap:Protocol?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:AppService?
  uap:MediaPlayback?
  uap:VoipCall?

</uap:Extension>

Клавиши

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Категория Тип точки расширяемости пакета. Строка, которая может иметь одно из следующих значений: windows.fileTypeAssociation, windows.protocol, windows.autoPlayContent, windows.autoPlayDevice, windows.shareTarget, windows.search, windows.fileOpenPicker, windows.fileSavePicker, windows.cachedFileUpdater, windows.cameraSettings, windows.accountPictureProvider, windows.printTaskSettings, windows.lockScreenCall, windows.appointmentsProvider, windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunch или windows.voipCall. Да
EntryPoint Идентификатор активируемого класса. Строка со значением от 1 до 256 символов длиной. Представляет задачу, обрабатываемую расширение (обычно полное имя пространства имен типа среда выполнения Windows). Если EntryPoint не указан, вместо этого используется точка entryPoint, определенная для приложения. Нет
Исполняемый объект Исполняемый файл запуска по умолчанию. Строка со значением от 1 до 256 символов длиной, которая должна заканчиваться .exeсимволами и не может содержать следующие символы: <, , >, :", |или ?*. Указывает исполняемый файл по умолчанию для расширения. Если значение не указано, используется исполняемый файл, определенный для приложения. Если задано, свойство EntryPoint также используется. Если это свойство EntryPoint не указано, используется точка входа, определенная для приложения. Нет
RuntimeType Поставщик среды выполнения. Обычно используется при наличии смешанных платформ в приложении. Строка со значением от 1 до 255 символов длиной, которая не может начинаться или заканчиваться символами.: <, , , >, :", |?или *. Нет
StartPage Веб-страница, обрабатывающая точку расширения. Строка со значением от 1 до 256 символов длиной, которая не может содержать следующие символы: <, >:, "или |?*. Нет
ResourceGroup Необязательный тег, используемый для группирования активаций расширений в целях управления ресурсами (например, ЦП и память). См. раздел "Примечания " в Application@ResourceGroup. Буквенно-цифровой строки длиной от 1 до 255 символов. Должно начинаться с буквы. Нет
uap10:TrustLevel Указывает уровень доверия расширения. Необязательное строковое значение. Если он указан, это может быть одно из следующих значений: appContainer или mediumIL. Нет
uap10:RuntimeBehavior Указывает поведение среды выполнения расширения. Необязательное строковое значение. Если он указан, это может быть одно из следующих значений: windowsApp, packagedClassicApp или win32App. Нет
uap10:HostId Указывает идентификатор приложения ведущего приложения для расширения. Буквенно-цифровые строки с необязательным значением длиной от 1 до 255 символов. Должно начинаться с буквы. Нет
uap10:Parameters Содержит параметры командной строки для передачи в расширение. Поддерживается только для классических приложений, имеющих удостоверение пакета. Строка со значением от 1 до 32767 символов длиной с символом без пробелов в начале и конце. Нет

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

Дочерний элемент Описание
uap:AppService Объявляет точку расширяемости приложения типа windows.appService. Контракты приложений — это способ вызова фоновой задачи, принадлежащей другому приложению; или для фоновой задачи, вызываемой для обслуживания контракта приложения способом взаимодействия с вызывающим объектом.
uap:AppointmentsProvider Объявляет точку расширяемости приложения типа windows.appointmentsProvider.
uap:AutoPlayContent Объявляет точку расширяемости приложения типа windows.autoPlayContent. Приложение предоставляет указанные действия с содержимым автозапуска.
uap:AutoPlayDevice Объявляет точку расширяемости приложения типа *windows.autoPlayDevice. Приложение предоставляет указанные действия устройства автозапуска.
uap:DialProtocol Объявляет точку расширяемости приложения типа windows.dialProtocol*.
uap:FileOpenPicker Объявляет точку расширяемости приложения типа windows.fileOpenPicker. Приложение позволяет пользователю выбирать и открывать указанные типы файлов.
uap:FileSavePicker Объявляет точку расширяемости приложения типа windows.fileSavePicker. Приложение позволяет пользователю выбрать имя файла, расширение и расположение хранилища для указанных типов файлов.
uap:FileTypeAssociation Объявляет точку расширяемости приложения типа windows.fileTypeAssociation. Сопоставление типов файлов указывает, что приложение зарегистрировано для обработки файлов указанных типов.
uap:MediaPlayback Объявляет точку расширяемости приложения типа mediaPlayback, чтобы приложение вело объявление о том, что оно выполняет перекодирование видео.
uap:Protocol Объявляет точку расширяемости приложения типа windows.protocol. Связь URI указывает, что приложение зарегистрировано для обработки URI с указанной схемой.
uap:ShareTarget Объявляет точку расширения приложения типа windows.shareTarget. Приложение может совместно использовать указанные типы файлов.
uap:VoipCall Объявляет точку расширяемости приложения типа windows.voipCall , чтобы ваше приложение вело объявить, что оно может выполнить обновление от сотового звонка до видеозвонка VoIP и (или) приложение VoIP, которое поддерживает набор номеров телефонов напрямую.
uap:WebAccountProvider Объявляет точку расширяемости приложения типа windows.webAccountProvider.

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

Родительский элемент Описание
Расширения (type:CT_ApplicationExtensions) Определяет одну или несколько точек расширяемости для приложения.

Комментарии

Для большинства типов расширений Extension@ResourceGroup должны соответствовать Application@ResourceGroup (если Application@ResourceGroup опущен, то Extension@ResourceGroup следует также опустить).

Для контракта на основе пользовательского интерфейса: если Extension@ResourceGroup не указан, он будет неявно сгруппирован с приложением; Если Extension@ResourceGroup не соответствует Application@ResourceGroup, манифест завершится ошибкой проверки схемы.

Если Extension@ResourceGroup не указан для фоновой задачи или контракта, основанного на фоновой задаче, она будет связана с группой по умолчанию для всех фоновых задач. Контракты фоновых задач могут указывать те же значения, что и Application@ResourceGroup.

Для следующих расширений Extension@ResourceGroup позволяет сгруппировать фоновую задачу в различные процессы, которые будут управляться ресурсами и жизненным циклом независимо от других групп: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask и windows.updateTask.

Например, если манифест содержит эти три записи.

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
  <BackgroundTasks>
    <Task Type="timer"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="controlChannel"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="pushNotification"/>
  </BackgroundTasks>
</Extension>

Затем две последние фоновые задачи будут активированы в том же экземпляре backgroundtaskhost.exe , если они были активированы одновременно. Однако отдельный экземпляр backgroundtaskhost.exe будет развернуться для первой записи, так как она имеет другую группу ресурсов.

Если для расширения не указана группа ресурсов, все фоновые задачи активируются в одном экземпляре backgroundtaskhost.exe.

Кроме того, если одно из этих расширений (windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask или windows.updateTask) указывает то же значение атрибута ResourceGroup родительского элемента приложения, что они будут активированы в том же процессе, что и пользовательский интерфейс.

Следующие расширения можно найти на вкладке объявлений пользовательского интерфейса конструктора пакетов. Описание каждого из этих элементов см. в описании:

  • Поиск: регистрирует приложение в качестве поставщика поиска. Индексированные содержимое приложения могут отображаться в виде результатов поиска в интерфейсе глобальный поиск, запущенном с помощью чудо-кнопки поиска. Допускается только один экземпляр этого объявления на каждое приложение.
  • CachedFileUpdater: регистрирует приложение как кэшированное средство обновления файлов, позволяя приложению предоставлять обновления файлов, к которым обращаются другие приложения Microsoft Store. Допускается только один экземпляр этого объявления на каждое приложение.
  • Параметры камеры: позволяет приложению предоставлять пользовательские панели управления для устройств веб-камеры. Допускается только один экземпляр этого объявления на каждое приложение.
  • AccountPictureProvider: регистрирует приложение в качестве поставщика рисунков учетной записи, позволяя запускать его в режиме изображения учетной записи и настраивать изображение пользователя без дополнительных запросов. Допускается только один экземпляр этого объявления на каждое приложение.
  • PrintTaskSettings: позволяет приложению заменить основные параметры печати. Допускается только один экземпляр этого объявления на каждое приложение.
  • LockScreen: если телефон заблокирован, существует ограниченное количество взаимодействий, которые может выполнить пользователь. В некоторых случаях пользователь хотел бы иметь возможность ответить на звонок VoIP без разблокировки телефона. Этот контракт делает это возможным. Допускается только один экземпляр этого объявления на каждое приложение.
  • Оповещение: приложение может объявить себя как приложение системной сигнализации. Когда пользователь проходит через пользовательский интерфейс выбора, чтобы задать свой системный сигнал тревоги, можно выбрать только приложения, объявленные как приложения системной сигнализации. Допускается только один экземпляр этого объявления на каждое приложение.
  • BackgroundTasks: фоновые задачи позволяют приложениям взаимодействовать друг с другом и разрешать одному приложению вызывать другое. Чтобы использовать контракты для предоставления или запуска этих фоновых задач, приложение должно быть объявлено как служба приложений. Не допускается использовать в одном приложении несколько экземпляров этого объявления.
  • Print3DWorkFlow: производители трехмерных принтеров могут предоставить универсальное приложение для Windows для предоставления уникального интерфейса в диалоговом окне трехмерной печати. В противном случае Windows предоставляет трехмерную печать по умолчанию. Допускается только один экземпляр этого объявления на каждое приложение.
  • PersonalAssistantLaunch: позволяет приложению интегрироваться с Кортаной. Допускается только один экземпляр этого объявления на каждое приложение.

Требования

Элемент Значение
rescap4 http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10