Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Объявляет точку расширяемости для пакета.
Иерархия элементов
<Package>
└─ <Applications>
└─ <Application>
└─ <Extensions>
└─ <Extension>
Syntax
<Package
xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10">
...
<Extension
Category = 'A required string that can have one of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".'
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.'
RuntimeType = 'An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
StartPage = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
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.'
uap11:Id = 'An optional string between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
uap11:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
uap11:SupportsMultipleInstances = 'An optional boolean value.'
uap11:ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
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.'
desktop7:CompatMode = 'An optional string that can have one of the following values: "classic", or "modern".'
desktop7:Scope = 'An optional string that can have one of the following values: "machine", or "user".' >
<!-- Child elements -->
BackgroundTasks?
</Extension>
</Package>
Ключ
? необязательный (ноль или один)
Атрибуты
| Атрибут | Description | Тип данных | Обязательный | Значение по умолчанию |
|---|---|---|---|---|
| Категория | Тип расширения. | Строка, которая может иметь одно из следующих значений: windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask, windows.restrictedLaunch. | Yes | |
| desktop11:AppLifecycleBehavior | Необязательная строка, которая может иметь одно из следующих значений: systemManaged, неуправляемая. | Нет | ||
| Исполнимый файл | Исполняемый файл по умолчанию. | Необязательная строка от 1 до 256 символов длиной, которая должна заканчиваться ".exe" и не может содержать следующие символы: <, , >: , ", ", |, ?или *". | Нет | |
| EntryPoint | Идентификатор активируемого класса. | Необязательная строка от 1 до 256 символов длиной, которая не может начинаться или заканчиваться символом пробела. | Нет | |
| RuntimeType | Поставщик среды выполнения. Обычно используется при наличии смешанных платформ в приложении. | Необязательная строка от 1 до 255 символов длиной, которая не может начинаться или заканчиваться периодом или содержать следующие символы: <, , >: , ", /, |, ?или *. | Нет | |
| StartPage | Веб-страница, обрабатывающая точку расширяемости. | Необязательная строка от 1 до 256 символов длиной, которая не может содержать следующие символы: <, , >:, ", |, ?или *. | Нет | |
| ResourceGroup | Тег, который можно использовать для группирования активаций расширений вместе для целей управления ресурсами (например, ЦП и памяти). | Необязательная буквенно-цифровые строки длиной от 1 до 255 символов. Должен начинаться с алфавитного символа. | Нет | |
| uap10:TrustLevel | Указывает уровень доверия расширения. | Необязательная строка, которая может иметь одно из следующих значений: appContainer, mediumIL. | Нет | |
| uap10:RuntimeBehavior | Указывает поведение времени выполнения расширения. | Необязательная строка, которая может иметь одно из следующих значений: windowsApp, packagedClassicApp, win32App. | Нет | |
| uap10:HostId | Указывает идентификатор среды выполнения узла для расширения. | Необязательная буквенно-цифровые строки длиной от 1 до 255 символов. Должен начинаться с алфавитного символа. | Нет | |
| uap10:Parameters | Содержит параметры командной строки для передачи в расширение. Поддерживается только для классических приложений, имеющих удостоверение пакета. | Необязательная строка между 1 и 32767 символами длиной без пробелов в начале и конце. | Нет | |
| uap11:Id | Идентификатор расширения. Идентификатор должен быть уникальным для всех расширений в пакете. | Необязательная строка в диапазоне от 1 до 255 символов длиной с символом без пробелов в начале и конце. | Нет | |
| uap11:Подсистема | Этот атрибут полезен для процессов, отличных от UWP, которые необходимо запустить с определенной подсистемой. В большинстве случаев это должно оставаться по умолчанию. | Необязательная строка, которая может иметь одно из следующих значений: консоль, окна. | Нет | |
| uap11:SupportsMultipleInstances | Указывает, поддерживает ли расширение несколько экземпляров. | Необязательное логическое значение. | Нет | |
| uap11:ResourceGroup | Тег, который можно использовать для группирования активаций расширений вместе для целей управления ресурсами (например, ЦП и памяти). | Необязательная буквенно-цифровые строки длиной от 1 до 255 символов. Должен начинаться с алфавитного символа. | Нет | |
| uap11:CurrentDirectoryPath | Указывает начальный каталог при запуске процесса. | Необязательная строка, которая не может содержать следующие символы: <, >|, ?или *. | Нет | |
| uap11:Parameters | Содержит параметры командной строки для передачи в расширение. | Необязательная строка между 1 и 32767 символами длиной без пробелов в начале и конце. | Нет | |
| desktop7:CompatMode | Указывает режим совместимости для расширения. | Необязательная строка, которая может иметь одно из следующих значений: классическая, современная. | Нет | |
| desktop7:Scope | Указывает, является ли расширение для каждого пользователя или компьютера. | Необязательная строка, которая может иметь одно из следующих значений: компьютер, пользователь. | Нет |
Дочерние элементы
| Дочерний элемент | Description |
|---|---|
| BackgroundTasks | Определяет точку расширяемости приложения типа windows.backgroundTasks. Фоновые задачи выполняются в выделенном фоновом узле; то есть без пользовательского интерфейса. |
Родительские элементы
| Родительский элемент | Description |
|---|---|
| Extensions | Определяет одну или несколько точек расширяемости для приложения. |
Требования
| Элемент | Ценность |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/foundation/windows10 |
| desktop11 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/11 |
| desktop7 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/7 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| uap11 | http://schemas.microsoft.com/appx/manifest/uap/windows10/11 |
| минимальная версия ОС |
Замечания
Если атрибуты сведений о активации не указаны Extension, они наследуются от родительского Applicationэлемента. См. раздел примечаний Application для элемента.
Точки расширяемости — это механизм, с помощью которого пакет может добавлять функциональные возможности в соответствии с операционной системой. Точка расширяемости — это расположение, в котором приложение может зарегистрировать код или использовать ресурсы текущего пакета. Чтобы добавить функциональные возможности для конкретного Application приложения, используйте Applications дочерний элемент элемента.
Точка расширения
Note
Атрибут windows.Use, UpdateTask или windows.preInstalledConfigTask для целевых устройств, работающих Windows 10, версия 1607 или более поздняя.
Примеры
См. также
Следующие элементы имеют то же имя, что и этот, но другое содержимое или атрибуты: