Расширение (в типе: CT_ApplicationExtensions)

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

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

<Пакет>
<Приложения>
<Развертывание>
<Модули>
<Продлен>

Синтаксис

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It 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 that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string between 1 and 256 characters in length, representing the task  handling the extension. This is 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 between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

Ключ

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Категория

Тип точки расширяемости приложения.

Этот атрибут может иметь одно из следующих значений:

  • Windows. ФилетипеассоЦиатион
  • Windows. Protocol
  • Windows. Аутоплайконтент
  • Windows. Аутоплайдевице
  • Windows. Шаретаржет
  • Windows. Search
  • Windows. Филеопенпиккер
  • Windows. Филесавепиккер
  • Windows. Качедфилеупдатер
  • Windows. Контактпиккер
  • Windows. Баккграундтаскс
  • Windows. Камерасеттингс
  • Windows. Аккаунтпиктурепровидер
  • Windows. Принттасксеттингс
Да
EntryPoint

Идентификатор класса активируемого.

Строка длиной от 1 до 256 символов, представляющая задачу обработки расширения. Как правило, соответствует полному имени пространства имен типа среды выполнения Windows. Если точка входа не указана, вместо нее используется точка входа, определенная для приложения. Нет
Исполняемый объект

Исполняемый файл запуска по умолчанию.

Строка длиной от 1 до 256 символов, которая должна заканчиваться на ".exe" и не может содержать следующие символы: < , > ,:,%, ", |,? или *. Он задает исполняемый файл по умолчанию для расширения. Если не указано, используется исполняемый файл, определенный для приложения. Если указано, также используется свойство EntryPoint. Если свойство EntryPoint не указано, используется точка входа, определенная для приложения. Нет
RuntimeType

Поставщик среды выполнения. Этот атрибут обычно используется при наличии смешанных платформ в приложении.

Строка длиной от 1 до 255 символов, которая не может начинаться или заканчиваться точкой или содержать следующие символы: < , > ,:,%, ",/, \, |,? или *. Нет
StartPage

Веб-страница, обрабатывающая точку расширения.

Строка длиной от 1 до 256 символов, которая не может содержать следующие символы: < , > ,:,%, ", |,? или *. Нет

 

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

Дочерний элемент Описание
AutoPlayContent

Объявляет точку расширения приложения типа Windows. аутоплайконтент. Приложение предоставляет указанные действия по автозапуску содержимого.

AutoPlayDevice

Объявляет точку расширения приложения типа Windows. аутоплайдевице. Приложение предоставляет указанные действия для автозапуска устройства.

BackgroundTasks

Определяет точку расширяемости приложения типа Windows. баккграундтаскс. Фоновые задачи выполняются на выделенном фоновом узле. то есть без пользовательского интерфейса.

FileOpenPicker

Объявляет точку расширения приложения типа Windows. филеопенпиккер. Приложение позволяет пользователю выбрать и открыть указанные типы файлов.

FileSavePicker

Объявляет точку расширения приложения типа Windows. филесавепиккер. Приложение позволяет пользователю выбрать имя файла, расширение и место хранения для указанных типов файлов.

FileTypeAssociation

Объявляет точку расширения приложения типа Windows. филетипеассоЦиатион. Сопоставление типов файлов указывает, что приложение зарегистрировано для работы с файлами указанных типов.

протокол;

Объявляет точку расширяемости приложения типа Windows. Protocol. Ассоциация URI указывает, что приложение зарегистрировано для управления URI с указанной схемой.

ShareTarget

Объявляет точку расширения приложения типа Windows. шаретаржет. Приложение может совместно использовать указанные типы файлов.

 

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

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

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

 

Следующие элементы имеют то же имя, что и это одно, но различное содержимое или атрибуты:

Remarks

Эти точки расширения могут быть объявлены только один раз для каждого приложения:

  • Windows. Аккаунтпиктурепровидер
  • Windows. Качедфилеупдатер
  • Windows. Камерасеттингс
  • Windows. Контактпиккер
  • Windows. Филеопенпиккер
  • Windows. Филесавепиккер
  • Windows. Принттасксеттингс
  • Windows. Search
  • Windows. Шаретаржет

* * Примечание о семантических правилах для расширений: * * для любого элемента расширения в API манифеста применяются следующие семантические правила.

если указан @StartPage/аппликатион/, это Windows приложение, использующее JavaScript и расширение приложения:

  • Может быть пустым
  • Может указывать только StartPage
  • Можно указать исполняемый файл и точку входа (необязательный RuntimeType), если это не расширение BackgroundTask. в этом случае исполняемый файл можно опустить и использовать по умолчанию для исполняемого файла BackgroundTaskHost.exe.

Если параметр/Аппликатион/@StartPage не указан, это приложение UWP, использующее C#, VB и XAML и расширение приложения:

  • Может быть пустым
  • Может указывать только StartPage
  • Необходимо указать точку входа, если указан исполняемый файл или RuntimeType.

Примеры

Следующий пример взят из манифеста пакета одного из примеров пакета SDK.

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

См. также раздел

Основные понятияконтракты и расширения приложения

Требования

Значение
Пространство имен http://schemas.microsoft.com/appx/2010/manifest